Get logs by tracking IDs (comma-separated, max 25 IDs)

GET

/logs/{trackingIds}

• Production

Authorizations

• apiKey
• clientCredentials
• endUser
• endUserHashed

Parameters

Path Parameters

trackingIds

required

string

Comma-separated tracking IDs (URL encoded)

Responses

200

Successful response

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 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 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

400

Bad Request - validation errors, invalid input

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

provider

Provider that caused the error (e.g. telnyx, ses).

string

providerCode

Provider-specific error code.

string

401

Unauthorized

402

Payment Required - usage limits exceeded

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

provider

Provider that caused the error (e.g. telnyx, ses).

string

providerCode

Provider-specific error code.

string

500

Internal Server Error

502

Bad Gateway - provider error

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

provider

Provider that caused the error (e.g. telnyx, ses).

string

providerCode

Provider-specific error code.

string