---
title: "List orders"
method: GET
path: "/api/v1/customer/orders"
tags: ["Customer API"]
---

# List orders

`GET /api/v1/customer/orders`

## Request

- Base URL: `https://virtualsms.io`
- URL: `https://virtualsms.io/api/v1/customer/orders`
- Auth: API key in header `X-API-Key`

Returns your order history. Optionally filter by status.

## Query parameters

- `status` 'waiting' | 'cancelled' | 'completed' | 'expired'

## Response `200`

List of orders

- object
  - `success` boolean
  - `orders` object[]
  - `count` integer

## Other responses

- `401`: Invalid or missing API key

---

[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)