> ## Documentation Index
> Fetch the complete documentation index at: https://run-deliverys.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Verification statuses

> What each address-check status means, and when the wallet is charged or held.

A check has one status. The charge is in naira, at the rate on your account. The amounts in the examples below are samples, so you can see every field. Your account uses its own rate.

Run confirms an address when the house number, the street, and the state match a previous delivery or a saved address, and the pins are on the same compound. The area name may differ. A map finding a building is not, by itself, a confirmation.

Available balance is the wallet balance minus any amount already held. Accepting a field visit requires that available balance to cover the visit price.

Five business days skip Saturday and Sunday.

| Status | What you see | Money |
| - | - | - |
| `confirmed` | The address matched. | Charged at once. |
| `not_found` | No match, and a field visit offer is still open. | No charge. |
| `declined` | You declined the field visit. | No charge. |
| `processing` | Run is still checking. | The check price is held. Accepting a visit replaces that hold with the visit price. |
| `not_confirmed` | The check finished without a match, or it was not closed within 5 business days. | The hold is released. No charge. |
| `unreachable` | Staff went and the address was not there. | An accepted visit is charged the visit price. A check that never became a visit can close with no charge. |

A field visit is offered on a `not_found` check when field visits are part of your account. The offer shows the visit rate. No money is taken when the offer is made. Declining the visit sets the check to `declined` and turns the offer off. When field visits are not on the account, a miss stays `processing` and Run checks the address.

While a check is `processing` and has not become a visit, `notes` is “We are checking this address. You will get an update when the check is finished.” After you accept a visit, `notes` is “A field visit is underway.”

`ava.verification.completed` is sent when a `processing` check finishes as `confirmed`, `not_confirmed`, or `unreachable`, including the close after 5 business days. It is not sent when you first submit a check, when you accept or decline a visit, or when a check is confirmed immediately from a past record.

There is a daily number of checks on your account. Above that number, the next check returns `429` until the next day.

## Confirmed

```json theme={null}
{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "confirmed",
  "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": "12 Adeola Odeku Street, Victoria Island, Lagos",
    "lat": 6.4281,
    "lng": 3.4219
  },
  "evidence": {
    "type": "delivered_record",
    "checked_at": "2026-10-25T15:20:01.000Z",
    "delivered_at": "2026-10-20T14:00:00.000Z",
    "confirmed_at": null,
    "method": null,
    "outcome": "confirmed",
    "address_recorded": "12 Adeola Odeku Street, Victoria Island, Lagos",
    "area": "Victoria Island",
    "lat": 6.4281,
    "lng": 3.4219,
    "reachable": true,
    "notes": null,
    "reference": null,
    "proof_image_urls": []
  },
  "field_visit_offer": {
    "available": false,
    "amount_ngn": null,
    "currency": "NGN"
  },
  "notes": null,
  "charge": {
    "amount_ngn": 2000,
    "currency": "NGN",
    "check_type": "historical",
    "transaction_id": "txn_01hxyz"
  }
}
```

## Not found

```json theme={null}
{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "not_found",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": null,
  "address": {
    "input": "22 Fola Osibo Street, Lekki Phase 1, 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
  }
}
```

## Declined

```json theme={null}
{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "declined",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": "2026-10-25T15:25:00.000Z",
  "address": {
    "input": "22 Fola Osibo Street, Lekki Phase 1, Lagos",
    "normalized": null,
    "lat": null,
    "lng": null
  },
  "evidence": null,
  "field_visit_offer": {
    "available": false,
    "amount_ngn": null,
    "currency": "NGN"
  },
  "notes": null,
  "charge": {
    "amount_ngn": null,
    "currency": "NGN",
    "check_type": null,
    "transaction_id": null
  }
}
```

## Processing

```json theme={null}
{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "processing",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": null,
  "address": {
    "input": "5 Thompson Avenue, Ikoyi, Lagos",
    "normalized": null,
    "lat": null,
    "lng": null
  },
  "evidence": null,
  "field_visit_offer": {
    "available": false,
    "amount_ngn": null,
    "currency": "NGN"
  },
  "notes": "We are checking this address. You will get an update when the check is finished.",
  "charge": {
    "amount_ngn": null,
    "currency": "NGN",
    "check_type": null,
    "transaction_id": null
  }
}
```

## Not confirmed

```json theme={null}
{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "not_confirmed",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": "2026-11-01T15:20:00.000Z",
  "address": {
    "input": "54 Admiralty Way, Lekki Phase 1, Lagos",
    "normalized": null,
    "lat": null,
    "lng": null
  },
  "evidence": {
    "type": "location_verification",
    "checked_at": "2026-11-01T15:20:00.000Z",
    "delivered_at": null,
    "confirmed_at": null,
    "method": "desk_review",
    "outcome": "not_confirmed",
    "address_recorded": "54 Admiralty Way, Lekki Phase 1, Lagos",
    "area": null,
    "lat": null,
    "lng": null,
    "reachable": null,
    "notes": null,
    "reference": null,
    "proof_image_urls": []
  },
  "field_visit_offer": {
    "available": false,
    "amount_ngn": null,
    "currency": "NGN"
  },
  "notes": null,
  "charge": {
    "amount_ngn": null,
    "currency": "NGN",
    "check_type": null,
    "transaction_id": null
  }
}
```

## Unreachable

This example is an accepted visit that was charged. `charge.amount_ngn` is your visit rate. A check that never became a visit can finish as `unreachable` with `charge.amount_ngn` set to `null`.

```json theme={null}
{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "unreachable",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": "2026-10-26T11:00:00.000Z",
  "address": {
    "input": "9 Oduduwa Street, GRA Ikeja, Lagos",
    "normalized": null,
    "lat": null,
    "lng": null
  },
  "evidence": {
    "type": "location_verification",
    "checked_at": "2026-10-26T11:00:00.000Z",
    "delivered_at": null,
    "confirmed_at": null,
    "method": "field_visit",
    "outcome": "unreachable",
    "address_recorded": "9 Oduduwa Street, GRA Ikeja, Lagos",
    "area": "GRA Ikeja",
    "lat": 6.6012,
    "lng": 3.3511,
    "reachable": false,
    "notes": "The address was not there.",
    "reference": null,
    "proof_image_urls": [
      "https://res.cloudinary.com/example/image/upload/street.jpg"
    ]
  },
  "field_visit_offer": {
    "available": false,
    "amount_ngn": null,
    "currency": "NGN"
  },
  "notes": "The address was not there.",
  "charge": {
    "amount_ngn": 8000,
    "currency": "NGN",
    "check_type": "field_visit",
    "transaction_id": "txn_01hxyz"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.