---
title: "List all SMS received on a verification"
method: GET
path: "/verifications/{id}/messages"
tags: ["Verifications"]
---

# List all SMS received on a verification

`GET /verifications/{id}/messages`

## Request

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

Returns every SMS the number has received, newest first. The number can
receive several distinct codes over its life (the line is auto-reused
during the window), so this is the way to retrieve the full set rather
than just the latest `code` on the verification resource.

Includes ambient SMS with no extractable code (`code: null`). Uses the
generous `verifications_read` rate-limit bucket. Capped at the 200 most
recent messages.

## Path parameters

- `id` string, required: Opaque verification (SMS rental) identifier.

## Response `200`

All messages received on the number, newest first.

- object
  - `success` true, required
  - `data` object, required
    - `messages` VerificationMessage[], required
      - `code` string, nullable, required: Parsed OTP code, or null for ambient SMS with no extractable code.
      - `text` string, required: Full SMS body as received.
      - `received_at` string, date-time, required

## Other responses

- `401`: 401 - Authentication required.
- `404`: 404 - Verification not found.
- `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)
