Skip to main content
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"
}