> Source: https://www.pingram.io/docs/api-reference/operations/logs_getdeliverystatus/

# Look up email and SMS delivery status

GET

/logs/status/{trackingIds}

Select code sampleFetchcURL

```js
const url = 'https://api.pingram.io/logs/status/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://api.pingram.io/logs/status/example \
  --header 'Authorization: Bearer <token>'
```

-   Production

Look up email and SMS delivery status for up to 25 tracking IDs. Each entry is the tracking id, channel (EMAIL or SMS), status, and the time that status was recorded. The result does not include recipients, phone numbers, user ids, request bodies, IP addresses, account ids, or user-agent data. Unknown tracking ids are omitted. Other channels are not included.

## Authorizations

-   **[apiKey](/docs/api-reference/#apikey)**
-   **[clientCredentials](/docs/api-reference/#clientcredentials)**
-   **[endUser](/docs/api-reference/#enduser)**
-   **[endUserHashed](/docs/api-reference/#enduserhashed)**

## Parameters

### Path Parameters

**trackingIds**

required

string

Comma-separated tracking IDs (URL encoded, max 25)

## Responses

### 200

Successful response

Media type application/json

Response type for GET /logs/status/{trackingIds}. Unknown tracking ids are omitted. A log that is still ingesting is omitted until it can be read.

object

**statuses**

required

Delivery outcomes for the requested tracking ids.

Array<object>

One delivery outcome. Fields are limited to the tracking id, channel, status, and the time that status was recorded. `channel` is omitted when the outcome is for the whole request, before a channel was chosen.

object

**trackingId**

required

Opaque id returned when the notification was accepted.

string

**channel**

Channel named on a delivery-status row. Email and SMS only. Coarse labels: no address or provider id.

string

Allowed values: EMAIL SMS

**status**

required

Delivery outcome for one request or one channel. These are the same states shown in the dashboard status column.

string

Allowed values: PROCESSING FAILED IGNORED SCHEDULED UNSCHEDULED BATCHED SENT DELIVERED BOUNCED COMPLAINT THROTTLED DEDUPLICATED OPENED CLICKED INBOUND AUTO\_REPLY

**updatedAt**

required

ISO 8601 time this outcome was recorded.

string

##### Example

```json
{
  "statuses": [
    {
      "channel": "EMAIL",
      "status": "PROCESSING"
    }
  ]
}
```

### 400

Bad Request - validation errors, invalid input

Media type application/json

Standard error response for API errors.

object

**trackingId**

required

Unique tracking ID for the request.

string

**error**

required

Structured error details for API error responses.

object

**code**

required

Machine-readable error code.

string

**message**

required

Human-readable error message.

string

**fix**

Actionable hint for fixing the error.

string

##### Examplegenerated

```json
{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}
```

### 401

Unauthorized

### 402

Payment Required - usage limits exceeded

Media type application/json

Standard error response for API errors.

object

**trackingId**

required

Unique tracking ID for the request.

string

**error**

required

Structured error details for API error responses.

object

**code**

required

Machine-readable error code.

string

**message**

required

Human-readable error message.

string

**fix**

Actionable hint for fixing the error.

string

##### Examplegenerated

```json
{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}
```

### 500

Internal Server Error

### 502

Bad Gateway - provider error

Media type application/json

Standard error response for API errors.

object

**trackingId**

required

Unique tracking ID for the request.

string

**error**

required

Structured error details for API error responses.

object

**code**

required

Machine-readable error code.

string

**message**

required

Human-readable error message.

string

**fix**

Actionable hint for fixing the error.

string

##### Examplegenerated

```json
{
  "trackingId": "example",
  "error": {
    "code": "example",
    "message": "example",
    "fix": "example"
  }
}
```

[Previous  
logs\_retryInbound](/docs/api-reference/operations/logs_retryinbound/) [Next  
logs\_tailLogs](/docs/api-reference/operations/logs_taillogs/)
