> ## Documentation Index > Fetch the complete documentation index at: https://docs.tilta.ai/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a contact > Fetch the full profile of a single contact record using the external_id assigned at creation, including associated buyer and communication details. Use this endpoint to fetch the current details of a specific contact by their external identifier. The response includes the contact's name, email address, phone number, optional address, and the buyer they are associated with. You can use this endpoint to verify stored contact data before an order is placed, confirm email addresses are current, or troubleshoot missing communications for a specific buyer. ## OpenAPI ````yaml GET /v1/contacts/{external_id} openapi: 3.0.0 info: version: 0.0.1 title: Tilta API description: Tilta API documentation servers: - url: https://api.tilta.io description: Tilta Production API - url: https://api.tilta-sandbox.io description: Tilta Sandbox API security: [] paths: /v1/contacts/{external_id}: get: tags: - Contacts summary: Get a contact description: Retrieves a single contact by its external identifier. parameters: - schema: type: string maxLength: 100 pattern: ^[a-zA-Z0-9-_]+$ description: Unique identifier of a contact. required: true description: Unique identifier of a contact. name: external_id in: path responses: '200': description: '' content: application/json: schema: type: object properties: external_id: type: string maxLength: 100 pattern: ^[a-zA-Z0-9-_]+$ description: Unique identifier of a contact. buyer_external_id: type: string maxLength: 100 pattern: ^[a-zA-Z0-9-_]+$ description: External identifier of the buyer this contact belongs to. salutation: type: string nullable: true enum: - MR - MS - OTHER description: Contact salutation. first_name: type: string nullable: true description: Contact first name. last_name: type: string nullable: true description: Contact last name. email: type: string nullable: true format: email description: Contact email. phone: type: string nullable: true description: Contact phone number in E.164 format (e.g. +491711010101). example: '+491711010101' assign_to_all_invoices: type: boolean description: >- Whether this contact should automatically be assigned to all invoices created for the buyer. address: type: object nullable: true properties: street: type: string description: Address line (e.g. street, road, place). example: Example Street house: type: string description: House number or denominator. example: 42b postcode: type: string description: ZIP or postal code. example: '12345' city: type: string description: City, district, town, or village. example: Berlin country: type: string enum: - AF - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - CV - KH - CM - CA - KY - CF - TD - CL - CN - CX - CC - CO - KM - CD - CG - CK - CR - HR - CU - CW - CY - CZ - CI - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - SZ - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KP - KR - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MK - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RO - RU - RW - RE - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - SS - ES - LK - SD - SR - SJ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TM - TC - TV - TR - UG - UA - AE - GB - UM - US - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW - AX description: Two-letter country code (ISO 3166-1 alpha-2). additional: type: string nullable: true description: >- Additional address information (e.g. PO Box, c/o name etc.). example: c/o Testimonial required: - postcode - city - country description: Contact's address. created_at: type: number description: >- Timestamp indicating when the contact was created (unix time in seconds). example: 1582896122 updated_at: type: number description: >- Timestamp indicating the last time the contact was updated (unix time in seconds). example: 1582896122 required: - external_id - buyer_external_id - assign_to_all_invoices - created_at - updated_at additionalProperties: false description: Contact response payload. '400': description: '' content: application/json: schema: $ref: '#/components/schemas/badRequestSchema' '401': description: '' content: application/json: schema: $ref: '#/components/schemas/unauthorizedRequestSchema' security: - bearerAuth: [] components: schemas: badRequestSchema: type: object properties: code: type: string description: Error code example: BAD_REQUEST error: type: string description: Error message for debugging purposes example: Request validation failed. 1 issue found. issues: type: array items: type: object properties: code: type: string description: Issue code example: INVALID_TYPE path: type: string description: Issue path starting with body, params, querystring, or headers example: body.registered_at message: type: string description: Issue message for debugging purposes example: Invalid type required: - code - path - message description: List of issues example: - code: INVALID_TYPE path: body.registered_at message: Invalid type required: - code - error - issues description: Bad Request, see error message for details. example: code: BAD_REQUEST error: Request validation failed. 1 issue found. issues: - code: INVALID_TYPE path: body.registered_at message: Invalid type unauthorizedRequestSchema: type: object properties: error: type: string description: Error details. example: Unauthorized code: type: string description: Error code. example: UNAUTHORIZED required: - error - code description: Unauthorized Request. example: error: Unauthorized code: UNAUTHORIZED securitySchemes: bearerAuth: type: http scheme: bearer description: Your Tilta API key, sent as `Bearer `. ````