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

# /people/find

`POST /people/find`

Attempts to find a person using the given match candidate. See [Common Models](https://docs.ngpvan.com/reference/people#common-models) for a full list of fields.

## Request body

- object
  - `vanId` string — Providing a valid VANID will override other search criteria
  - `firstName` string
  - `middleName` string
  - `lastName` string
  - `dateOfBirth` string, date
  - `Phones` object[] — Contact records may have more than one associated phone number
    - `phoneNumber` string — Number without numeric country code, integer input also accepted (without special characters)
    - `dialingPrefix` string — Optional; numeric country code
    - `countyCode` string — Optional; Alpha-2 country code
  - `emails` object[] — Contact records may have more than one associated email
    - `email` 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

---

[API](https://skmtc.net/ngpvan/apis/van-crm.md) · [All operations](https://skmtc.net/ngpvan/apis/van-crm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ngpvan/van-crm/revisions/f9adfdbb3c56/schema)