---
title: "Get Phone Numbers"
method: GET
path: "/phone_numbers"
tags: ["Phone Number Management"]
deprecated: true
---

# Get Phone Numbers

`GET /phone_numbers`

> **Deprecated.**

Returns the configured outbound phone numbers. Includes the client's inbound phone number only when this capability is enabled for the client.

Outbound phone numbers are allowed to call consumer phone numbers to reach customers, whereas the inbound phone number receives calls from consumers.

Note: This endpoint is only required for legacy masked phone number leads before 16th April 2026

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

The phone numbers were returned successfully

- PhoneNumbersGetResponse
  - `phone_numbers` object, required
    - `outbound` string[], required — Phone numbers that can call a masked phone number on behalf of a business
    - `inbound` string — Phone number to which calls from consumers will be routed. Returned only when this capability is enabled for the client.
  - `limit` integer, required — The limit parameter that was used
  - `offset` integer, required — The offset parameter that was used
  - `total` integer, required — Total number of outbound phone numbers

## Other responses

- `401` — The API key has either expired or doesn't have the required scopes to query this endpoint. | code | description | | ------------- | ------------- | | UNAUTHORIZED_API_KEY | The API key provided is not currently able to query this endpoint. | | TOKEN_INVALID | Invalid API key or authorization header. |
- `403` — Authorization Error
- `404` — Resource Not Found
- `429` — You have either exceeded your daily quota, or have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries.
- `500` — Internal Server Error

---

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