---
title: "Find contacts"
method: GET
path: "/contacts"
tags: ["Contact API:Contacts"]
---

# Find contacts

`GET /contacts`

## Query parameters

- `ContactId` integer[]
- `Name` string
- `Email` string
- `Phone` string
- `CompanyId` integer[]
- `HiringManager` boolean
- `StatusId` integer[]
- `PartnerAction.ActionId` string[]
- `PartnerAction.Reference` string[]
- `PartnerAction.Stage` PartnerActionStage[]
- `PartnerAction.SubmittedAt` string[]
- `FolderId` integer[]
- `CreatedBy` integer[]
- `CreatedAt` string[]
- `UpdatedBy` integer[]
- `UpdatedAt` string[]
- `Fields` string[]
- `Embed` string[]
- `Offset` integer
- `Limit` integer

## Response `200`

List of contacts matching the specified criteria

- ContactListRepresentation
  - `items` ContactSummaryModel[], nullable
    - `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
    - `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
    - `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
  - `totalCount` integer, required
  - `links` PageLinks
    - `first` string, uri, nullable
    - `prev` string, uri, nullable
    - `next` string, uri, nullable
    - `last` string, uri, nullable

---

[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/revisions/9f43f6a6ee6e/schema)