---
title: "Get a number registration"
method: GET
path: "/v1/number-registrations/{id}"
tags: ["Number Registration"]
---

# Get a number registration

`GET /v1/number-registrations/{id}`

## Request

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

One registration with its latest submission state and per-engine acknowledgments (hiya, tns, first_orion). A registration is `submitted` once the registry accepts it and `active` after the first engine acknowledges — propagation to carrier spam labeling typically completes within 24–48 hours.

## Path parameters

- `id` string, required

## 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
    - `submission` object, nullable, required
      - `submission_id` string, required
      - `status` string, required
      - `submitted_at` string, nullable, required
      - `vendor_acks` object, required
        - `hiya` string, nullable, required
        - `tns` string, nullable, required
        - `first_orion` string, nullable, required
      - `last_error` string, nullable, 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)