---
title: "List number registrations"
method: GET
path: "/v1/number-registrations"
tags: ["Number Registration"]
---

# List number registrations

`GET /v1/number-registrations`

## Request

- Base URL: `https://api.revdesk.com`
- URL: `https://api.revdesk.com/v1/number-registrations`
- Auth: HTTP bearer

RevDesk-managed Free Caller Registry status for hosted numbers in your workspace, oldest first and cursor-paged. Filter by status or an exact phone_number.

## Query parameters

- `limit` integer, required
- `cursor` string
- `status` 'pending' | 'submitted' | 'active' | 'failed' | 'cancelled'
- `phone_number` string

## Response `200`

Success

- object
  - `data` object[], required
    - `registration_id` string, required
    - `phone_number` string, required
    - `status` string, required
    - `source` string, required
    - `hosted` boolean, required
    - `registered_at` string, nullable, required
    - `cancelled_at` string, nullable, required
    - `created_at` string, required
  - `meta` object, required
    - `cursor` string
    - `page_size` number, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict (incl. idempotency conflicts)
- `429`: Rate limited

---

[API](https://skmtc.dev/revdesk/apis/revdesk-v1-api.md) · [All operations](https://skmtc.dev/revdesk/apis/revdesk-v1-api/llms.txt) · [OpenAPI document](https://skmtc.dev/revdesk/apis/revdesk-v1-api/revisions/fcbd43530a48?raw)