> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Number Request

> Retrieve one account-owned number request and its current provisioning state.

Returns one number request owned by the API-key account. A request from another tenant returns the same `404 not_found` response as an unknown id.

The response contains request-owned identity, contact, address, routing, and safe acquisition state. It omits `taxId`, Business Profile references, provider request ids, provider document ids, and private attachment paths.

## Path parameters

<ParamField path="request_id" type="string" required>
  Number request id.
</ParamField>

## Response

<ResponseField name="request" type="object">
  Number request object. See [List Number Requests](/api-reference/v2/number-requests/list-all) for the complete field reference.
</ResponseField>

Use [Get International Requirements](/api-reference/v2/number-requests/get-requirements) for the current provider requirement schema, saved form values, request-owned document metadata, and requirement feedback.

## Example

<RequestExample>
  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.tracklysms.com/api/v2/number-requests/665f0a1b2c3d4e5f60718293",
      headers={"X-Api-Key": "trk_your_api_key_here"},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "request": {
      "id": "665f0a1b2c3d4e5f60718293",
      "brandName": "Acme Co",
      "companyLegalName": "Acme Incorporated",
      "listName": "Acme Alerts",
      "phoneNumberType": "toll_free",
      "targetCountries": ["CA"],
      "addressCountry": "GB",
      "identifierType": "vat",
      "status": "approved",
      "provisioningStatus": "in_progress",
      "provisionedPhoneNumber": null,
      "internationalAcquisitionStatus": "PENDING_REVIEW",
      "internationalAcquisitionFeedback": {},
      "internationalAcquisitionFormData": {
        "companyName": "Acme Incorporated"
      },
      "internationalAcquisitionDocuments": [],
      "createdAt": "2026-08-03T22:00:00",
      "updatedAt": "2026-08-03T22:05:00"
    }
  }
  ```

  ```json 404 — Not found theme={null}
  {
    "error": "not_found",
    "message": "Number request not found"
  }
  ```
</ResponseExample>

## Error codes

| HTTP | Code                  | Meaning                                                 |
| ---- | --------------------- | ------------------------------------------------------- |
| 401  | `invalid_credentials` | API key is missing or invalid.                          |
| 404  | `not_found`           | No request with this id exists for the API-key account. |

## Next steps

<CardGroup cols={2}>
  <Card title="Update Number Request" icon="pen" href="/api-reference/v2/number-requests/update-request">
    Correct request-owned identity while editable
  </Card>

  <Card title="Get Requirements" icon="list-check" href="/api-reference/v2/number-requests/get-requirements">
    Read non-US form and document state
  </Card>
</CardGroup>