List verifications

curl "$RUN_BASE_URL/business/ava/verifications?page=1&limit=20&offer=open" \
  -H "Authorization: Bearer $RUN_API_KEY"

const res = await fetch(
  `${process.env.RUN_BASE_URL}/business/ava/verifications?page=1&limit=20&offer=open`,
  { headers: { Authorization: `Bearer ${process.env.RUN_API_KEY}` } },
);
const page = await res.json();

import os
import requests

res = requests.get(
    f"{os.environ['RUN_BASE_URL']}/business/ava/verifications",
    params={"page": 1, "limit": 20, "offer": "open"},
    headers={"Authorization": f"Bearer {os.environ['RUN_API_KEY']}"},
)
page = res.json()

<?php
$ch = curl_init(getenv('RUN_BASE_URL') . '/business/ava/verifications?page=1&limit=20&offer=open');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RUN_API_KEY')],
]);
$page = json_decode(curl_exec($ch), true);
curl_close($ch);

package main

import (
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", os.Getenv("RUN_BASE_URL")+"/business/ava/verifications?page=1&limit=20&offer=open", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("RUN_API_KEY"))
  http.DefaultClient.Do(req)
}

{
  "data": [
    {
      "id": "avr_01hxyzaddresscheck",
      "external_ref": "ORDER-1842",
      "status": "not_found",
      "created_at": "2026-10-25T15:20:00.000Z",
      "checked_at": "2026-10-25T15:20:01.000Z",
      "address": {
        "input": "12 Adeola Odeku, Victoria Island, Lagos",
        "normalized": null,
        "lat": null,
        "lng": null
      },
      "evidence": null,
      "field_visit_offer": {
        "available": true,
        "amount_ngn": 8000,
        "currency": "NGN"
      },
      "notes": null,
      "charge": {
        "amount_ngn": null,
        "currency": "NGN",
        "check_type": null,
        "transaction_id": null
      }
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

GET

business

ava

verifications

curl "$RUN_BASE_URL/business/ava/verifications?page=1&limit=20&offer=open" \
  -H "Authorization: Bearer $RUN_API_KEY"

const res = await fetch(
  `${process.env.RUN_BASE_URL}/business/ava/verifications?page=1&limit=20&offer=open`,
  { headers: { Authorization: `Bearer ${process.env.RUN_API_KEY}` } },
);
const page = await res.json();

import os
import requests

res = requests.get(
    f"{os.environ['RUN_BASE_URL']}/business/ava/verifications",
    params={"page": 1, "limit": 20, "offer": "open"},
    headers={"Authorization": f"Bearer {os.environ['RUN_API_KEY']}"},
)
page = res.json()

<?php
$ch = curl_init(getenv('RUN_BASE_URL') . '/business/ava/verifications?page=1&limit=20&offer=open');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RUN_API_KEY')],
]);
$page = json_decode(curl_exec($ch), true);
curl_close($ch);

package main

import (
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", os.Getenv("RUN_BASE_URL")+"/business/ava/verifications?page=1&limit=20&offer=open", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("RUN_API_KEY"))
  http.DefaultClient.Do(req)
}

{
  "data": [
    {
      "id": "avr_01hxyzaddresscheck",
      "external_ref": "ORDER-1842",
      "status": "not_found",
      "created_at": "2026-10-25T15:20:00.000Z",
      "checked_at": "2026-10-25T15:20:01.000Z",
      "address": {
        "input": "12 Adeola Odeku, Victoria Island, Lagos",
        "normalized": null,
        "lat": null,
        "lng": null
      },
      "evidence": null,
      "field_visit_offer": {
        "available": true,
        "amount_ngn": 8000,
        "currency": "NGN"
      },
      "notes": null,
      "charge": {
        "amount_ngn": null,
        "currency": "NGN",
        "check_type": null,
        "transaction_id": null
      }
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

List address checks for your business. Each item in data is the full verification object. Requires scope: ava:read

Headers

string

required

Bearer API key (Bearer <api_key>).

Query parameters

number

Page number. The default is 1.

number

Page size. The default is 20. The maximum is 100.

string

Pass open to list checks that are not_found and still have a field visit you can accept or decline.

Response

array

One full verification per item. Every field on each item is listed below.

number

The page you requested.

number

The page size used for this response.

number

The number of checks that match the filter.

Each item in `data`

address.normalized, address.lat, and address.lng are present only when status is confirmed. Otherwise they are null. evidence is one object, or null when Run has not recorded evidence yet.

string

Run’s id for this check. It starts with avr_.

string

Your reference for this check.

string

confirmed, not_found, declined, processing, not_confirmed, or unreachable. See Verification statuses.

string

When you created the check, in ISO 8601. Null only if the time is missing.

string

When the check finished, in ISO 8601. null until then.

string

The address you sent.

string

The address Run confirmed. null unless status is confirmed.

number

Latitude of the confirmed address. null unless status is confirmed.

number

Longitude of the confirmed address. null unless status is confirmed.

object

One evidence object, or null. type is delivered_record for a past delivery, or location_verification for a check Run recorded.

string

delivered_record or location_verification. null when evidence is null.

string

When this evidence was recorded, in ISO 8601, or null.

string

When a past delivery arrived, in ISO 8601, or null.

string

When the evidence was confirmed, in ISO 8601, or null.

string

How it was checked: field_visit, rider, agent, local_contact, or desk_review. null when this evidence has no method.

string

confirmed, not_confirmed, or unreachable. null when this evidence has no outcome.

string

The address that was found, or null.

string

The area that was recorded, or null.

number

Latitude recorded with the evidence, or null.

number

Longitude recorded with the evidence, or null.

boolean

Whether the address could be reached. null when that was not recorded.

string

The note stored with the evidence, or null.

string

A reference stored with the evidence, or null.

string[]

Photo links. An empty list when there are no photos. Omitted from the object only when evidence itself is null.

boolean

true when you can still accept or decline a field visit.

number

The visit price in naira when available is true. null when no visit is offered. This is the rate on your account.

string

Always NGN.

string

The note for this check, or null.

number

The amount taken from the wallet, in naira, or null when this check has not been charged.

string

Always NGN.

string

historical for a normal check, or field_visit for a visit. null when this check has not been charged.

string

The wallet transaction id, or null when this check has not been charged.

curl "$RUN_BASE_URL/business/ava/verifications?page=1&limit=20&offer=open" \
  -H "Authorization: Bearer $RUN_API_KEY"

const res = await fetch(
  `${process.env.RUN_BASE_URL}/business/ava/verifications?page=1&limit=20&offer=open`,
  { headers: { Authorization: `Bearer ${process.env.RUN_API_KEY}` } },
);
const page = await res.json();

import os
import requests

res = requests.get(
    f"{os.environ['RUN_BASE_URL']}/business/ava/verifications",
    params={"page": 1, "limit": 20, "offer": "open"},
    headers={"Authorization": f"Bearer {os.environ['RUN_API_KEY']}"},
)
page = res.json()

<?php
$ch = curl_init(getenv('RUN_BASE_URL') . '/business/ava/verifications?page=1&limit=20&offer=open');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RUN_API_KEY')],
]);
$page = json_decode(curl_exec($ch), true);
curl_close($ch);

package main

import (
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", os.Getenv("RUN_BASE_URL")+"/business/ava/verifications?page=1&limit=20&offer=open", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("RUN_API_KEY"))
  http.DefaultClient.Do(req)
}

{
  "data": [
    {
      "id": "avr_01hxyzaddresscheck",
      "external_ref": "ORDER-1842",
      "status": "not_found",
      "created_at": "2026-10-25T15:20:00.000Z",
      "checked_at": "2026-10-25T15:20:01.000Z",
      "address": {
        "input": "12 Adeola Odeku, Victoria Island, Lagos",
        "normalized": null,
        "lat": null,
        "lng": null
      },
      "evidence": null,
      "field_visit_offer": {
        "available": true,
        "amount_ngn": 8000,
        "currency": "NGN"
      },
      "notes": null,
      "charge": {
        "amount_ngn": null,
        "currency": "NGN",
        "check_type": null,
        "transaction_id": null
      }
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

Get started

Core concepts

Orders

Address verification

Webhooks

Guides

Headers

Query parameters

Response

Each item in `data`

​Headers

​Query parameters

​Response

​Each item in data

Headers

Query parameters

Response

Each item in `data`