> ## Documentation Index > Fetch the complete documentation index at: https://nuntly.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Email > Returns an email with its current delivery status and metadata. ## OpenAPI ````yaml /openapi.documented.yml get /emails/{id} openapi: 3.1.0 info: title: Nuntly REST API 1.x version: 1.0.1 description: Nuntly REST API definition termsOfService: https://nuntly.com/legal/terms-of-service contact: name: Nuntly Support url: https://nuntly.com/docs email: support@nuntly.com servers: - description: Nuntly API endpoint url: https://api.nuntly.com security: - bearerAuth: [] tags: - name: API Keys description: >- Create and revoke API keys used to authenticate requests to the Nuntly API. - name: Agents description: >- Read and write persistent state for an AI agent, optionally scoped to a specific inbox or thread. - name: Domains description: >- Add and verify sending and receiving domains. Manage DKIM records, SPF configuration, and enable inbound email routing. - name: Emails description: >- Send transactional emails, retrieve sending history, and track delivery status per message. - name: Inboxes description: >- Create email inboxes at a specific address on a verified receiving domain. Assign inboxes to namespaces or AI agents. - name: Messages description: >- Access received messages, download attachments, and send replies or forwards from an inbox. - name: Namespaces description: >- Isolate inboxes by tenant, client, or agent using namespaces. Use an external ID to map namespaces to your own data model. - name: Organizations description: >- Manage your organization profile, team members, and account-level settings. - name: Threads description: >- Browse email conversations grouped by subject. Mark threads as read or spam, and assign them to an agent. - name: Webhooks description: >- Register HTTP endpoints to receive real-time delivery events such as bounces, opens, and clicks. - name: Webhooks Events description: >- Inspect webhook event history and replay failed deliveries for debugging or recovery. - name: Webhooks Hook description: >- Endpoint your server implements to receive webhook events. Not a Nuntly API endpoint - this documents the shape your handler must accept. externalDocs: description: Nuntly API Documentation url: https://nuntly.com/docs paths: /emails/{id}: get: tags: - Emails summary: Retrieve Email description: Returns an email with its current delivery status and metadata. operationId: retrieve-email parameters: - name: id in: path required: true description: The id of the email schema: type: string responses: '200': description: Successful response. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/EmailResponse' required: - data additionalProperties: false '500': description: An error response content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' x-codeSamples: - lang: cURL source: >- curl -X GET 'https://api.nuntly.com/emails/em_01ka8k8s80gvx9604cn9am5st4' \ -H 'Authorization: Bearer apk_xxx' - lang: JavaScript source: >- import { Nuntly } from '@nuntly/sdk'; const client = new Nuntly({ apiKey: process.env['NUNTLY_API_KEY'], }); const response = await client.emails.retrieve('em_01ka8k8s80gvx9604cn9am5st4'); - lang: Java source: >- import com.nuntly.sdk.Nuntly; import com.nuntly.sdk.ClientOptions; var nuntly = Nuntly.create(ClientOptions.builder() .apiKey(System.getenv("NUNTLY_API_KEY")) .build()); var response = nuntly.emails().retrieve("em_01ka8k8s80gvx9604cn9am5st4"); components: schemas: EmailResponse: type: object required: - id - orgId - from - to - status - subject - createdAt properties: id: description: The id of the email type: string examples: - em_01ka8k8s80gvx9604cn9am5st4 orgId: description: The id of the organization type: string examples: - org_01ka8k8s80gvx9604cn9am5st4 messageId: description: The id from email provider type: string examples: - msg_01ka8k8s80gvx9604cn9am5st4 bulkId: description: The bulk id type: string from: description: The e-mail address of the sender type: string examples: - Tomlinson AI to: description: The primary recipient(s) of the email anyOf: - type: array items: type: string - type: string examples: - brian67@gmail.com - - carlo43@gmail.com - pink42@yahoo.com cc: description: The carbon copy recipient(s) of the email anyOf: - type: array items: type: string - type: string examples: - carlo43@gmail.com bcc: description: The blind carbon copy recipient(s) of the email anyOf: - type: array items: type: string - type: string examples: - archive@company.com status: $ref: '#/components/schemas/EmailStatus' description: The status of the email. statusReason: description: May provide more informations about the status type: object additionalProperties: true subject: description: The subject of the e-mail type: string examples: - Verify your email address replyTo: description: >- The email address where replies should be sent. If a recipient replies, the response will go to this address instead of the sender's email address anyOf: - type: array items: type: string - type: string examples: - support@company.com headers: description: The headers to add to the email type: object additionalProperties: true tags: description: The tags to add to the email type: array items: $ref: '#/components/schemas/Tag' attachments: description: The attachements type: array items: type: object properties: filename: type: string contentType: type: string size: type: number variables: description: The variables for the template type: object additionalProperties: true scheduledAt: description: The date at which the email is scheduled to be sent type: string examples: - '2026-03-30T09:00:00.000Z' createdAt: description: Date at which the object was created (ISO 8601 format) type: string examples: - '2026-03-29T12:00:00.000Z' ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/Error' description: >- This object provide you additional information about errors encountered while performing the operation EmailStatus: type: string enum: - queued - scheduled - processed - failed - sending - sent - delivered - bounced - complained - canceled - rejected Tag: type: object required: - name - value properties: name: description: The name of the tag type: string examples: - category value: description: The tag to add to the email type: string examples: - transactional Error: type: object required: - status - code - title properties: status: description: >- The HTTP status code generated by the origin server for this occurrence of the error. type: number code: description: An API specific code representing the type of error. type: string title: description: A short, human-readable summary of the error type. type: string details: description: >- A (best effort) human readable explanation specific to this occurrence of the error. type: object additionalProperties: true securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key (format apk_...) description: >- Use an API key from https://nuntly.com/api-keys. Required on every endpoint. ````