# Retrieve contact using contact ID

Fetch detailed information about a specific contact in the CRM module of the PMS using their unique contact ID. The response includes key details such as the contact's name, contact information (e.g., email, phone), role, associated organisation, and any linked properties or bookings. This endpoint is essential for accessing and managing individual contact records for guest management, corporate accounts, or operational purposes.

Endpoint: GET /api/v3/contacts/{id}
Version: 3.0.9
Security: OAuth2

## Path parameters:

  - `id` (integer, required)
    Contact ID

## Response 200 fields (application/json):

  - `id` (integer)

  - `firstName` (string, required)

  - `middleNames` (string)

  - `lastName` (string, required)

  - `jobTitle` (string)

  - `department` (string)

  - `preferences` (string)

  - `status` (string)
    Enum: "ACTIVE", "INACTIVE", "BANNED", "ARCHIVED", "VIP", "WAITLIST", "REMOVED"

  - `marketingOptOut` (boolean)
    Marketing opt-out status of the contact

  - `contactSalesAccount` (object)
    Sales account associated with the contact

  - `contactSalesAccount.id` (integer)
    Unique identifier of the finance account

  - `contactSalesAccount.accountCode` (string)
    Account code of the finance account

  - `contactSalesAccount.contact` (object, required)

  - `contactSalesAccount.contact.id` (integer)
    Unique identifier of the contact

  - `contactSalesAccount.contact.firstName` (string)
    First name of the contact

  - `contactSalesAccount.contact.lastName` (string)
    Last name of the contact

  - `contactSalesAccount.company` (object)
    Company summary associated with the finance account

  - `contactSalesAccount.company.id` (integer)
    Unique identifier of the company

  - `contactSalesAccount.company.companyName` (string)
    Name of the company

  - `contactSalesAccount.externalId` (string)
    External identifier of the finance account

  - `contactSalesAccount.exportedDate` (string)
    Date when the finance account was exported

  - `contactSalesAccount.exportStatus` (string)
    Export status of the finance account
    Enum: "SKIPPED", "CREATED", "PENDING", "SENT", "EXPORTED", "FAILED", "IMPORTED"

  - `title` (string)
    Title of the contact
    Enum: "MR", "MISS", "MS", "MRS"

  - `gender` (string)
    Gender of the contact
    Enum: "MALE", "FEMALE", "OTHER"

  - `referrer` (object)

  - `referrer.id` (integer)
    Unique identifier of the referrer

  - `referrer.code` (string)
    Code of the referrer

  - `referrer.name` (string)
    Name of the referrer

  - `industry` (object)

  - `industry.id` (integer)
    Unique identifier of the industry

  - `industry.name` (string)
    Name of the industry

  - `marketSegment` (object)

  - `marketSegment.id` (integer)
    Unique identifier of the market segment

  - `marketSegment.name` (string, required)
    Name of the market segment

  - `nationality` (object)
    Nationality of the contact

  - `nationality.id` (integer)
    ID of the nationality

  - `nationality.name` (string)
    Name of the nationality

  - `nationality.isoCode` (integer)
    ISO code of the nationality

  - `nationality.sortOrder` (integer)
    Sort order of the nationality

  - `nationality.countryCodeAlpha2` (string)
    Country code in Alpha-2 format

  - `primaryContactAddress` (object, required)
    Data Transfer Object representing a contact's address

  - `primaryContactAddress.id` (integer)
    Unique identifier of the address

  - `primaryContactAddress.addressLine1` (string)
    First line of the address

  - `primaryContactAddress.addressLine2` (string)
    Second line of the address

  - `primaryContactAddress.addressLine3` (string)
    Third line of the address

  - `primaryContactAddress.city` (string)
    City of the address

  - `primaryContactAddress.postCode` (string)
    Postal code of the address

  - `primaryContactAddress.country` (object)
    Data Transfer Object representing a Country entity in the Property Management System (PMS).

  - `primaryContactAddress.country.id` (integer)
    Unique identifier of the country

  - `primaryContactAddress.country.name` (string, required)
    Name of the country

  - `primaryContactAddress.country.sortOrder` (integer, required)
    Sort order of the country

  - `primaryContactAddress.country.countryCodeAlpha2` (string, required)
    Alpha-2 country code

  - `primaryContactAddress.country.countryCodeAlpha3` (string, required)
    Alpha-3 country code

  - `primaryContactAddress.country.countryCodeNumeric` (string, required)
    Numeric country code

  - `primaryContactAddress.nickname` (string)
    Nickname of the contact address

  - `primaryContactAddress.primary` (boolean)
    Indicates if this is the primary address

  - `primaryContactEmailAddress` (object, required)
    Primary email address of the contact

  - `primaryContactEmailAddress.id` (integer)
    Unique identifier of the email address
    Example: 1

  - `primaryContactEmailAddress.email` (string, required)
    Email address
    Example: "info@resharmonics.com"

  - `primaryContactEmailAddress.nickname` (string)
    Nickname of the contact

  - `primaryContactEmailAddress.primary` (boolean)
    Indicates if this is the primary email address

  - `primaryContactTelephoneNumber` (object, required)
    Primary telephone number of the contact

  - `primaryContactTelephoneNumber.number` (string, required)

  - `primaryContactTelephoneNumber.primary` (boolean)
    Indicates if this is the primary telephone number

  - `preferredContactMethod` (string)
    Preferred contact method of the contact
    Enum: "TELEPHONE", "EMAIL", "MAIL"

  - `type` (string)
    Type of the contact
    Enum: "BOOKER", "GUEST"

  - `source` (string)
    Source of the contact
    Enum: "OFFLINE_SOURCE", "ONLINE_ENQUIRY_FORM", "ONLINE_BOOKING", "DIRECT_SALE", "SALES_CHANNEL"

  - `idCheck` (boolean)
    ID check status of the contact

  - `companyName` (string)
    Company name associated with the contact

  - `lifecycleStage` (string)
    Lifecycle stage of the contact
    Enum: "LEAD", "QUALIFIED", "DISQUALIFIED", "OPPORTUNITY", "CUSTOMER"

  - `lastBookingRole` (string)
    Last booking role of the contact
    Enum: "NONE", "BOOKER", "GUEST", "GUEST_BOOKER"

  - `uuid` (string)
    UUID of the contact

  - `password` (string)
    Password of the contact

  - `saltoIdentifier` (string)
    Salto identifier of the contact

  - `saltoAssignedTagId` (string)
    Salto assigned tag ID of the contact

  - `cognitoId` (string)
    Cognito ID of the contact

  - `passportNumber` (string)
    Passport number of the contact

  - `saltoRegistrationStatus` (string)
    Salto registration status of the contact
    Enum: "UNKNOWN", "NOT_INVITED", "INVITED", "REGISTERED"

  - `saltoKeysLastUpdated` (string)
    Last updated time of Salto keys

  - `keyCardCode` (string)
    Key card code of the contact

  - `identityConfirmedDate` (string)
    Date when the identity was confirmed

  - `identityConfirmedReference` (string)
    Reference for the identity confirmation

  - `creditCheckOk` (boolean)
    Credit check status of the contact

  - `creditCheckDate` (string)
    Date of the credit check

  - `socialSecurityNumber` (string)
    Social security number of the contact

  - `dateOfBirth` (string)