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 |
Authorization
BearerAuth Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.
In: header
Header Parameters
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.
length <= 128Your 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.
^[A-Za-z0-9._-]{8,64}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://app.argorant.com/api/v1/people/phones" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "record_ids": [ "p_8d4ba3d46cc885007c38e437", "p_1f0c2a9e77b3d4410e8a5c21", "p_77aa01b2c3d4e5f60718293a" ] }'{ "price_per_phone": 10, "charged_only_when_found": true, "requested": 3, "phones_returned": 2, "phones_charged": 1, "credits_charged": 10, "stopped": null, "summary": "2 phone numbers returned. 1 is new for 10 credits, and 1 you already had for free. 1 person has no phone number on record. That costs nothing.", "results": [ { "record_id": "p_8d4ba3d46cc885007c38e437", "full_name": "Alex Schneider", "phone": "+41445551234", "additional_phones": [], "phone_status": "returned", "credits_charged": 10 }, { "record_id": "p_1f0c2a9e77b3d4410e8a5c21", "full_name": "Maria Lenz", "phone": "+4930555987", "additional_phones": [], "phone_status": "already_unlocked", "credits_charged": 0 }, { "record_id": "p_77aa01b2c3d4e5f60718293a", "full_name": "Tom Berg", "phone": null, "additional_phones": [], "phone_status": "none_found", "credits_charged": 0 } ]}