> ## Documentation Index > Fetch the complete documentation index at: https://docs.turrisfi.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a Contact > Fetch one contact by id Returns one contact with the same shape as a row from [List Contacts](/api-reference/v2/downstream/contacts/list-contacts), scopes filtered to your subtree. Returns **404** when the contact has no scope inside your organization. ## OpenAPI ````yaml openapi/v2.json GET /v2/downstream/contacts/{contactId} openapi: 3.0.0 info: title: Turris Public API description: API for managing insurance compliance data version: 2.0.0 contact: {} servers: - url: https://public.api.live.turrisfi.com description: Production - url: https://public.api.sandbox.turrisfi.com description: Sandbox security: [] tags: [] paths: /v2/downstream/contacts/{contactId}: get: tags: - downstream/contacts summary: Get a contact description: >- Returns a single contact by id. Returns 404 if the contact is not scoped to your organization, which is the same response as an id that does not exist. operationId: ContactsController_getContact_v2 parameters: - name: contactId required: true in: path description: >- The unique identifier of the contact (the contactId returned by the List Contacts endpoint). schema: example: 6627f2b5c2e0a51b8c0d4e7c type: string responses: '200': description: Contact details content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DownstreamContactResponse' requestId: type: string description: Unique request identifier example: dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8 timestamp: type: string description: Response timestamp example: '2025-11-12T20:49:03.293Z' required: - data - requestId - timestamp '400': description: Invalid contact id content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '401': description: Invalid or missing auth token content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '403': description: Your organization is not entitled to the public API content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' '404': description: Contact not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponseDto' components: schemas: DownstreamContactResponse: type: object properties: contactId: type: string description: Unique identifier of the contact example: 6627f2b5c2e0a51b8c0d4e7c firstName: type: string description: Given name example: Jon lastName: type: string description: Surname example: Doe email: type: string description: Email address example: example@test.com isDeliverable: type: boolean description: Whether the email address is deliverable example: true scopes: description: >- The scopes inside your organization. Scopes belonging to other agencies are not returned. type: array items: $ref: '#/components/schemas/DownstreamContactScopeResponse' createdAt: type: string description: ISO 8601 creation timestamp example: '2025-01-15T10:30:00.000Z' updatedAt: type: string description: ISO 8601 last-update timestamp example: '2025-06-02T08:12:44.000Z' required: - contactId - firstName - lastName - email - isDeliverable - scopes ErrorResponseDto: type: object properties: statusCode: type: number description: HTTP status code requestId: type: string description: Unique request identifier for debugging errorType: type: string description: >- Machine-readable error classification. Branch on this rather than on `errorMessage`, which is prose and may change. Authentication failures returned by our identity provider are forwarded verbatim, so a 401 can carry a code outside this list; treat an unrecognised value as a generic failure of its HTTP status. enum: - conflict - contact_not_authorized - document_exceeds_page_limit - downstream_entity_member_exists - duplicate_external_id_error - duplicate_member_email - duplicate_producer_code_error - forbidden - gateway_timeout - inactive_email - internal_server_error - invalid_email - invalid_email_for_invites - invalid_organization_category - invalid_organization_slug - invalid_phone_number - invalid_token - invite_limit_reached - jwt_invalid - m2m_client_not_found - not_found - organization_already_exists - organization_slug_already_used - payment_required - producer_agreement_required - product_feature_subscription_required - service_unavailable - session_authorization_error - some_custom_error_string - throttled - too_many_requests - unauthorized - unauthorized_client - unexpected_400_stytch_error - unexpected_403_stytch_error - unexpected_404_stytch_error - unexpected_error - unexpected_stytch_error - unprocessable_entity - validation_error example: validation_error errorMessage: description: Array of error messages type: array items: type: string timestamp: type: string description: ISO timestamp when the error occurred details: type: object description: Additional error context required: - statusCode - requestId - errorType - errorMessage - timestamp DownstreamContactScopeResponse: type: object properties: downstreamEntityId: type: string description: The entity this scope belongs to example: 6610b3d2c2e0a51b8c0d1f02 upstreamDownstreamAssociationId: type: string description: >- The market relationship this scope is confined to. Absent means the contact is visible to every market that entity deals with, which is how agency-created contacts are stored. example: 6627f1a9c2e0a51b8c0d4e3a businessRoles: type: array description: Business roles this contact holds under this scope example: - Finance Manager items: type: string enum: - Compliance Officer - Principal Owner - Account Manager - Finance Manager - Support Staff - Contract Signatory - Accounts Payable - Policy Maintenance isPrimary: type: boolean description: Whether this contact is a primary contact under this scope example: true required: - downstreamEntityId - businessRoles - isPrimary ```` ## Related topics - [Get Contact](/api-reference/v1/contacts/get-contact.md) - [Changelog](/changelog.md) - [List Contacts](/api-reference/v1/contacts/list-contacts.md)