---
title: "Get one order"
method: GET
path: "/api/v1/orders/{id}"
tags: ["Orders"]
---

# Get one order

`GET /api/v1/orders/{id}`

## Request

- Base URL: `https://virtualsms.io`
- URL: `https://virtualsms.io/api/v1/orders/{id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

Poll this to watch for the code. Also served as `GET /api/v1/order/{id}`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Order returned

- object
  - `success` boolean
  - `order` Order: An order as returned by the read endpoints. Optional fields are present only once they have a value, so absent is not the same as null.
    - `id` string, uuid
    - `phone_number` string
    - `service` string
    - `service_name` string: Display name. Returned by the list endpoint and by `GET /api/v1/orders/{id}`.
    - `country` string
    - `status` 'created' | 'waiting' | 'sms_received' | 'completed' | 'cancelled' | 'expired': `created` / `waiting` — live, no code yet. `sms_received` — a code arrived. `completed` — you called `/complete`. `cancelled` — you called `/cancel`. `expired` — the window elapsed; the auto-refund runs separately and is reported by `refunded_at`, the status stays `expired`.
    - `price` number, float
    - `sms_count` integer
    - `created_at` string
    - `expires_at` string
    - `selected_tier` string
    - `can_swap_number` boolean: Whether `POST /api/v1/orders/{id}/retry` will replace this order's number in place instead of resending to the same one.
    - `sms` string: Full SMS text. Present once a message has arrived.
    - `code` string: Verification code extracted from the SMS, when one was detected.
    - `sms_sender` string
    - `completed_at` string
    - `refunded_at` string: Set when the money actually went back, read from the balance ledger rather than inferred from `status`. List endpoint only.

## Other responses

- `404`: Order not found, or not yours

---

[API](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and.md) · [All operations](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/llms.txt) · [OpenAPI document](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/revisions/be89af981be1?raw)