---
title: "/people/findByPhone"
method: POST
path: "/people/findByPhone"
---

# /people/findByPhone

`POST /people/findByPhone`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/people/findByPhone`
- Auth: HTTP basic

Use this endpoint to get the record of an individual if there is exactly one match to the given phone number.


If no matching phone number is found, an HTTP `404 Not Found` response is returned. This same response is also returned if more than one matching phone number is found. A successful response is only generated when the phone number is found on exactly one contact record.

Successful requests will return an HTTP `200` response with a JSON body containing information on the [matching record](ref:people#match-candidates).

## Request body

- object
  - `phoneNumber` string: A valid phone number as an integer or string

## Response `200`

200

- object
  - `vanId` integer
  - `firstName` string
  - `lastName` string
  - `middleName` string
  - `party` string
  - `employer` string
  - `occupation` string
  - `sex` string
  - `dateOfBirth` string

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/people/findByPhone/post.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)