> ## 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 a Number Acquisition

> Read the durable status of a Voice number purchase.

Reads a Voice number acquisition in the authenticated account. Requires `voice_calls.read`, the **Voice Calls** product entitlement, and an API key created by a current account owner. Other setup operations and operations from other accounts return `404`.

Read this endpoint after [acquiring a number](https://docs.tracklysms.com/api-reference/voice/numbers/acquire-calling-number.md), particularly when the initial response was lost or its `status` was `outcome_unknown`. `complete` confirms the purchase result. A pending or unknown status does not confirm ownership; use the operation ID to continue reading.

## Path Parameters

**operationId** `string` *required*

Acquisition operation ID from the `202` response or its `Location` header.

## Response Fields

**id** `string`

The acquisition operation ID.

**action** `string`

Always `number_acquisition`.

**status** `string`

The current durable status.

**errorCode** `string | null`

A failure code, when present.

**result** `object`

The retained result. It can contain a number ID before the operation is complete; rely on `status` to confirm acquisition.

**createdAt** `string`

Operation creation time.

**submittedAt** `string | null`

Provider submission time, when present.

**completedAt** `string | null`

Completion time, when present.

## Example

```bash cURL theme={null}
curl https://api.tracklysms.com/api/v1/voice/number-acquisitions/665f1e2a9c4b1a0012ab34cd \
  -H "X-Api-Key: trk_your_api_key_here"
```

## Error Codes

| Status | Code | Meaning |
| - | - | - |
| 403 | `owner_required` | The key's creator is not a current account owner. |
| 404 | `resource_not_found` | This account has no acquisition with that ID. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.