Agents
Lookup Agent
Find agent by phone number
GET
Documentation Index
Fetch the complete documentation index at: https://docs.vultlocal.com/llms.txt
Use this file to discover all available pages before exploring further.
Find an agent by their registered phone number. Useful for verifying agents before transactions.
Request
Bearer olive_live_xxx or Bearer eyJ... (JWT)Query Parameters
Phone number to search. Accepts local (
0771234567) or E.164 (+23277123456)Response
Whether agent was found
Agent object if found
Examples
Use Cases
Agent Verification
Verify agent identity before funding
Float Transfer
Find sub-agent before transferring float
Errors
| Status | Code | Description |
|---|---|---|
| 400 | MISSING_PHONE | phone_number query param required |
| 401 | UNAUTHORIZED | Invalid API key |
| 404 | NOT_FOUND | No agent with this phone |
| 500 | INTERNAL_ERROR | Server error |