Skip to content

Get customer

Request

Returns one stored customer, exactly as it was accepted.

Security
OAuth2(Required scopes: enrichment.read)
Path
externalIdstringrequired

Previously sent externalId

curl -i -X GET \
  'https://api.cloud.hypatos.ai/v2/enrichment/customers/{externalId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The stored customer

Bodyapplication/json
metadataobject(recordMetadata)required
dataobject(customer)required

The stored resource, exactly as it was accepted.

Response
{ "metadata": { "createdAt": "2026-10-01T09:12:44.123456Z", "updatedAt": "2026-10-03T15:02:10.654321Z" }, "data": { "externalId": "0000100000", "externalClientId": "EXTERNAL_CLIENT_ID", "code": "CODE1", "type": "SOLD_TO", "name": "Acmne Corp.", "nameAlternative1": "Acmne Corp.", "nameAlternative2": "Acmne Corp.", "nameAlternative3": "Acmne Corp.", "nameAlternative4": "Acmne Corp.", "street": "Hauptstr. 1", "addressAdditional": "Eingang B", "postcode": "10001", "city": "Berlin", "countryCode": "DE", "vatIds": [ … ], "taxIds": [ … ], "blockedForPosting": false, "blockedForPayment": false, "blockedForOrdering": false, "blockedForDelivery": false, "globalLocationNumber": "4000001000002", "duns": "123456789", "customerSubsidiaries": [ … ], "customerBankAccounts": [ … ], "customFields": { … }, "customMetadata": { … }, "salesOrganizationInfo": [ … ] } }