Skip to main content
GET
Find an agent by their registered phone number. Useful for verifying agents before transactions.

Request

string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)

Query Parameters

string
required
Phone number to search. Accepts local (0771234567) or E.164 (+23277123456)

Response

boolean
Whether agent was found
object
Agent object if found

Examples


Use Cases

Agent Verification

Verify agent identity before funding

Float Transfer

Find sub-agent before transferring float

Errors

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

phone_number
string
required

Phone number in E.164 format

Response

OK

The response is of type object.