---
title: "Verify Search"
method: GET
path: "/search/{format}"
---

# Verify Search

`GET /search/{format}`

Use Verify search to check the status of past or current verification requests:

1. Send a Verify search request containing the `request_id`s of the verification requests you are interested in.
2. Use the `status` of each verification request in the `checks` array of the response object to determine the outcome.

*Note that this endpoint is available by `POST` request as well as `GET`.*

## Path parameters

- `format` 'json' | 'xml', required

## Query parameters

- `api_key` string, required — You can find your API key in your [account dashboard](https://dashboard.nexmo.com)
- `api_secret` string, required — You can find your API secret in your [account dashboard](https://dashboard.nexmo.com)
- `request_id` string, required
- `request_ids` string[]

## Response `200`

OK

- union
  - SearchResponse — Success
    - `account_id` string — The Vonage account ID the request was for.
    - `checks` object[] — The list of checks made for this verification and their outcomes.
      - `code` string — The code supplied with this check request
      - `date_received` string — The date and time this check was received (in the format YYYY-MM-DD HH:MM:SS)
      - `ip_address` string — The IP address, if available (this field is no longer used).
      - `status` 'VALID' | 'INVALID'
    - `currency` string — The currency code.
    - `date_finalized` string — The date and time the verification request was completed. This response parameter is in the following format YYYY-MM-DD HH:MM:SS.
    - `date_submitted` string — The date and time the verification request was submitted, in the following format YYYY-MM-DD HH:MM:SS.
    - `estimated_price_messages_sent` string — This field may not be present, depending on your pricing model. The value indicates the cost (in EUR) of the calls made and messages sent for the verification process. This value may be updated during and shortly after the request completes because user input events can overlap with message/call events. When this field is present, the total cost of the verification is the sum of this field and the `price` field.
    - `events` object[] — The events that have taken place to verify this number, and their unique identifiers.
      - `id` string
      - `type` 'tts' | 'sms'
    - `first_event_date` string — The time the first verification attempt was made, in the following format YYYY-MM-DD HH:MM:SS.
    - `last_event_date` string — The time the last verification attempt was made, in the following format YYYY-MM-DD HH:MM:SS.
    - `number` string — The phone number this verification request was used for.
    - `price` string — The cost incurred for this verification request.
    - `request_id` string — The `request_id` that you received in the response to the Verify request and used in the Verify search request.
    - `sender_id` string — The `sender_id` you provided in the Verify request.
    - `status` 'IN PROGRESS' | 'SUCCESS' | 'FAILED' | 'EXPIRED' | 'CANCELLED' — Code | Description -- | -- IN PROGRESS | The search is still in progress. SUCCESS | Your user entered a correct verification code. FAILED | Your user entered an incorrect code more than three times. EXPIRED | Your user did not enter a code before the `pin_expiry` time elapsed. CANCELLED | The verification process was cancelled by a Verify control request.
  - SearchErrorResponse — Error
    - `error_text` string — If `status` is not `SUCCESS`, this message explains the issue encountered.
    - `request_id` string — The `request_id` that you received in the response to the Verify request and used in the Verify search request. May be empty in an error situation.
    - `status` 'IN PROGRESS' | 'FAILED' | 'EXPIRED' | 'CANCELLED' | '101' — Code | Description -- | -- IN PROGRESS | The search is still in progress. SUCCESS | Your user entered a correct verification code. FAILED | Your user entered an incorrect code more than three times. EXPIRED | Your user did not enter a code before the `pin_expiry` time elapsed. CANCELLED | The verification process was cancelled by a Verify control request. 101 | You supplied an invalid `request_id`, or the data is not available. Note that for recently-completed requests, there can be a delay of up to 1 minute before the results are available in search.

---

[API](https://skmtc.net/vonage/apis/verify.md) · [All operations](https://skmtc.net/vonage/apis/verify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vonage/verify/versions/9b6adb3b4f08/schema)