---
title: "Submit Address Verification"
method: POST
path: "/v1/addresses"
---

# Submit Address Verification

`POST /v1/addresses`

## Request

- Base URL: `https://api.qoreid.com`
- URL: `https://api.qoreid.com/v1/addresses`
- Auth: OAuth 2

## Request body

- object
  - `customerReference` string, required: Customer reference
  - `street` string, required: The street to be verified
  - `lgaName` string, required: Local govt area name to be verified
  - `stateName` string, required: State
  - `landmark` string: Address landmark to be verified
  - `city` string, required: Address city to be verified
  - `applicant` object
    - `firstname` string, required: Applicant first name
    - `lastname` string, required: Applicant Lastname
    - `phone` string, required: Applicant phone
    - `dob` string: Applicant date of birth
    - `idType` 'nin' | 'bvn' | 'drivers_license': Applicant Identity Type
    - `idNumber` string: Applicant Identity Number
    - `gender` string: Applicant Gender
    - `alias` string: Applicant Alias
    - `otherPhone` string: Applicant Other Phone Number
  - `originalRequesterName` string: Original requester name (main requester company name)
  - `allowRevisit` boolean: Allow Revisit (Not a duplicate)
  - `addressExtraData` object: (Optional) Additional details about the address and property.
    - `houseNumber` string: House number.
    - `generalDescription` string: Free-text description of the address.
    - `latitude` number: Latitude of the address.
    - `longitude` number: Longitude of the address.
    - `buildingDescription` 'Residential' | 'Commercial': Building description.
    - `hasGateAndFence` boolean: Whether the property has both a gate and a fence.
    - `buildingStatus` 'Completed' | 'Painted' | 'Completed and Painted': Building status.
    - `buildingType` 'Multi-story' | 'Flats & Apartment' | 'Bungalow' | 'Office Complex': Building type.
    - `buildingColour` string: Primary visible building colour.
    - `applicantPhoto1` string: Base64-encoded house photo.
    - `applicantPhoto2` string: Base64-encoded house-number photo.
    - `applicantPhoto3` string: Base64-encoded nearest-landmark photo.

## Response `200`

200

- object
  - `id` integer
  - `customerReference` string
  - `applicant` object
    - `firstname` string
    - `middlename` string
    - `lastname` string
    - `gender` string
    - `phone` string
    - `dob` string
  - `summary` object
    - `address_check` string
  - `status` object
    - `status` string
    - `subStatus` string
    - `state` string
  - `address` object
    - `verificationTypeCode` string
    - `organisationId` integer
    - `requestedAt` string
    - `requestSource` string
    - `archived` boolean
    - `stateId` integer
    - `stateName` string
    - `lgaId` integer
    - `lgaName` string
    - `location` object
      - `city` string
      - `initialLatitude` number
      - `initialLongitude` number
      - `landmark` string
      - `latitude` number
      - `lgaName` string
      - `locationUrl` string
      - `longitude` number
      - `stateName` string
      - `street` string
    - `isVague` boolean
    - `customerReference` string
    - `paymentMethodCode` string
    - `price` integer
    - `updatedAt` string
    - `status` object
      - `status` string
      - `subStatus` string
      - `state` string
  - `duplicateRequest` boolean

## Changes

- **2026-11-03** `fd968e79b743`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qoreid/apis/baseurl/changes/v1/addresses/post.md)

---

[API](https://skmtc.dev/qoreid/apis/baseurl.md) - [All operations](https://skmtc.dev/qoreid/apis/baseurl/llms.txt) - [OpenAPI document](https://skmtc.dev/qoreid/apis/baseurl/revisions/fd968e79b743?raw)