# user_id on GET /api/v1/phone_number/ is deprecated

Close API deprecated GET /api/v1/phone_number, query parameter user_id without giving a shutdown date yet.

Close API deprecated the query parameter user_id on GET /api/v1/phone_number without a shutdown date. The user_id and is_group_number fields are deprecated both as query filters and in response payloads. Affected requests will fail once the removal takes effect.

## What to use instead

Filter phone numbers by user with the participant_user_id query parameter instead.

- API: Close API (api.close.com)
- Kind: Parameter removal
- Announced: July 21, 2026
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /api/v1/phone_number`, `query parameter user_id`
- Source: [Announcement](https://developer.close.com/api/overview/changelog/2026/7/21)
- Verified: November 6, 2026, against Close API's own pages
- Page: https://www.okapi.bot/providers/close-api/breaking-changes/user-id-on-get-api-v1-phone-number-is-deprecated/

## Close API's words

> The user_id and is_group_number fields on the Phone Number API are deprecated, both as query filters when listing phone numbers and as fields in phone number responses.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent