Sign in
Email Inboxes

List and search messages in an inbox

Lists inbound messages newest first. All access is scoped to the authenticated account. filter[search] performs PostgreSQL full-text search over the subject, plain-text body, and HTML body. Filters compose with stable cursor pagination.

get/email_inboxes/{inbox_id}/messages

Path parameters

inbox_idstring uuid required

Email inbox UUID.

Query parameters

filter[from]string

Case-insensitive literal substring of the sender address.

filter[subject]string

Case-insensitive literal substring of the subject.

filter[received_after]string date-time

Inclusive ISO 8601 lower bound for the received timestamp.

filter[received_before]string date-time

Inclusive ISO 8601 upper bound for the received timestamp.

filter[read]boolean

Whether the message has a read timestamp.

filter[unread]boolean

Whether the message has no read timestamp. Set to true to return only unread messages.

filter[label]string

Returns only messages carrying this label. Matching is exact and case-sensitive. Reserved telnyx: labels can be filtered on even though they cannot be written by customers.

filter[search]string

Full-text query over subject and body, up to 500 characters.

page[size]integer

Number of results to return. Defaults to 25; maximum is 100.

page[after]string

Opaque cursor returned by the previous page.

Response

Paginated inbox messages.

Changes

Changed in 3 of the 99 revisions of this API.2784

  • 9621f6123ebc8See the full diff
    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new 10011 enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new domain_graduation_limit_exceeded enum value to the // response property for the response status

      response-property-enum-value-added

  • b1bf96d8391e273See the full diff
    • ▲

      the / response's property type changed from object to no type for status

      response-property-type-changed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ▲

      removed the required property // from the response with the status

      response-required-property-removed

    • ○

      added the new optional query request parameter filter[label]

      new-optional-request-parameter

    • ○

      added the new optional query request parameter filter[unread]

      new-optional-request-parameter

    • ○

      added subschema #2 to the / response property allOf list for the response status

      response-property-all-of-added

  • 2fb3b617430a1See the full diff
    • ○

      endpoint added

      endpoint-added

Of the 99 revisions, 1 has no diff computed.