Get a purchase

GET /v1/domain-purchases/:id

Returns one purchase by its Domainee id. Workspace-scoped — you only ever see purchases tied to the API key's workspace.

Request

curl https://api.domainee.dev/v1/domain-purchases/f8a0c1b9-1234-… \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Response — 200 OK

Same row shape as the create endpoint and the list endpoint:

{
  "purchase": {
    "id": "f8a0c1b9-1234-…",
    "hostname": "janesbakery.com",
    "years": 1,
    "wholesaleCents": 1418,
    "feeCents": 100,
    "totalCents": 1518,
    "currency": "USD",
    "registrar": "namecheap",
    "registrarDomainId": "182739",
    "status": "completed",
    "registrant": {
      "firstName": "Jane",
      "lastName": "Smith",
      "email": "jane@bakery.example",
      "country": "US"
    },
    "whoisPrivacyEnabled": true,
    "autoRenew": false,
    "expiresAt": "2027-05-17T15:42:11.000Z",
    "customerReference": "user_jane_42",
    "createdAt": "2026-05-17T15:42:09.000Z",
    "updatedAt": "2026-05-17T15:42:11.000Z"
  }
}

Errors

Code	Status	When
not_found	404	No purchase with that id in this workspace.