Get Addresses

Get verified addresses by State, LGA, and Postal Code

The Address endpoint (/business/get-addresses) provides you with a set of verified and validated addresses collected and verified by Amala from all over Nigeria.

Endpoint

GET https://api.amala.cloud/v1/business/get-addresses

You can optionally choose to apply filters to narrow down a specified range of addresses. Filtering can be done via the state, lga, district, and post_code query parameters.

Example Request

curl "http://api.amala.cloud/v1/business/get-addresses?api_key=94c9a525f3d3ac72e9f953d0be4dfea1"

Response

{
    "status": "success",
    "data": [
        {
            "state": "fct",
            "postal_code": "900107",
            "lga": "abuja municipal area council",
            "district": "kabusa",
            "address": "L.E.A Primary School Kabusa",
            "address_line_2": null
        },
        {
            "state": "fct",
            "postal_code": "900241",
            "lga":"abuja municipal area council",
            "district": "garki",
            "address": "Area 1 Shopping Plaza",
            "address_line_2": null
        }
    ]
}

Using filters:

Example Request

curl "http://api.amala.cloud/v1/business/get-addresses?api_key=94c9a525f3d3ac72e9f953d0be4dfea1&state=fct&district=garki"

Response

Status: 200 OK

Body:

{
    "status": "success",
    "data": [
        {
            "state": "fct",
            "postal_code": "900241",
            "lga": "abuja municipal area council",
            "district": "garki",
            "address": "Area 1 Shopping Plaza",
            "address_line_2": null
        }
    ]
}

Response status code

200 - OK
400 - Bad Request
401 - Unathorized