Sign in
Email

List Received Emails

Changed on

Lists emails received by any email() handler during this dev session. Use capture_id with worker for canonical exact-capture details, or email_id for compatibility Message-ID lookup. The two identifiers are mutually exclusive.

get/local/email/routing

Request

  • Base URL: /cdn-cgi/local/explorer/api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /cdn-cgi/local/explorer/api/local/email/routing
  • Auth: none declared

Query parameters

workerstring

Only return emails received by this worker's email() handler.

email_idstring

Compatibility lookup by RFC Message-ID. Returns the newest match and accepts bracketed or bracket-stripped values.

capture_idstring uuid

Canonical identifier for one captured delivery. Requires worker and never falls back to Message-ID lookup.

cursorstring

Opaque cursor for the next page of emails.

per_pageinteger

Number of emails per page.

Response

List received emails response.

successtrue required

Whether the API call was successful.

Example response

{
  "errors": [],
  "messages": [],
  "success": true
}

Changes

  • fbbd7a1b0965Revision changes
    • ○

      added the new optional query request parameter capture_id

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property //// to the response with the status

    • ○

      added the optional property //// to the response with the status

    • ○

      added the optional property //// to the response with the status

    • ○

      added the optional property //// to the response with the status

    • ○

      the response property ////// became required for the status

    • ○

      added the required property ////// to the response with the status

    • ○

      added the required property ////// to the response with the status

    • ○

      added the required property ////// to the response with the status

  • 983be463fdf2Revision changes
    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property ////// to the response with the status

    • ○

      added the optional property //// to the response with the status