---
title: "Get a contact"
method: GET
path: "/contacts/{contactId}"
tags: ["Contact API:Contacts"]
---

# Get a contact

`GET /contacts/{contactId}`

## Path parameters

- `contactId` integer, required

## Query parameters

- `Embed` string[]

## Response `200`

Requested contact details

- ContactRepresentation
  - `contactId` integer, required — Unique identifier for the contact
  - `firstName` string, nullable — First name
  - `lastName` string, nullable — Last name
  - `position` string, nullable — Position or job title
  - `salutation` string, nullable — Salutation/honorific/title
  - `unsubscribed` boolean
  - `email` string, nullable — Primary email address
  - `phone` string, nullable — Phone number
  - `mobile` string, nullable — Mobile/cell number
  - `mobileNormalized` string, nullable — Mobile/cell normalized number
  - `inactive` boolean — Contact is no longer with the company
  - `status` StatusModel
    - `statusId` integer, required
    - `name` string, required
    - `active` boolean
    - `default` boolean
  - `company` CompanyNameModel
    - `companyId` integer, required — Unique identifier for the company
    - `name` string, nullable — Company name
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `officeAddress` CompanyAddressModel
    - `addressId` string, uuid, required
    - `name` string, nullable
    - `street` string[], nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postalCode` string, nullable
    - `country` string, nullable
    - `countryCode` string, nullable
    - `phone` string, nullable
    - `fax` string, nullable
    - `url` string, uri, nullable
  - `previousContactId` integer, nullable — contactId from the previous company when a contact moves between companies
  - `originalContactId` integer, nullable — contactId from the original/first company when a contact moves between companies
  - `otherEmail` string[], nullable — Other email addresses used by the contact
  - `social` object, nullable — Contact social profiles
  - `summary` string, nullable
  - `reportsTo` ContactNameModel
    - `contactId` integer, required — Unique identifier for the contact
    - `firstName` string, nullable — First name
    - `lastName` string, nullable — Last name
    - `position` string, nullable — Position or job title
    - `salutation` string, nullable — Salutation/honorific/title
    - `unsubscribed` boolean
    - `email` string, nullable — Primary email address
    - `phone` string, nullable — Phone number
    - `mobile` string, nullable — Mobile/cell number
    - `mobileNormalized` string, nullable — Mobile/cell normalized number
    - `inactive` boolean — Contact is no longer with the company
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `hiringManager` boolean
  - `custom` CustomFieldValueModel[], nullable
    - `fieldId` integer, required
    - `name` string, required
    - `type` 'Text' | 'List' | 'Date' | 'Lookup' | 'Url', string, required — The type of value a custom field expects
    - `value` unknown
  - `owner` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `recruiters` UserNameModel[], nullable
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `partnerActions` PartnerActionStageModel[], nullable
    - `actionId` string, uuid
    - `actionName` string, nullable
    - `reference` string, nullable — Unique partner defined reference/identifier for the action
    - `stage` 'Submitted' | 'InProgress' | 'Completed' | 'Rejected' | 'Cancelled', string
    - `status` string, nullable — Partner defined progress status message for the action
    - `result` PartnerActionResultModel
      - `score` integer, nullable — Optional partner score for the action result
      - `url` string, uri, nullable — Optional partner defined URL for the action result
      - `urlType` 'Popup' | 'Page', string
    - `submittedAt` string, date-time
    - `submittedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `updatedAt` string, date-time
    - `updatedBy` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `createdBy` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `createdAt` string, date-time, nullable
  - `updatedBy` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `updatedAt` string, date-time, nullable
  - `links` ContactLinks
    - `self` string, uri, nullable
    - `candidate` string, uri, nullable — Optional candidate if contact is also a candidate
    - `photo` string, uri, nullable — Photo
    - `company` string, uri, nullable — Company
    - `officeAddress` string, uri, nullable — Office address
    - `skills` string, uri, nullable — Skills
    - `notes` string, uri, nullable — Notes
    - `attachments` string, uri, nullable — Attachments
    - `jobs` string, uri, nullable — Jobs
    - `floats` string, uri, nullable — Floats
    - `submissions` string, uri, nullable — Submissions

## Other responses

- `404` — Requested contact was not found

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/versions/9f43f6a6ee6e/schema)