Skip to main content
GET
List Files Received

Authorizations

x-api-key
string
header
required

Your API key for authentication. Use sandbox-with-json-responses as Sandbox key.

Path Parameters

inbound_email_id
string
required

Inbound Email ID (e.g., ie_a1b2c3d4e5f6)

Query Parameters

since
string<date-time>

ISO 8601 timestamp. Only files with received_at strictly greater than this value are returned. Use the cursor value from the previous response.

limit
integer
default:20

Maximum files to return.

Required range: 1 <= x <= 50

Response

Files received at this inbound email since the cursor

status
string
Example:

"success"

files
object[]

Files received (sorted oldest-first)

count
integer
Example:

1

cursor
string<date-time> | null

Pass as since on the next poll. null if no files and no prior cursor.

Example:

"2025-02-21T10:45:12.000123+00:00"