List recent notification logs for the authenticated account, newest first.

GET

/logs

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

• Production

Authorizations

• apiKey
• clientCredentials
• endUser
• endUserHashed

Parameters

Query Parameters

limit

number

Maximum number of logs to return (default

cursor

string

Pagination cursor for next page

Responses

200

Successful response

Media typeapplication/json

object

messages

required

Array<object>

object

trackingId

required

string

eventType

required

string

timestamp

required

string

epochMs

required

number

inbox

Address that received the mail. Same value as matched.email on the EMAIL_INBOUND webhook, including when that address was only in Cc or Bcc.

string

from

string

fromName

string

subject

string

to

Original To header addresses. Not the address that received the mail.

Array<string>

cc

Original Cc header addresses.

Array<string>

bcc

Bcc header addresses still on the delivered message. Usually omitted, because the Bcc header is removed before delivery.

Array<string>

replyTo

string

bodyText

string

bodyHtml

string

attachments

Array<object>

object

filename

required

Original filename from the message.

string

contentType

required

MIME type of the file.

string

size

required

Size in bytes. This response does not include the file bytes.

number

contentId

Content-ID with angle brackets removed, so it matches cid: references in bodyHtml. Omitted when the part has no Content-ID.

string

contentDisposition

inline when the HTML body references this file; attachment when it is a separate file. Omitted when the message does not say which.

string

Allowed values: inline attachment

media

Inbound MMS attachments (includes contentType when available).

Array<object>

object

url

required

string

contentType

string

messageId

string

inReplyTo

string

references

string

resolutionType

string

Allowed values: reply builtin custom inbound

nextCursor

string

Example

{
  "messages": [
    {
      "attachments": [
        {
          "contentDisposition": "inline"
        }
      ],
      "resolutionType": "reply"
    }
  ]
}

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