Identities & resolutions
Two read-only views of who your visitors are:
- Identities are the raw identity resolutions recorded for one customer's conversations.
- Resolutions are the billing ledger of resolution events, across every customer your key can reach.
Resolution uses the delivr.ai identity graph. See Identity resolution for what is resolved and when.
Request examples omit the Authorization: Bearer gtmc_... header for brevity; every request needs it.
When billing was off for a resolution (it was recorded as unbilled), its resolvedPersonId is returned as a 12-character hash starting with # (for example #4be1a07c93d2) and the identity payload is null. resolvedCompany is always returned as recorded.
List identities
GET /api/v1/customers/42/identities?limit=20&include_payload=false HTTP/1.1
Host: app.gtmclarity.ai
{
"data": [
{
"id": 77,
"conversationId": 118,
"resolvedPersonId": "p_5d1c8e2a",
"resolvedCompany": "Acme Corp",
"createdAt": "2026-10-14T15:06:30.000Z"
}
],
"has_more": false
}
| Parameter | Type | Notes |
|---|---|---|
limit | integer | 1 to 100, default 20 |
starting_after | integer | An identity id |
include_payload | true or false | Default false. When true, each item also has payload, the raw enrichment record, which can contain personal data |
| Field | Type | Notes |
|---|---|---|
id | integer | |
conversationId | integer | |
resolvedPersonId | string or null | |
resolvedCompany | string or null | |
createdAt | date-time | |
payload | any | Only present with include_payload=true |
Newest first. Returns 404 until the customer's provisioningStatus is ready. Responses: 200, 400, 401, 403, 404, 429.
The resolution object
{
"id": 3051,
"conversationId": 118,
"customerId": 42,
"resolvedPersonId": "p_5d1c8e2a",
"resolvedCompany": "Acme Corp",
"billedAt": "2026-10-14T15:06:31.000Z",
"billedCents": 10,
"reversedAt": null,
"createdAt": "2026-10-14T15:06:30.000Z"
}
| Field | Type | Notes |
|---|---|---|
id | integer | Ledger event id |
conversationId | integer | |
customerId | integer | |
resolvedPersonId | string or null | |
resolvedCompany | string or null | |
billedAt | date-time or null | null when not billed |
billedCents | integer or null | |
reversedAt | date-time or null | Set when the charge was reversed |
createdAt | date-time |
List resolutions
GET /api/v1/resolutions?customer_id=42&billed=true&created_after=2026-10-01T00:00:00Z HTTP/1.1
Host: app.gtmclarity.ai
| Parameter | Type | Notes |
|---|---|---|
limit | integer | 1 to 100, default 20 |
starting_after | integer | A resolution id |
customer_id | integer | Only this customer |
created_after | date-time | Only events created after this time |
billed | true or false | Whether billedAt is set |
Returns { "data": [resolution, ...], "has_more": false }, newest first. A customer-scoped key only ever sees its own customer; asking it for another customer_id returns an empty list. Responses: 200, 400, 401, 403, 429.
Retrieve a resolution
GET /api/v1/resolutions/3051 HTTP/1.1
Host: app.gtmclarity.ai
Returns the resolution object. Responses: 200, 401, 403, 404, 429.