Skip to main content

Address search

Reeds Engineering
Reeds Engineering
Developer platform

Your checkout can now complete an address as your customer types, or read one from a map pin. Address search is free.

What's new​

  • GET /addresses/autocomplete suggests places in Nigeria for what your customer has typed. Send one session_token per address, so the whole search counts once.
  • GET /addresses/details returns the full address of the suggestion they chose (send its place_id): formatted_address, area, lga, state, the coordinates, and precise (a street address or building, rather than a whole area).
  • GET /addresses/reverse returns the address at a map pin.

Each answer has what a quote needs: send its place_id, lga and state in POST /quotes.

These are the only /addresses endpoints. There is still no address book: quotes take the address itself, and nothing is saved.

Allowance​

In Test mode each account has 50 searches to start, and Reeds can raise it. In Live mode searches are unlimited unless Reeds sets a monthly limit for your account. Address search has its own rate limit, the /addresses/... group: 120 requests a minute on business accounts, 600 on platform accounts. Past the allowance or the limit the answer is 403 ADDRESS_SEARCH_LIMIT_REACHED. Reeds can switch address search off for an account in Live (403 ADDRESS_SEARCH_DISABLED).

Read the guide: Address search.