---
title: "Changes to Search for a person by name, phone number, and address"
method: GET
path: "/v1/person/"
---

# Changes to Search for a person by name, phone number, and address

`GET /v1/person/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 9 revisions.

- **2026-09-12** `a50bd0fbbeb5`: 6 breaking, 138 info
- **2026-09-01** `c27a0cd8718f`: 3 breaking, 2 warning, 93 info
- **2025-10-07** `26418ba225d0`: 3 info

## Changes

- **2026-09-12** `a50bd0fbbeb5`: 6 breaking, 138 info
  - the response property `error/meta` became nullable for the status `422`
  - the response property `error/meta` became nullable for the status `500`
  - the response property `error/code` became optional for the status `422`
  - the response property `error/code` became optional for the status `500`
  - the response property `error/message` became optional for the status `422`
  - the response property `error/message` became optional for the status `500`
  - removed `#/components/schemas/JSONObject, subschema #2` from the `error/meta` response property `anyOf` list for the response status `422`
  - removed `#/components/schemas/JSONObject, subschema #2` from the `error/meta` response property `anyOf` list for the response status `500`
  - the `code` response's property default value `422` was added for the status `422`
  - the `code` response's property default value `500` was added for the status `500`
  - the `message` response's property default value `Internal Server Error` was added for the status `500`
  - the `message` response's property default value `Unprocessable Entity` was added for the status `422`
  - removed the `100.00` enum value from the `error/code` response property for the response status `422`
  - removed the `100.00` enum value from the `error/code` response property for the response status `500`
  - removed the `101.00` enum value from the `error/code` response property for the response status `422`
  - removed the `101.00` enum value from the `error/code` response property for the response status `500`
  - removed the `102.00` enum value from the `error/code` response property for the response status `422`
  - removed the `102.00` enum value from the `error/code` response property for the response status `500`
  - removed the `103.00` enum value from the `error/code` response property for the response status `422`
  - removed the `103.00` enum value from the `error/code` response property for the response status `500`
  - removed the `200.00` enum value from the `error/code` response property for the response status `422`
  - removed the `200.00` enum value from the `error/code` response property for the response status `500`
  - removed the `201.00` enum value from the `error/code` response property for the response status `422`
  - removed the `201.00` enum value from the `error/code` response property for the response status `500`
  - removed the `202.00` enum value from the `error/code` response property for the response status `422`
  - removed the `202.00` enum value from the `error/code` response property for the response status `500`
  - removed the `203.00` enum value from the `error/code` response property for the response status `422`
  - removed the `203.00` enum value from the `error/code` response property for the response status `500`
  - removed the `204.00` enum value from the `error/code` response property for the response status `422`
  - removed the `204.00` enum value from the `error/code` response property for the response status `500`
  - removed the `205.00` enum value from the `error/code` response property for the response status `422`
  - removed the `205.00` enum value from the `error/code` response property for the response status `500`
  - removed the `206.00` enum value from the `error/code` response property for the response status `422`
  - removed the `206.00` enum value from the `error/code` response property for the response status `500`
  - removed the `207.00` enum value from the `error/code` response property for the response status `422`
  - removed the `207.00` enum value from the `error/code` response property for the response status `500`
  - removed the `208.00` enum value from the `error/code` response property for the response status `422`
  - removed the `208.00` enum value from the `error/code` response property for the response status `500`
  - removed the `226.00` enum value from the `error/code` response property for the response status `422`
  - removed the `226.00` enum value from the `error/code` response property for the response status `500`
  - …104 more
- **2026-09-01** `c27a0cd8718f`: 3 breaking, 2 warning, 93 info
  - the response property `error/meta` became nullable for the status `400`
  - the response property `error/code` became optional for the status `400`
  - the response property `error/message` became optional for the status `400`
  - deleted the `header` request parameter `X-Api-Key`
  - added the new `tollfree` enum value to the `items/phones/items/type` response property for the response status `200`
  - api operation id `get_person_v1_person__get` removed and replaced with `search_person_by_name_phone_or_address`
  - endpoint deprecated
  - added the new optional `query` request parameter `first_name`
  - added the new optional `query` request parameter `include_historical_locations`
  - added the new optional `query` request parameter `last_name`
  - added the new optional `query` request parameter `max_age`
  - added the new optional `query` request parameter `middle_name`
  - added the new optional `query` request parameter `min_age`
  - added the new optional `query` request parameter `radius`
  - added the new optional `query` request parameter `strict_match`
  - for the `query` request parameter `state_code`, the type was generalized from no type to `string`
  - added the non-success response with the status `403`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
  - added the optional property `error` to the response with the `429` status
  - added the optional property `error_instance_id` to the response with the `429` status
  - added the optional property `items/current_addresses/items/latlong` to the response with the `200` status
  - added the optional property `items/current_addresses/items/score` to the response with the `200` status
  - added the optional property `items/historic_addresses/items/latlong` to the response with the `200` status
  - added the optional property `items/historic_addresses/items/score` to the response with the `200` status
  - added the optional property `limit` to the response with the `429` status
  - added the optional property `reset_at` to the response with the `429` status
  - added the optional property `upgrade_url` to the response with the `429` status
  - added the optional property `used` to the response with the `429` status
  - removed `#/components/schemas/JSONObject, subschema #2` from the `error/meta` response property `anyOf` list for the response status `400`
  - the `code` response's property default value `400` was added for the status `400`
  - the `message` response's property default value `Bad Request` was added for the status `400`
  - removed the `100.00` enum value from the `error/code` response property for the response status `400`
  - removed the `101.00` enum value from the `error/code` response property for the response status `400`
  - removed the `102.00` enum value from the `error/code` response property for the response status `400`
  - removed the `103.00` enum value from the `error/code` response property for the response status `400`
  - removed the `200.00` enum value from the `error/code` response property for the response status `400`
  - removed the `201.00` enum value from the `error/code` response property for the response status `400`
  - removed the `202.00` enum value from the `error/code` response property for the response status `400`
  - removed the `203.00` enum value from the `error/code` response property for the response status `400`
  - …58 more
- **2025-10-07** `26418ba225d0`: 3 info
  - added the non-success response with the status `429`
  - added the required property `items/aliases` to the response with the `200` status
  - added the required property `items/historic_addresses` to the response with the `200` status

---

[Operation](https://skmtc.dev/whitepages/apis/whitepages-api-reference/docs/v1/person/get.md) - [API](https://skmtc.dev/whitepages/apis/whitepages-api-reference.md) - [Page](https://skmtc.dev/whitepages/apis/whitepages-api-reference/changes/v1/person/get)
