Identities

Identities represent email addresses or domains that you have connected to Kurrier. Each identity can optionally belong to a provider (SES, SMTP, Mailgun, etc.) and is used when sending or receiving email. These endpoints let you list identities from your backend using your Kurrier API key. All routes below are relative to:

https://www.kurrier.io/api/kurrier

What is an Identity?

An identity is either:

an email identity (email@example.com)
a domain identity (example.com)

Identities also store DNS verification records, provider configuration, status, and metadata.

List identities

`GET /identities`

Returns all identities owned by the authenticated user.

Get a single identity

`GET /identities/{id}`

Fetch an identity by its ID.

Identity object format

Example response object:

{
    "id":"1a9b317a-8a84-493a-b9f8-83a3800861e2",
    "owner_id":"be7a7201-76db-4b73-a5e0-ad6a1b93cf1f",
    "kind":"email",
    "public_id":"9ANdDSgvj5",
    "value":"me@myapp.com",
    "incoming_domain":false,
    "domain_identity_id":"b4950019-500a-44a6-9b24-08b2517f1b3d",
    "dns_records":"null",
    "meta":"{}",
    "provider_id":"c4248dd5-46f2-48f5-9d5b-91b7e7d67c74",
    "smtp_account_id":null,
    "status":"unverified",
    "created_at":"2025-11-15 10:47:23.60418+00",
    "updated_at":"2025-11-15 10:47:23.60418+00"
}

Getting started

Provider Integrations

API Access

What is an Identity?

List identities

`GET /identities`

Get a single identity

`GET /identities/{id}`

Identity object format

​What is an Identity?

​List identities

​GET /identities

​Get a single identity

​GET /identities/{id}

​Identity object format

What is an Identity?

List identities

`GET /identities`

Get a single identity

`GET /identities/{id}`

Identity object format