Get StartedVeriFactuStripeAPI Reference
Emails

Get a sent email with its body

Retrieves a single sent email including its message body (HTML / plain text), fetched live from the email provider (Resend).

The body is only available for emails that have a provider message id and while the provider still retains the message; otherwise body_available is false and the body fields are null.

Subject to the same (account, environment) isolation and customer-facing allow-list as GET /v1/emails.

Try this endpoint with Claude
Copy the prompt for any assistant, or open it directly in Claude Code (needs it installed).
GET
/v1/emails/{id}

Authorization

AuthorizationBearer <token>

API Key authentication.

Format: Authorization: Bearer beel_sk_<key>

Scopes: API Keys use the same scopes as OAuth2 tokens. Each key is created with specific scopes that limit which endpoints it can access. The required scope for each endpoint is documented in the operation's security section under OAuth2.

Obtaining Keys: API Keys are managed from the BeeL dashboard

Security: API Keys are secret credentials. Do not share them or store them in source code

In: header

Path Parameters

idstring

Email delivery id

Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://app.beel.es/api/v1/emails/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "success": true,
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "email_type": "INVOICE_EMITTED",
    "recipients": [
      "string"
    ],
    "cc": [
      "string"
    ],
    "subject": "string",
    "related_entity_type": "INVOICE",
    "related_entity_id": "e94907ff-519b-4a75-b3bc-05aaf47d6339",
    "status": "SENT",
    "sent_at": "2019-08-24T14:15:22Z",
    "body_available": true,
    "html_body": "string",
    "text_body": "string",
    "attachments": [
      {
        "filename": "factura-A-2026-0001.pdf",
        "content_type": "application/pdf",
        "size": 0,
        "download_url": "string"
      }
    ],
    "related_invoices": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "invoice_number": "A-2025-0002"
      }
    ]
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
  }
}

Update webhook subscription PATCH

Partially updates a webhook subscription. Only provided fields are updated. Use this endpoint to: - **Change the endpoint URL** (`url`) - **Change subscribed events** (`events`) - **Enable or disable** the subscription (`active`)

Email indicators for related entities GET

Returns, for each of the given related entity ids, a summary of the emails the system has sent that are associated with it: how many, the most recent status and when. Lets a UI light up an "email sent" badge next to each invoice without loading the full email history. Ids with no associated emails are simply omitted from the response. The same `(account, environment)` isolation and customer-facing allow-list as `GET /v1/emails` apply.