Quote a credit pack
Prices one pack and says how it would be paid. When the account owner allowed purchases with the saved card in the app (Settings > Billing, up to a monthly limit), the key or connection belongs to the owner and the price fits the limits, the quote names the card and the purchase is charged at once; otherwise the purchase returns a payment link the user pays themselves and payment.saved_card.reason says why. Nothing is charged here. Show the quote to the person who pays and buy only after their yes. A quote holds for 24 hours; a saved-card purchase must follow within 15 minutes.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | argorant:manage_lists |
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/credits/quote" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "credits": 5000, "currency": "usd" }'{ "quote_id": "2f8a1b3c-4d5e-4f70-8192-a3b4c5d6e7f8", "credits": 5000, "currency": "usd", "amount_cents": 6900, "price": "$69.00", "valid_for_days": 365, "expires_at": "2026-10-08T12:00:00+00:00", "summary": "5,000 credits for $69.00, paid once, no subscription. They stay valid for 365 days and work for contacts (1 credit each), email checks (0.5 credit) and phone numbers (10 credits).", "payment": { "saved_card": { "usable": false, "card": null, "charge_before": null, "reason": "The account owner has not allowed AI assistants to buy credits with the saved card. The owner can switch it on in Settings > Billing.", "code": "not_opted_in" }, "summary": "The purchase returns a payment link the user pays themselves. Nothing is charged before that payment." }, "next_step": "Show this quote to the user and buy only after their explicit yes: POST /api/v1/credits/purchases with quote_id, confirmed=true and the user's own words in user_confirmation. You get a payment link to give to the user."}