---
title: "List the caller's verifications"
method: GET
path: "/verifications"
tags: ["Verifications"]
---

# List the caller's verifications

`GET /verifications`

## Request

- Base URL: `https://dashboard.voidmob.com/api/v1`
- URL: `https://dashboard.voidmob.com/api/v1/verifications`
- Auth: HTTP bearer

Returns a cursor-paginated list of short-term verifications owned by
the authenticated caller, newest-first. Up to 100 items per page
(default 20). Use `next_cursor` from the response to fetch the next
page. Long-term rentals are not included - use `GET /v1/rentals`.

## Query parameters

- `status` 'waiting_for_code' | 'code_received' | 'cancelled' | 'expired'
- `limit` integer
- `cursor` string

## Response `200`

Paginated list of verifications.

- VerificationListResponse
  - `success` true, required
  - `data` Verification[], required: Page of verification resources, newest-first.
    - `id` string, required: Opaque verification (SMS rental) identifier.
    - `display_id` string, nullable: Human-readable order identifier for display in dashboards and receipts (e.g. `SMS7K4P2N`). Null for legacy rentals created before this field was introduced.
    - `status` 'waiting_for_code' | 'code_received' | 'cancelled' | 'expired' | 'failed', required: `waiting_for_code` - number is live (up to 15 minutes, see `expires_at`), no SMS yet. `code_received` - at least one SMS arrived. `cancelled` - the price was refunded, either because you cancelled or because the window closed with no SMS (automatic refund). `expired` - the window closed with no SMS and no automatic refund (services marked non-refundable, or rare cases where the refund could not be applied automatically). `failed` is reserved and not emitted.
    - `phone_number` string, required: E.164 phone number (with leading +).
    - `service_id` string: Opaque public service identifier.
    - `service_name` string, required
    - `charged_price_cents` integer, required: Actual amount deducted from the wallet for this verification.
    - `pricing_source` 'regular' | 'category' | 'override' | 'promo': Attribution for the charged price. Omitted for legacy rentals. "promo" means a redeemed service-discount code priced this purchase.
    - `expires_at` string, date-time, required
    - `can_cancel` boolean, required: Whether the rental is currently cancellable. Becomes false once a code arrives or the cancel window closes.
    - `created_at` string, date-time, required
    - `code` string: The received SMS code. Present only when `status = code_received`.
    - `code_received_at` string, date-time: When the code arrived. Present only when `status = code_received`.
    - `reuse_counter` integer, required: Number of user-initiated reuses (free or paid) on this number. Starts at 0. Automatic reuses are not counted.
    - `allow_reuse` boolean, required: Free reuse is currently available.
    - `allow_paid_reuse` boolean, required: Paid reuse is currently available. STR rentals only.
    - `paid_reuse_price_cents` integer, required: Fixed price for one paid reuse.
    - `charged_reuse_cents` integer: Set on the response of a successful POST /reuse/paid. Not present otherwise.
    - `refunded_cents` integer: Set on the response of a successful POST /cancel. Not present otherwise.
  - `has_more` boolean, required: Whether additional pages exist beyond this one.
  - `next_cursor` string, nullable, required: Pass as `cursor` in the next request to advance the page. Null on the last page.
  - `request_id` string, required: Server-assigned identifier for a single request.

## Other responses

- `400`: 400 - Request failed validation.
- `401`: 401 - Authentication required.
- `429`: 429 - Rate limit exceeded. Retry after the indicated interval.

---

[API](https://skmtc.dev/voidmob/apis/voidmob-public-api.md) · [All operations](https://skmtc.dev/voidmob/apis/voidmob-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/voidmob/apis/voidmob-public-api/revisions/066023313ebe?raw)