---
title: "Get a list check"
method: GET
path: "/api/v1/verifications/{run_id}"
tags: ["Verification"]
---

# Get a list check

`GET /api/v1/verifications/{run_id}`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/verifications/{run_id}`
- Auth: HTTP bearer

Progress and how many addresses got each result: valid, invalid, catch_all (the domain accepts every address), risky, unknown. The full list with each address stays in the app at results_url. Free.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:verify_emails` |

## Path parameters

- `run_id` string, required

## Headers

- `X-Request-Id` string

## Response `200`

OK

- VerificationRun
  - `run_id` string: Run id.
  - `total` integer: Addresses in the run.
  - `done` integer: Addresses checked so far.
  - `complete` boolean: true when every address is checked.
  - `summary` object: How many addresses got each result.
    - `valid` integer
    - `invalid` integer
    - `catch_all` integer
    - `risky` integer
    - `unknown` integer
    - `pending` integer
  - `credits_charged` integer: Credits charged.
  - `checks_charged` integer: Fresh checks charged.
  - `results_url` string, uri: Where the full results are in the app.

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:verify_emails.
- `404`: 404 Not found. `not_found` when the item does not exist in your workspace.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

[API](https://skmtc.dev/argorant/apis/argorant-api.md) · [All operations](https://skmtc.dev/argorant/apis/argorant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/argorant/apis/argorant-api/revisions/4bc28c0085b6?raw)