---
title: "POST /v2/agent/number-requests/{request_id}/preview"
method: POST
path: "/v2/agent/number-requests/{request_id}/preview"
tags: ["agent-number-requests-v2"]
---

# POST /v2/agent/number-requests/{request_id}/preview

`POST /v2/agent/number-requests/{request_id}/preview`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/agent/number-requests/{request_id}/preview`
- Auth: API key in header `Authorization`

## Headers

- `Idempotency-Key` string, required

## Request body

- AgentNumberRequestPreview
  - `revision` integer, required

## Response `202`

Private preview intent recorded; poll this request

- AgentNumberRequestResponse
  - `request` object: Bound request id/accountId/revision/status, fields, preview, domain, registration and nextActions

## Other responses

- `400`: Invalid request
- `401`: Invalid credentials
- `403`: Registration scope required
- `404`: Bound request not found
- `409`: State changed or operation outcome unknown
- `413`: Request too large
- `422`: Incomplete or unsupported registration
- `429`: Preview budget exhausted
- `503`: Dependency unavailable

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)