Get verification

Fetch one address check by its id. The body is the full verification.

GET /business/ava/verifications/:id

cURL

curl "$RUN_BASE_URL/business/ava/verifications/avr_01hxyzaddresscheck" \
  -H "Authorization: Bearer $RUN_API_KEY"

Address matched

{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "confirmed",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": "2026-10-25T16:05:00.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": "location_verification",
    "checked_at": "2026-10-25T16:05:00.000Z",
    "delivered_at": null,
    "confirmed_at": null,
    "method": "desk_review",
    "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"
  }
}

Fetch one address check by its id. The body is the same verification object returned by Check address.

Requires scope: ava:read

Headers

Authorization · string · required

Bearer API key (Bearer <api_key>).

Path parameters

id · string · required

The verification id (avr_…).

Response

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.

id · string

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

external_ref · string

Your reference for this check.

status · string

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

created_at · string

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

checked_at · string

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

address.input · string

The address you sent.

address.normalized · string

The address Run confirmed. null unless status is confirmed.

address.lat · number

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

address.lng · number

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

evidence · object

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

evidence.type · string

delivered_record or location_verification. null when evidence is null.

evidence.checked_at · string

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

evidence.delivered_at · string

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

evidence.confirmed_at · string

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

evidence.method · string

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

evidence.outcome · string

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

evidence.address_recorded · string

The address that was found, or null.

evidence.area · string

The area that was recorded, or null.

evidence.lat · number

Latitude recorded with the evidence, or null.

evidence.lng · number

Longitude recorded with the evidence, or null.

evidence.reachable · boolean

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

evidence.notes · string

The note stored with the evidence, or null.

evidence.reference · string

A reference stored with the evidence, or null.

evidence.proof_image_urls · string[]

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

field_visit_offer.available · boolean

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

field_visit_offer.amount_ngn · number

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

field_visit_offer.currency · string

Always NGN.

notes · string

The note for this check, or null.

charge.amount_ngn · number

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

charge.currency · string

Always NGN.

charge.check_type · string

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

charge.transaction_id · string

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

A successful call returns HTTP 200. status is the check as it stands now.

Address matched. status is confirmed. The pin is filled in, and charge.amount_ngn is the rate that was charged.

Still checking. status is processing. The pin is null. The normal check price is held, and notes is “We are checking this address. You will get an update when the check is finished.” After you accept a field visit, status stays processing and notes becomes “A field visit is underway.”

Field visit offered. status is not_found. field_visit_offer.available is true. Nothing has been charged.

Declined. You declined the field visit. status is declined. The offer is off. Nothing is charged.

Not confirmed. The check finished without a match, or it was not closed within 5 business days. The hold is released. charge.amount_ngn is null.

Unreachable. Staff went and the address was not there. An accepted visit is charged the visit rate. A check that never became a visit can finish as unreachable with charge.amount_ngn set to null.

An id that is missing, or that belongs to another business, returns 404.

cURL

curl "$RUN_BASE_URL/business/ava/verifications/avr_01hxyzaddresscheck" \
  -H "Authorization: Bearer $RUN_API_KEY"

Address matched

{
  "id": "avr_01hxyzaddresscheck",
  "external_ref": "ORDER-1842",
  "status": "confirmed",
  "created_at": "2026-10-25T15:20:00.000Z",
  "checked_at": "2026-10-25T16:05:00.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": "location_verification",
    "checked_at": "2026-10-25T16:05:00.000Z",
    "delivered_at": null,
    "confirmed_at": null,
    "method": "desk_review",
    "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"
  }
}