Get Contract Contact Person by External ID

Retrieves a contact person using its external system identifier within a specific contract.

Endpoint

GET /contracts/{contractId}/contact-persons/external-id/{externalId}

Authentication

Required: Authorization header with valid token

Path Parameters

ParameterTypeRequiredDescription
contractIduuidYesContract unique identifier
externalIdstringYesExternal system identifier

Response

ContactPerson Entity

Error

Error Schema

Example Usage

curl -X GET "https://integration-api.ram.syniotec.com/master-data/v1/contract-management/contracts/123e4567-e89b-12d3-a456-426614174000/contact-persons/external-id/EXT_CONTACT_001" \
  -H "Authorization: Bearer YOUR_TOKEN"

Notes

  • External IDs are used to integrate with external systems or databases
  • The external ID must match exactly what was used when creating the contact person
  • This endpoint is useful for system integration scenarios