---
title: "Get Blocked/Allowed Number"
method: GET
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers/{blockedNumberId}"
tags: ["Call Blocking"]
---

# Get Blocked/Allowed Number

`GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-blocking/phone-numbers/{blockedNumberId}`

Returns blocked or allowed phone number(s) by their ID(s). 
[Batch request syntax](https://developers.ringcentral.com/api-reference/Batch-Requests) is supported.

## Path parameters

- `accountId` string, required
- `extensionId` string, required
- `blockedNumberId` string, required

## Response `200`

OK

- BlockedAllowedPhoneNumberInfo — Information on a blocked/allowed phone number
  - `uri` string, uri — Link to a blocked/allowed phone number
  - `id` string — Internal identifier of a blocked/allowed phone number
  - `phoneNumber` string — A blocked/allowed phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format
  - `label` string — Custom name of a blocked/allowed phone number
  - `status` 'Blocked' | 'Allowed' — Status of a phone number

## Other responses

- `404` — General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503` — General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

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