> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # List email messages > Lists messages sorted newest first by `inserted_at desc, id desc`. No filters other than cursor pagination are implemented. The legacy `/v2/emails` GET route is a backward-compatible alias for this operation. ## OpenAPI ````yaml https://telnyx-openapi-ng.s3.us-east-1.amazonaws.com/email/messages.yml get /email_messages openapi: 3.1.0 info: title: Telnyx Email Messages API version: 2.0.0 description: API for sending and retrieving email messages. contact: email: support@telnyx.com servers: - url: https://api.telnyx.com/v2 security: - bearerAuth: [] paths: /email_messages: get: tags: - Email Messages summary: List email messages description: > Lists messages sorted newest first by `inserted_at desc, id desc`. No filters other than cursor pagination are implemented. The legacy `/v2/emails` GET route is a backward-compatible alias for this operation. operationId: ListEmailMessages parameters: - $ref: '#/components/parameters/email_PageSize' - $ref: '#/components/parameters/PageCursor' responses: '200': description: Paginated list of email messages. content: application/json: schema: $ref: '#/components/schemas/EmailMessageListResponse' '401': $ref: '#/components/responses/email_UnauthorizedResponse' components: parameters: email_PageSize: name: page_size in: query description: >- Number of results to return. Defaults to 25; maximum is 100. Invalid values are clamped to the valid range. required: false schema: type: integer minimum: 1 maximum: 100 default: 25 PageCursor: name: page_cursor in: query description: Opaque URL-safe Base64 cursor returned by a previous list response. required: false schema: type: string example: Y3Vyc29yOmFmdGVyOjQy schemas: EmailMessageListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/EmailMessage' meta: $ref: '#/components/schemas/email_PaginationMeta' required: - data - meta EmailMessage: type: object properties: record_type: type: string enum: - email_message id: type: string format: uuid status: $ref: '#/components/schemas/EmailMessageStatus' from: $ref: '#/components/schemas/EmailAddress' to: type: array items: $ref: '#/components/schemas/EmailAddress' cc: type: array items: $ref: '#/components/schemas/EmailAddress' bcc: type: array items: $ref: '#/components/schemas/EmailAddress' reply_to: type: - string - 'null' subject: type: string template_id: type: - string - 'null' format: uuid template_variables: type: object additionalProperties: true default: {} attachments: type: array items: $ref: '#/components/schemas/AttachmentResponse' events: type: array items: $ref: '#/components/schemas/MessageEvent' inserted_at: type: string format: date-time send_at: type: string format: date-time description: >- Present when a send_at value was stored. Persists even after the scheduled send has been processed or cancelled. inline_css: type: boolean description: >- Present when true in the immediate create response. Not persisted; absent on subsequent GET requests. sandbox: type: boolean description: Present when sandbox mode was used. suppressed: type: array items: type: object properties: to: type: string format: email reason: type: string scope: type: string override_allowed: type: boolean description: >- Present when one or more recipients were suppressed at send time. Each entry lists the suppressed recipient, reason, scope, and whether the block was overridable. required: - record_type - id - status - from - to - cc - bcc - subject - reply_to - template_id - template_variables - attachments - events - inserted_at email_PaginationMeta: type: object properties: page_size: type: integer minimum: 1 maximum: 100 page_cursor: type: string description: Cursor for the next page, when more results are available. required: - page_size email_ErrorResponse: type: object properties: errors: type: array items: $ref: '#/components/schemas/ErrorObject' suppressed: type: array description: >- Present when every recipient is suppressed, so the request is rejected and no message is created. items: $ref: '#/components/schemas/SuppressedRecipient' required: - errors EmailMessageStatus: type: string description: >- Current status of an email message. Lifecycle statuses (queued, scheduled, etc.) are set on creation. Delivery statuses (delivered, bounced, etc.) are updated by delivery event consumers. enum: - queued - scheduled - cancelled - sandbox - sending - sent - failed - deferred - delivered - bounced - complained - rejected - opened - clicked - unsubscribed EmailAddress: type: object properties: email: type: string name: type: string required: - email AttachmentResponse: type: object properties: filename: type: string content_type: type: string required: - filename - content_type MessageEvent: type: object properties: type: $ref: '#/components/schemas/EmailEventType' occurred_at: type: string format: date-time payload: type: object additionalProperties: true required: - type - occurred_at ErrorObject: type: object properties: code: type: string description: >- Telnyx error code. Edge idempotency errors use 10027 or 10036. Fallback 404/500 responses from the framework may use string status codes ('404', '500') instead. enum: - '10001' - '10006' - '10007' - '10015' - '10016' - '10019' - '10027' - '10036' - '404' - '500' - recipient_suppressed - reputation_suspended title: type: string detail: description: >- Human-readable error detail. Changeset responses may return a structured object. oneOf: - type: string - type: object additionalProperties: true source: type: - object - 'null' additionalProperties: true meta: type: - object - 'null' additionalProperties: true description: Additional metadata. Present on 401 errors with a documentation URL. required: - code - title - detail SuppressedRecipient: type: object properties: to: type: string format: email description: Suppressed recipient email address. reason: type: string description: Suppression reason returned by the recipient suppression service. scope: type: string description: Scope at which the suppression applies. override_allowed: type: boolean description: Whether an authorized send may override this suppression. required: - to - reason - scope - override_allowed EmailEventType: type: string enum: - queued - deferred - scheduled - cancelled - sandbox - sending - sent - failed - delivered - bounced - complained - rejected - opened - clicked - unsubscribed responses: email_UnauthorizedResponse: description: Not authorized (10006). content: application/json: schema: $ref: '#/components/schemas/email_ErrorResponse' example: errors: - code: '10006' title: Not authorized detail: Invalid API key meta: url: https://developers.telnyx.com/docs/overview/errors/10006 securitySchemes: bearerAuth: scheme: bearer type: http ````