Get phone numbers
Add the direct dial or mobile number of up to 100 people you already found with search, reveal or enrich. Phone numbers are never included unless you ask for them. Each number that comes back costs 10 credits. People without a number cost nothing, and numbers your account already unlocked are free, whether that was in the app, the API, the command line or an AI connector. Phone numbers come with the Pro plan and higher. Every result says whether a number was returned and what it cost.
phone_status is returned (charged), already_unlocked (free), none_found (free), not_found (free), not_in_plan, not_enough_credits or daily_limit_reached. When the credits run out part way, the call still returns the numbers it could pay for and says where it stopped (stopped). If not a single number could be paid for, the answer is 402 insufficient_credits.
| Cost | What it does | Key scopes |
|---|---|---|
| 10 credits per phone number returned; no number, no charge; numbers you already unlocked are free | Spends credits | argorant:unlock_contacts |
Request
- Base URL: https://app.argorant.com
- URL: https://app.argorant.com/api/v1/people/phones
- Auth: HTTP bearer
Headers
Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.
Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.
Request body
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.