---
title: "Search by phone number."
method: GET
path: "/search/phonenumber"
tags: ["Search API:Search"]
---

# Search by phone number.

`GET /search/phonenumber`

Find candidates, contacts, companies or users by phone number.

## Query parameters

- `E164` string

## Response `200`

Candidates, contacts, companies or users matching the specified number

- MatchedByPhoneNumberModel
  - `candidates` CandidateMatchedByPhoneModel[], nullable — Top 5 most recently updated matching candidates
    - `match` MatchedPhoneNumberModel
      - `type` 'Phone' | 'Mobile', string
      - `number` string, nullable
      - `normalized` string, nullable
    - `candidateId` integer
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `updatedAt` string, date-time, nullable
    - `lastNoteAt` string, date-time, nullable
  - `contacts` ContactMatchedByPhoneModel[], nullable — Top 5 most recently updated matching contacts
    - `match` MatchedPhoneNumberModel
      - `type` 'Phone' | 'Mobile', string
      - `number` string, nullable
      - `normalized` string, nullable
    - `contactId` integer
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `company` MatchedPhoneNumberModelCompanyName
      - `companyId` integer
      - `name` string, nullable
    - `position` string, nullable
    - `updatedAt` string, date-time, nullable
    - `lastNoteAt` string, date-time, nullable
  - `companies` CompanyMatchedByPhoneModel[], nullable — Top 5 most recently updated matching companies
    - `match` MatchedPhoneNumberModel
      - `type` 'Phone' | 'Mobile', string
      - `number` string, nullable
      - `normalized` string, nullable
    - `companyId` integer
    - `name` string, nullable
    - `updatedAt` string, date-time, nullable
    - `lastNoteAt` string, date-time, nullable
  - `users` UserMatchedByPhoneModel[], nullable — Top 5 most recently updated matching users
    - `match` MatchedPhoneNumberModel
      - `type` 'Phone' | 'Mobile', string
      - `number` string, nullable
      - `normalized` string, nullable
    - `userId` integer
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `position` string, nullable
    - `inactive` boolean
    - `updatedAt` string, date-time, nullable
  - `quality` 'Exact' | 'National' | 'Subscriber', string

---

[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)