Search skmtc…
⌘K
Docs
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Generate
Filter operations
Accounts
14
Claims
8
Directory
14
Follows
4
Newsletter
5
Orders
19
get
/api/orders/{id}/report
An order's report as Markdown: a drive's (to a verified owner of the domain, once its review passed), or a free check's with next (where an agent would probably stop, the first fixes, whether it can be listed, what to order). A free check's report is usually ready 1 to 5 minutes after the order: the order's status turns done (GET /api/orders/{id}, MCP my_orders), the report is at GET /api/orders/{id}/report, and an account with an email address gets the result by mail at once. Before it ends: 409 not_ready; an id that isn't one of your orders: 404 not_found
get
/api/orders
Your orders
post
/api/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.
get
/api/orders/{id}/fixes
Your Audit's fix list: every fix from its drive, in order, with why and how, its effort and team, the level the fixes up to it reach (level_after; lifts_to where it lifts the level), and its state (open, fixed, as_is with your reason). Today's level, your goal, how far the fixes reach (L5 apart: it needs agent payments). drives: the audit drive and each new drive after fixes, with its status, the level it reached and its report; redrive: whether a new drive can start now and why not (one at a time, one a day), until when (120 days after the report; POST /api/orders/{id}/followup). Each drive's result is mapped onto the list: result done or still_there, new fixes at the end (new_since). It comes with the Audit's report (409 not_ready before); it never moves your level
post
/api/orders/{id}/fixes/{n}
Mark fix n: fixed when you made it, as_is to leave it as it is (reason: one line, 3 to 200 characters; it shows on your certificate), doesnt_apply when our finding is wrong or not for you (reason as for as_is; a person answers within 2 working days: agreed, it leaves your list and the certificate; refused, it is open again with our answer), open to undo
post
/api/orders/{id}/finish
Finish now: end your Audit Drive at L2 or above. No more drives after fixes; the fixes still open go on the certificate as Not done, and the certificate is checked at once (409 below_certificate under L2, 409 not_ready before a drive's report)
post
/api/orders/{id}/followup
A drive again after your fixes, part of an Audit Drive: one at a time and at most one a day (409 busy, 409 too_soon with next_at), within 120 days of its report (409 expired); after 10 a person looks before more run (409 look) (other orders have none: 409 not_included). It retests what failed, then continues where the first drive stopped. Our agent signs up again like a new customer (access answers 400 access_not_needed)
post
/api/orders/{id}/pay
Let our agent buy your plan: add or replace the code, test-mode login or seat on your order, until a drive has it (409 pay_in_use while one does; 409 order_closed once its drive is over)
delete
/api/orders/{id}/pay
Delete the code or login on your order now
post
/api/pay-check
The free checkout test. Test your checkout: Add a 100% off code and our agent buys your plan with it. A short private drive of your product's pay step: our agent signs up, buys your plan with the code (or in your checkout's test mode), uses one paid feature, cancels and deletes the account. Free for a product you've proved yours; one you've added but not proved counts with the free checks (429 rate_limited, scan_budget_reached), and its report opens once it's proved. One at a time per domain, its subdomains included (409 check_running), 2 per domain every 30 days (429 rate_limited with next_at), and a ceiling on all pay checks a day (429 rate_limited). 403 not_your_product: add the domain first (POST /api/claims); 403 claim_not_verified: a login (kind sandbox) needs the product proved yours, a code doesn't
post
/api/orders/{id}/checkout
Pay an order that waits for payment (status requested): its Stripe Checkout while it is open, else a new one for the same order. A person opens payment.url; an agent's own account pays over HTTP 402 instead (POST /api/orders/{id}/payment)
post
/api/orders/{id}/withdraw
Withdraw an order that has not been paid
post
/api/billing/cancel
Cancel a running Monthly drive (retired 18 Oct 2026; or a subscription from before 10 Oct 2026) for one product (order_id) or all: no further charges; it stops at the end of the paid period. The listing stays
get
/api/billing/renewals
Your Audit Drive renewals: an Audit Drive paid by card renews by itself at $199 a year, first 11 months after the payment. Each: id, domain, price_cents, state (on, off: it won't renew, past_due: a charge failed, ended), next_at, cancel_at
post
/api/billing/renewals/{id}/cancel
Turn an Audit Drive renewal off: nothing more is charged. It can be turned back on until next_at
post
/api/billing/renewals/{id}/resume
Turn an Audit Drive renewal back on before its next_at
post
/api/billing/switch
Switch a running Monthly drive (retired 18 Oct 2026) for one product between monthly and yearly billing; the change is prorated and invoiced at once
get
/api/billing/receipt/{id}
The invoice of one of your own paid orders: its Stripe invoice page (the PDF and receipt are there), or for an order paid over HTTP 402 its invoice or our receipt
post
/api/billing/portal
A link to invoices and payment methods
Pay over HTTP 402
8
Support
3
Webhooks
post
levelChanged
Builder and Team: a tool you follow changed level. Set the URL with PUT /api/follows/webhook. One POST per publish that changed a followed tool's level, sent once (no retry; a 2xx within 10 seconds counts): a missed one is in GET /api/tools.json. Check the signature: X-AgentDrives-Signature is t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" with your webhook's secret>; refuse a t more than 5 minutes off. User-Agent: AgentDrives-Webhooks/1.0
Orders
Copy
Copy Markdown
Copy Markdown
Copying…
Copied
Copy failed
Changes to The invoice of one of your own paid orders: its Stripe invoice page (the PDF and receipt are there), or for an order paid over HTTP 402 its invoice or our receipt
get
/api/billing/receipt/{id}
Oct 20, 2026
ae3f2c04ff72
Revision changes
info
endpoint added