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. A field visit may be offered.	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. 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

{
  "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

{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "not_found",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": null,
  "address": {
    "input": "44 Unity Avenue, Okerube, 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
  }
}

Processing

{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "processing",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": null,
  "address": {
    "input": "44 Unity Avenue, Okerube, 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

{
  "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": "44 Unity Avenue, Okerube, 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": "44 Unity Avenue, Okerube, 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.

{
  "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": "44 Unity Avenue, Okerube, 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": "44 Unity Avenue, Okerube, Lagos",
    "area": "Okerube",
    "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"
  }
}