Account, credits and limits
Everything an agent should know before it spends: the plan, the credits available now and where they come from, this month's campaign email allowance, the requests per minute and per 10 seconds this key may send, the searches and counts a minute the account may run (shared by all its keys) and, during the trial, a day, the other daily limits per key, and the key's scopes. Call it before a large reveal, export or campaign.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | none |
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
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.
^[A-Za-z0-9._-]{8,64}$Response Body
application/json
application/json
application/json
curl -X GET "https://app.argorant.com/api/v1/account"{ "email": "maria@northgate-advisory.com", "workspace": { "id": 1042, "name": "Northgate Advisory", "role": "owner" }, "plan": { "name": "Pro", "status": "active", "billing_interval": "month", "renews_at": "2026-11-01T00:00:00+00:00", "cancels_at_period_end": false }, "credits": { "available": 23140, "from_plan": 22140, "pay_as_you_go": 1000, "free": 0, "rules": "1 credit per validated contact (invalid ones cost nothing), 0.5 credit per email check, 10 credits per phone number returned." }, "limits": { "requests_per_minute": 240, "burst_per_10_seconds": 60, "searches_and_counts_per_minute": 60, "daily": { "counts": { "limit": null, "used_today": 12, "remaining_today": null }, "search_rows": { "limit": null, "used_today": 30, "remaining_today": null }, "reveals": { "limit": 100, "used_today": 0, "remaining_today": 100 }, "export_rows": { "limit": 50000, "used_today": 500, "remaining_today": 49500 }, "email_finds": { "limit": 2000, "used_today": 4, "remaining_today": 1996 }, "email_checks": { "limit": 200, "used_today": 0, "remaining_today": 200 } }, "per_call": { "search_rows": 10, "reveals": 25 }, "resets": "daily limits reset at midnight UTC; the per-minute window every minute; the burst window every 10 seconds", "shared": "counts, search rows and searches a minute are shared by every key of the account; requests a minute and the other daily limits are per key" }, "scopes": [ "argorant:read_counts", "argorant:search_segments", "argorant:manage_lists", "argorant:create_exports", "argorant:unlock_contacts", "argorant:verify_emails" ], "campaign_emails": { "unlimited": false, "allowance": 300000, "used": 41210, "remaining": 258790, "period": "month", "resets_on": "2026-11-01" }}