Get Contact Person By External Id

Retrieves a specific contact person by their external system identifier.

Endpoint

GET /clients/{clientId}/contact-persons/external-id/{externalId}

Authentication

Required: Authorization header with valid token

Path Parameters

ParameterTypeRequiredDescription
clientIdUUIDYesUnique identifier of the client
externalIdstringYesExternal system identifier of the contact person

Response

Success (200)

Returns the contact person object.

Schema: Contact Persons Model

Error (404)

Schema: Error Response DTO

Example Usage

curl -X GET "https://integration-api.ram.syniotec.com/master-data/v1/client-management/clients/75f18aa7-b0aa-4d2c-b104-b513bec82a5f/contactPersons/externalId/EXT-12345" \
  -H "Authorization: Bearer YOUR_TOKEN"