Orders
Step 3 of 3, orders for your product (prices before tax; the whole offer: https://agentdrives.com/pricing.json). Every product we drive is listed with its level, free; an owner who wants every fix checked orders an Audit Drive. The free check (free, $0): what an agent sees: what it finds without a browser, the wall it would likely hit, the 3 first fixes, how the driven products in your category did and whether the product can be listed; private, never in the directory; any signed-in account, no domain proof; offers_ok: true only if you want the monthly report and offers; one per domain every 90 days (within them the call answers with the domain's latest check and next_free_at, no new check), 3 a day per account and a daily budget for everyone (429). An Audit Drive (audit, $499 one time): a new complete drive: our agent signs up like a new customer (we make the account: access answers 400 access_not_needed); every documented API route, MCP tool and CLI command checked against your docs; a security review checked by a reviewer agent (security_ok: true is your go-ahead); up to 3 rivals (rivals: URLs or directory slugs; each driven on the agent path unless the directory drove it in the last 60 days, robots.txt honoured, compared with you privately); with your discount code (pay: kind code or seat), one real purchase in your checkout, inside the price (a code works up to 10 times until 120 days after the report); your fix list; after your fixes a new drive when you ask, one at a time and at most once a day, within 120 days of the report (followup_drive); from L2 up it ends in a certificate with the level the drives find, valid 12 months. target: the level you aim for (1 to 5), shown as your goal, never promised: the level is the one the drives find, and a paid audit can come out low. Your paid plan at cost is optional (plan: include or none); fair use: one product, up to about 3 hours of driving, a fixed sampling order on very large surfaces, and the report says what was sampled. The report within 48 hours. The Audit Drive renewal (renewal, $199 a year): a new audit drive of the product and drives again after your fixes for 120 days; it opens 11 months after your audit's report and closes at 13 (409 renewal_not_open); security_ok: true, no rivals. Findings, the Full report and their upgrades are retired: drive, findings, quick, report and upgrade_from answer 400 product_retired. After a fix, a verified owner's listed product is driven again for free, up to twice a year (POST /api/claims/{id}/recheck). A drive you order is labelled Owner-paid drive. Also a Stack check (stack3 $490, stack $1,490) or a data plan (builder $49 a month: each drive's attempt log, GET /api/detail/<slug>; team $290 a month: that and the bulk export, GET /api/export). A Stack check's tool or a rival whose owner asked us to stop driving it: 409 drive_stopped. Orders for your own product need a verified claim on its domain (else 403 claim_not_verified, with the claim and the ways to verify it). When online payment is on, payment.url is returned: open it to pay. Ordering the same thing again while it waits for payment answers 200 with that order (reused: true) and its checkout, never a second order; POST /api/orders/{id}/checkout opens it again too. An Audit Drive and its renewal, a Stack check and a data plan also return payment.agent: an agent pays it over HTTP 402 (MPP or x402, POST /api/orders/{id}/payment) without a person, at the same price; an agent's own account (POST /api/agents/signup) pays only that way, an Audit Drive once its domain is verified, and may send email for the receipt. Paid over HTTP 402, a data plan runs one month and doesn't renew by itself: pay again before it ends and the next month follows on. We email you 3 days before it ends. By ordering you agree to the terms (https://agentdrives.com/legal/terms; privacy: https://agentdrives.com/legal/privacy); the order records their date. AgentDrives is for businesses: a paid order takes business: true to confirm you buy for your business (Stripe's checkout asks the business name, billing address and VAT ID), and no_offers: true to get no offers for our other products.
post/api/orders
Request
- Base URL: https://agentdrives.com
- URL: https://agentdrives.com/api/orders
- Auth: one of:
- API key in header x-api-key
- HTTP bearer
Headers
Idempotency-Keystring
Any unique value, e.g. a UUID: the same order sent again with it returns the order it made (200, replayed), never a second one, for 24 hours; the same key with another body answers 422 idempotency_key_reused
Request body
Example request
{
"buyer": {
"vat_id": "DE123456789",
"country": "US"
}
}Response
free, within 90 days of the domain's last finished free check (any account): no new check; the latest one and when the next free one opens. A paid order while the same one waits for payment: that order (reused: true), its checkout in payment.url
Changes
No recorded changes to this operation across all 5 revisions of this API.