v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Retrieve an email

Retrieves a single email by its ID. Email fields are redacted based on the caller-specific privacy resolution, and the response includes a read-only accessLevel.

Required scope: emails:read

Rate limit category: Read

get/v1/emails/{id}

Path parameters

idstring required

Unique identifier of the email to retrieve.

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Response

idstring required

Unique identifier for the entity.

createdAtstring required

ISO 8601 timestamp of when the entity was created.

updatedAtstring nullable required

ISO 8601 timestamp of when the entity was last updated, or null.

httpLinkstring nullable required

URL to view the entity in the Lightfield web app, or null.

externalIdstring nullable

External identifier for the entity, or null if unset.

fieldsobject required

Map of field names to their typed values. System fields are prefixed with $ (e.g. $name, $email); custom attributes use their bare slug.

relationshipsobject required

Map of relationship names to their associated entities. System relationships are prefixed with $ (e.g. $owner, $contact).

objectType'email' required

Always email.

accessLevel'FULL' | 'METADATA' required

The caller's resolved access level for this email.

Example response

{
  "id": "eml_cm0abc456def789",
  "createdAt": "2026-05-01T09:00:00.000Z",
  "updatedAt": "2026-05-01T10:00:00.000Z",
  "httpLink": null,
  "fields": {
    "$subject": {
      "valueType": "TEXT",
      "value": "Following up on our chat"
    },
    "$sentAt": {
      "valueType": "DATETIME",
      "value": "2026-05-01T08:30:00.000Z"
    },
    "$from": {
      "valueType": "EMAIL",
      "value": [
        "sales@acme.com"
      ]
    },
    "$to": {
      "valueType": "EMAIL",
      "value": [
        "lead@example.com"
      ]
    },
    "$cc": {
      "valueType": "EMAIL",
      "value": []
    },
    "$bcc": {
      "valueType": "EMAIL",
      "value": []
    },
    "$privacySetting": {
      "valueType": "TEXT",
      "value": null
    },
    "$body": {
      "valueType": "HTML",
      "value": "<p>Hi there,</p><p>Following up on our chat earlier this week.</p>"
    }
  },
  "relationships": {
    "$account": {
      "cardinality": "has_many",
      "objectType": "account",
      "values": [
        "acc_cm4stu901uvw234"
      ]
    },
    "$contact": {
      "cardinality": "has_many",
      "objectType": "contact",
      "values": [
        "con_cm2ghi789jkl012"
      ]
    }
  },
  "objectType": "email",
  "accessLevel": "FULL"
}