Emails

Get email details

Changed on Feb 8, 2026

Retrieve detailed information about a specific email including delivery status, timestamps, and optionally the email content.

Use the expand parameter to include additional data like the HTML/text body, headers, or delivery attempts.

get/emails/{emailId}

Request

Base URL
https://api.arkhq.io/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/arkhq-io/apis/ark-email-api/docs/emails/:emailId/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

emailIdstring required

The email identifier (token returned from send response)

Query parameters

expandstring

Example:full

Comma-separated list of fields to include:

full - Include all expanded fields in a single request
content - HTML and plain text body
headers - Email headers
deliveries - Delivery attempt history
activity - Opens and clicks tracking data
attachments - File attachments with content (base64 encoded)
raw - Complete raw MIME message (base64 encoded)

Response

Email details

successtrue required

Example response

{
  "data": {
    "id": "aBc123XyZ456",
    "deliveries": [
      {
        "id": "456",
        "status": "sent",
        "details": "Message for user@example.com accepted by 1.2.3.4:25 (mx.example.com)",
        "output": "250 2.0.0 OK 1234567890 abc123 - gsmtp",
        "code": 250,
        "classification": "mailbox_full",
        "classificationCode": 20,
        "smtpEnhancedCode": "5.2.2",
        "remoteHost": "mx.example.com"
      }
    ],
    "activity": {
      "opens": [
        {
          "ipAddress": "203.0.113.42",
          "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
        }
      ],
      "clicks": [
        {
          "url": "https://example.com/product",
          "ipAddress": "203.0.113.42",
          "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
        }
      ]
    },
    "attachments": [
      {
        "filename": "invoice.pdf",
        "contentType": "application/pdf",
        "size": 45678,
        "hash": "a1b2c3d4e5f6...",
        "data": "JVBERi0xLjQKJeLjz9MKMyAwIG9i..."
      }
    ],
    "rawMessage": "TWltZS1WZXJzaW9uOiAxLjAKQ29udGVudC1UeXBlOiB0ZXh0L3BsYWluOyBjaGFyc2V0PXV0Zi04..."
  },
  "meta": {
    "requestId": "req_V1StGXR8_Z5jdHi6"
  }
}

Changes

Feb 8, 202637bce0c9a4d7 Revision changes
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- warning
  added the new infrastructure_error enum value to the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
- info
  removed the postal_error enum value from the / response property for the response status
Feb 8, 20264f8eeb0b9933 Revision changes
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new already_exists enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new attachment_too_large enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new authentication_required enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_error enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new billing_not_configured enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_not_found enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_on_hold enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new credential_revoked enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new delivery_not_found enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_already_exists enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_found enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new domain_not_verified enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new email_not_found enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new external_id_already_exists enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new forbidden enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new idempotency_conflict enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new insufficient_balance enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new internal_error enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_api_key enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_email_address enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_raw_message enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new invalid_request enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new ip_not_allowed enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new message_too_large enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_key_invalid enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_too_large enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new metadata_value_invalid enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_field enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new missing_scope enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new not_found enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payload_too_large enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new payment_required enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new postal_error enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new rate_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new send_limit_exceeded enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new server_suspended enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new service_unavailable enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppressed_recipient enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new suppression_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new tenant_not_found enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_attachments enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new too_many_recipients enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unauthenticated_from_address enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new unprocessable_entity enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new validation_error enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status
- warning
  added the new webhook_not_found enum value to the / response property for the response status

Operation history (7 revisions)