Get logs by tracking IDs (comma-separated, max 25 IDs). Use after sending email or SMS to look up delivery status.

GET

/logs/{trackingIds}

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

• Production

Authorizations

• apiKey
• clientCredentials
• endUser
• endUserHashed

Parameters

Path Parameters

trackingIds

required

string

Comma-separated tracking IDs (URL encoded)

Responses

200

Successful response

Media typeapplication/json

Response type for GET /logs/{trackingIds} and POST /logs/bulk

object

logs

required

Array<object>

object

received_at

string

type

string

envId

string

clientId

string

agent

string

ip

string

request

string

test

boolean

trackingId

required

string

accountId

required

string

failed_at

string

failed_code

string

Allowed values: SPAM_CONTENT INVALID_SCHEDULE_FORMAT SCHEDULE_RESOURCE_NOT_FOUND MISSING_NOTIFICATION_TYPE UNKNOWN

failed_internal

string

inapp_sent_at

string

inapp_sent_after

number

inapp_delivered_at

string

inapp_delivered_after

number

inapp_failed_at

string

inapp_failed_code

string

Allowed values: IN_APP_WEB_FAILED UNKNOWN

inapp_failed_internal

string

mobile_push_failed_at

string

mobile_push_failed_code

string

Allowed values: NO_APN_CONFIG NO_FCM_CONFIG INVALID_APN_TOKEN INVALID_FCM_TOKEN UNKNOWN

mobile_push_failed_token

string

mobile_push_failed_internal

string

mobile_push_sent_at

string

mobile_push_sent_after

number

mobile_push_sent_token

string

mobile_push_delivered_at

string

mobile_push_delivered_after

number

email_sent_at

string

email_sent_message_id

string

email_sent_after

number

email_preview

Bare POST /email may set this on the email_sent row so Logs Insights latest(email_preview) still resolves after delivered/opened rows. Sender / SQS consumer paths omit this field (unchanged behavior).

string

email_delivered_at

string

email_delivered_recipients

string

email_delivered_after

number

email_delivered_webhook_res

string

email_failed_at

string

email_failed_code

Any of:

string

string

Allowed values: UNVERIFIED_SENDER PERMANENT_GENERAL_BOUNCE PERMANENT_NO_EMAIL_BOUNCE PERMANENT_SUPPRESSED_BOUNCE TRANSIENT_GENERAL_BOUNCE TRANSIENT_MAILBOX_FULL_BOUNCE TRANSIENT_MESSAGE_TOO_LARGE_BOUNCE TRANSIENT_CONTENT_REJECTED_BOUNCE TRANSIENT_ATTACHMENT_REJECTED_BOUNCE UNDETERMINED_BOUNCE COMPLAINT_ABUSE COMPLAINT_AUTH COMPLAINT_FRAUD COMPLAINT_NOT_SPAM COMPLAINT_OTHER COMPLAINT_VIRUS SUPPRESSED_COMPLAINT SUPPRESSED_BOUNCE MISSING_EMAIL_RECIPIENT MISSING_EMAIL_SUBJECT MISSING_EMAIL_HTML

string

string

Allowed values: NO_ADDRESS USAGE_LIMIT VERIFICATION_LIMIT TEMPLATE_NOT_FOUND NO_DEFAULT_TEMPLATE SPAM_CONTENT

email_failed_recipient

string

email_failed_diagnostic_code

string

email_failed_internal

string

email_failed_webhook_res

string

email_opened_at

string

email_opened_user_agent

string

email_opened_ip

string

email_opened_webhook_res

string

email_clicked_at

string

email_clicked_user_agent

string

email_clicked_ip

string

email_clicked_link

string

email_clicked_link_tags

string

email_clicked_webhook_res

string

email_inbound_at

string

email_inbound_from

string

email_inbound_from_name

string

email_inbound_to

string

email_inbound_cc

string

email_inbound_bcc

string

email_inbound_reply_to

string

email_inbound_inbox

string

email_inbound_subject

string

email_inbound_body_text

string

email_inbound_body_html

string

email_inbound_has_attachments

boolean

email_inbound_attachment_count

number

email_inbound_message_id

string

email_inbound_in_reply_to

string

email_inbound_references

string

email_inbound_webhook_delivered

boolean

email_inbound_webhook_res

string

email_inbound_resolution_type

string

Allowed values: reply builtin custom

sms_inbound_at

string

sms_inbound_from

string

sms_inbound_to

Pingram number that received the inbound message.

string

sms_inbound_text

string

sms_inbound_webhook_delivered

boolean

sms_inbound_webhook_res

string

sms_inbound_media

Truncated JSON string of inbound MMS metadata when present.

string

sms_replied_at

string

sms_replied_to

string

sms_replied_text

string

sms_replied_segments

number

sms_replied_encoding

string

sms_unsubscribe_at

string

sms_unsubscribe_from

string

sms_unsubscribe_keyword

string

sms_unsubscribe_webhook_delivered

boolean

sms_unsubscribe_webhook_res

string

sms_subscribe_at

string

sms_subscribe_from

string

sms_subscribe_keyword

string

sms_subscribe_webhook_delivered

boolean

sms_subscribe_webhook_res

string

web_push_sent_token

string

web_push_sent_at

string

web_push_sent_after

number

web_push_delivered_at

string

web_push_delivered_after

number

web_push_delivered_token

string

web_push_delivered_internal

string

web_push_failed_at

string

web_push_failed_token

string

web_push_failed_code

Any of:

string

string

Allowed values: UNSUBSCIRBED_OR_EXPIRED UNKNOWN

string

string

Allowed values: NO_ADDRESS USAGE_LIMIT VERIFICATION_LIMIT TEMPLATE_NOT_FOUND NO_DEFAULT_TEMPLATE SPAM_CONTENT

web_push_failed_internal

string

processed_at

string

ignored

string

Allowed values: THROTTLING DEDUPLICATION DISABLED_NOTIFICATION ALL_CHANNELS_IGNORED

scheduled_for

string

user_id

string

user_email

string

user_number

string

email_routing

string

Allowed values: OFF SEND BATCH IGNORE SCHEDULE THROTTLED DEDUPLICATED

email_routing_reason

string

Allowed values: IGNORE_BY_PREFERENCES IGNORE_BY_ENVIRONMENT IGNORE_BY_DEFAULT_DELIVERY

sms_routing

string

Allowed values: OFF SEND BATCH IGNORE SCHEDULE THROTTLED DEDUPLICATED

sms_routing_reason

string

Allowed values: IGNORE_BY_PREFERENCES IGNORE_BY_ENVIRONMENT IGNORE_BY_DEFAULT_DELIVERY

web_push_routing

string

Allowed values: OFF SEND BATCH IGNORE SCHEDULE THROTTLED DEDUPLICATED

web_push_routing_reason

string

Allowed values: IGNORE_BY_PREFERENCES IGNORE_BY_ENVIRONMENT IGNORE_BY_DEFAULT_DELIVERY

mobile_push_routing

string

Allowed values: OFF SEND BATCH IGNORE SCHEDULE THROTTLED DEDUPLICATED

mobile_push_routing_reason

string

Allowed values: IGNORE_BY_PREFERENCES IGNORE_BY_ENVIRONMENT IGNORE_BY_DEFAULT_DELIVERY

call_routing

string

Allowed values: OFF SEND BATCH IGNORE SCHEDULE THROTTLED DEDUPLICATED

call_routing_reason

string

Allowed values: IGNORE_BY_PREFERENCES IGNORE_BY_ENVIRONMENT IGNORE_BY_DEFAULT_DELIVERY

inapp_routing

string

Allowed values: OFF SEND BATCH IGNORE SCHEDULE THROTTLED DEDUPLICATED

inapp_routing_reason

string

Allowed values: IGNORE_BY_PREFERENCES IGNORE_BY_ENVIRONMENT IGNORE_BY_DEFAULT_DELIVERY

slack_routing

string

Allowed values: OFF SEND BATCH IGNORE SCHEDULE THROTTLED DEDUPLICATED

slack_routing_reason

string

Allowed values: IGNORE_BY_PREFERENCES IGNORE_BY_ENVIRONMENT IGNORE_BY_DEFAULT_DELIVERY

sms_preview

string

call_preview

string

web_push_preview

string

mobile_push_preview

string

slack_preview

string

inapp_preview

string

slack_sent_at

string

slack_sent_after

number

slack_delivered_at

string

slack_delivered_after

number

slack_delivered_internal

string

slack_failed_at

string

slack_failed_code

Any of:

string

string

Allowed values: CHANNEL_NOT_FOUND NOT_IN_CHANNEL CHANNEL_ARCHIVED MESSAGE_TOO_LONG NO_TEXT RESTRICTED_ACTION TOKEN_EXPIRED INVALID_AUTH UNKNOWN

string

string

Allowed values: NO_ADDRESS USAGE_LIMIT VERIFICATION_LIMIT TEMPLATE_NOT_FOUND NO_DEFAULT_TEMPLATE SPAM_CONTENT

slack_failed_internal

string

call_sent_at

string

call_sent_after

number

call_sent_from

string

call_delivered_at

string

call_delivered_after

number

call_delivered_code

string

Allowed values: COMPLETED BUSY NO_ANSWER UNKNOWN

call_delivered_cost_internal

number

call_delivered_cost

Same value as call_delivered_cost_internal (for API/external use)

number

call_failed_at

string

call_failed_code

Any of:

string

string

Allowed values: 13224 21211 21215 21265 21610 21614 21612 30005 30006 30007 30008 30453 40001 40002 40010 40300 Unknown MISSING_SMS_RECIPIENT MISSING_SMS_MESSAGE INVALID_PHONE_NUMBER

string

string

Allowed values: NO_ADDRESS USAGE_LIMIT VERIFICATION_LIMIT TEMPLATE_NOT_FOUND NO_DEFAULT_TEMPLATE SPAM_CONTENT

call_failed_internal

string

sms_failed_at

string

sms_failed_code

Any of:

string

string

Allowed values: 13224 21211 21215 21265 21610 21614 21612 30005 30006 30007 30008 30453 40001 40002 40010 40300 Unknown MISSING_SMS_RECIPIENT MISSING_SMS_MESSAGE INVALID_PHONE_NUMBER

string

string

Allowed values: NO_ADDRESS USAGE_LIMIT VERIFICATION_LIMIT TEMPLATE_NOT_FOUND NO_DEFAULT_TEMPLATE SPAM_CONTENT

sms_failed_internal

string

sms_sent_at

string

sms_sent_after

number

sms_sent_from

string

sms_sent_carrier

string

sms_sent_line_type

string

sms_sent_encoding

string

sms_sent_segments

number

sms_sent_parts

number

sms_sent_cost

number

sms_sent_country

string

sms_sent_messageId

Unique message ID from the SMS provider

string

sms_sent_mms

True when the send included MMS (mediaUrls).

boolean

sms_carrier_cost_internal

Actual carrier cost (internal)

number

sms_carrier_fee_internal

number

sms_rate_internal

number

sms_delivered_at

string

sms_delivered_after

number

sms_delivered_cost_internal

Actual delivery cost from carrier webhook (USD), for internal logging

number

schedule_updated_at

string

schedule_updated_to

string

schedule_deleted_at

string

Example

{
  "logs": [
    {
      "failed_code": "SPAM_CONTENT",
      "inapp_failed_code": "IN_APP_WEB_FAILED",
      "mobile_push_failed_code": "NO_APN_CONFIG",
      "email_failed_code": "UNVERIFIED_SENDER",
      "email_inbound_resolution_type": "reply",
      "web_push_failed_code": "UNSUBSCIRBED_OR_EXPIRED",
      "ignored": "THROTTLING",
      "email_routing": "OFF",
      "email_routing_reason": "IGNORE_BY_PREFERENCES",
      "sms_routing": "OFF",
      "sms_routing_reason": "IGNORE_BY_PREFERENCES",
      "web_push_routing": "OFF",
      "web_push_routing_reason": "IGNORE_BY_PREFERENCES",
      "mobile_push_routing": "OFF",
      "mobile_push_routing_reason": "IGNORE_BY_PREFERENCES",
      "call_routing": "OFF",
      "call_routing_reason": "IGNORE_BY_PREFERENCES",
      "inapp_routing": "OFF",
      "inapp_routing_reason": "IGNORE_BY_PREFERENCES",
      "slack_routing": "OFF",
      "slack_routing_reason": "IGNORE_BY_PREFERENCES",
      "slack_failed_code": "CHANNEL_NOT_FOUND",
      "call_delivered_code": "COMPLETED",
      "call_failed_code": "13224",
      "sms_failed_code": "13224"
    }
  ]
}

400

Bad Request - validation errors, invalid input

Media typeapplication/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

Example^generated

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

401

Unauthorized

402

Payment Required - usage limits exceeded

Media typeapplication/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

Example^generated

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

500

Internal Server Error

502

Bad Gateway - provider error

Media typeapplication/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

Example^generated

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