> ## 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.

# Get verification

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

Fetch one address check by its id. The body is the same verification object returned by [Check address](https://run-deliverys.mintlify.site/address-verification/check-address.md).

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](https://run-deliverys.mintlify.site/address-verification/statuses.md).

**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`.

```bash cURL theme={null}
curl "$RUN_BASE_URL/business/ava/verifications/avr_01hxyzaddresscheck" \
  -H "Authorization: Bearer $RUN_API_KEY"
```

```javascript Node.js theme={null}
const res = await fetch(
  `${process.env.RUN_BASE_URL}/business/ava/verifications/avr_01hxyzaddresscheck`,
  { headers: { Authorization: `Bearer ${process.env.RUN_API_KEY}` } },
);
const verification = await res.json();
```

```python Python theme={null}
import os
import requests

res = requests.get(
    f"{os.environ['RUN_BASE_URL']}/business/ava/verifications/avr_01hxyzaddresscheck",
    headers={"Authorization": f"Bearer {os.environ['RUN_API_KEY']}"},
)
verification = res.json()
```

```php PHP theme={null}
<?php
$ch = curl_init(getenv('RUN_BASE_URL') . '/business/ava/verifications/avr_01hxyzaddresscheck');
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RUN_API_KEY')],
]);
$verification = json_decode(curl_exec($ch), true);
curl_close($ch);
```

```go Go theme={null}
package main

import (
  "net/http"
  "os"
)

func main() {
  req, _ := http.NewRequest("GET", os.Getenv("RUN_BASE_URL")+"/business/ava/verifications/avr_01hxyzaddresscheck", nil)
  req.Header.Set("Authorization", "Bearer "+os.Getenv("RUN_API_KEY"))
  http.DefaultClient.Do(req)
}
```

```json Address matched theme={null}
{
  "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"
  }
}
```

```json Still checking 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
  }
}
```

```json Field visit offered 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
  }
}
```

```json Declined 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
  }
}
```

```json Not confirmed 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
  }
}
```

```json Unreachable 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.