---
title: "List verifications"
method: GET
path: "/verifications"
tags: ["Verifications"]
---

# List verifications

`GET /verifications`

## Request

- Base URL: `https://sandbox-api.paddle.com`
- URL: `https://sandbox-api.paddle.com/verifications`
- Auth: HTTP bearer

Returns a paginated list of verifications. Use the query parameters to page through results.

Filter by `verification_type=onboarding` and use the returned verification's `status` to check whether your account is ready for live payments or needs action.

## Query parameters

- `id` string[]
- `after` string
- `per_page` integer
- `verification_type` 'onboarding' | 'domain': Type of verification.
- `order_by` string

## Headers

- `Skip-Count` string

## Response `200`

The request has succeeded.

- object
  - `data` Verification[], required
    - `id` string, required: Unique Paddle ID for this verification entity, prefixed with `slrvrf_`.
    - `status` 'pending' | 'in_progress' | 'in_review' | 'action_required' | 'completed' | 'failed' | 'canceled', required: Overall status of the verification, derived from the status of its steps.
    - `verification_type` 'onboarding' | 'domain', required: Type of verification.
    - `created_at` string, date-time, required: RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
    - `updated_at` string, date-time, required: RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
    - `steps` VerificationStep[], required: Verification steps that make up this verification.
      - `id` string, required: Unique Paddle ID for this verification step entity, prefixed with `slrvrfstp_`.
      - `key` 'account_setup' | 'domain_review' | 'business_identification' | 'identity_verification' | 'final_review' | 'automated_review', required: Key of the verification step.
      - `status` 'pending' | 'in_progress' | 'in_review' | 'action_required' | 'failed' | 'completed' | 'canceled', required: Status of the verification step. Steps are created as `pending` initially, then move through `in_progress` and `in_review` states as Paddle processes each step.
      - `expires_at` string, date-time, required: RFC 3339 datetime string.
      - `created_at` string, date-time, required: RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
      - `updated_at` string, date-time, required: RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
  - `meta` PaginatedMeta, required: Information about this response.
    - `request_id` string, required: Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
    - `pagination` Pagination, required: Keys used for working with paginated results.
      - `per_page` integer, required: Number of entities per page for this response. May differ from the number requested if the requested number is greater than the maximum.
      - `next` string, uri, required: URL containing the query parameters of the original request, along with the `after` parameter that marks the starting point of the next page. Always returned, even if `has_more` is `false`.
      - `has_more` boolean, required: Whether this response has another page.
      - `estimated_total` integer: Estimated number of entities for this response. For datasets with 100,000 or fewer matches, returns the exact count. For datasets with more than 100,000 matches, returns `100001` to indicate that more than 100,000 entities match. Returns `-1` when counting is skipped or couldn't be calculated. Use `has_more` and `next` to page through all results rather than relying on `estimated_total` for an exact count.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paddlehq/apis/paddle-api/changes/verifications/get.md)

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)