Get Domain Address

Retrieve a single sender address from a sending domain. The address must belong to the parent domain in the path and to the workspace resolved from the bearer token.

GET
/v1/domains/:domain/addresses/:address

Retrieve a sender address by UUID

Path parameters

domainstring Required

Domain UUID

addressstring Required

Domain address UUID

Get Domain Address
curl "https://api.leadpush.io/v1/domains/:domain/addresses/:address" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer {token}"
Response Example
{
"data": {
  "uuid": "<address_uuid>",
  "domain_uuid": "<domain_uuid>",
  "address": "sender",
  "full_address": "sender@example.test",
  "provider": "leadpush",
  "display_name": "Sender Name",
  "verification": "completed",
  "updated_at": "2021-01-01T00:00:00.000Z",
  "created_at": "2021-01-01T00:00:00.000Z"
}
}

Visibility

Workspace and parent-domain scoping behavior

  • The address must belong to the parent domain in the path.
  • Requests for addresses outside the parent domain return 404.
  • Requests for addresses outside the API key's workspace return 404.