Skip to content

Get company

Request

Returns one stored company, 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/companies/{externalId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The stored company

Bodyapplication/json
metadataobject(recordMetadata)required
dataobject(company)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": "DE01", "externalClientId": "EXTERNAL_CLIENT_ID", "code": "CODE1", "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", "state": "Berlin", "countryCode": "DE", "vatIds": [ … ], "taxIds": [ … ], "globalLocationNumber": "4000001000002", "duns": "123456789", "customFields": { … }, "customMetadata": { … } } }