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

product'free' | 'audit' | 'renewal' | 'proof' | 'stack' | 'stack3' | 'builder' | 'team' required

free: Free check · audit: Audit Drive · renewal: Audit Drive renewal · proof: Payment proof · stack/stack3: Stack check · builder/team: data plans. The Monthly drive (monthly, yearly, verified_month, verified) is retired: 400 product_retired. Orders answer with the ids above; whoami's orders keep the stored ones (drive an Audit Drive, a renewal with renewal_of; quick and report: retired Findings and Full report orders)

offers_okboolean

free: true only if you want the monthly agent access report and offers

rivalsstring[]

audit (the Audit Drive): up to 3 rival products, as URLs or directory slugs (not your own domain), compared with you privately

targetinteger

audit or renewal: your goal, the level you aim for (1 to 5). It shows on your dashboard as your goal, never a promise: the level is the one the drives find

toolstring
urlstring uri
urlsstring[]

Stack check: the tools to drive (stack3: up to 3; stack: 5 included, up to 10)

use_casestring

Stack check: what your agents should do with the tools

emailstring email

An agent's own account, a Stack check or a data plan: the address for the receipt and our mails about the order (the comparison ready, the plan's end). Optional; 400 invalid_email

notestring
listedboolean

false: the drive stays private, never in the directory

accessstring

Not on an Audit Drive or its renewal (400 access_not_needed: we sign up ourselves). Elsewhere optional: a login, key, sandbox or coupon our agent may use past your sign-up wall

security_okboolean

Your go-ahead for the Audit Drive's security review of the agent surfaces, on our own account (required for audit)

businessboolean

Paid orders: true confirms you buy for your business. AgentDrives sells to businesses only (https://agentdrives.com/legal/terms#business); the order records it. Stripe's checkout asks the business name, billing address and VAT ID for the invoice

no_offersboolean

Paid orders: true and we send you no offers for our other products

authoriseboolean

With pay kind code, required: true is your go-ahead, "Our agent may buy and cancel my paid plan with this code." (else 400 authorise_required)

processor'card' | 'paddle'

With pay kind code: your checkout. card: Stripe, Lemon Squeezy, Shopify or another checkout, your code leaves $0.50 and a Payment proof costs $0.87; paddle: Paddle, your code leaves $0.70 and a Payment proof costs $1.09. Default card

codestring

Optional: a promotion code of ours. Its discount comes off this order, at the card checkout and over HTTP 402 (400 invalid_code when it is unknown, expired or used up)

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

orderunknown
paymentunknown
queuedunknown
next_free_atstring date-time

when the domain's next free check opens: 90 days after this one

notestring

Changes

No recorded changes to this operation across all 5 revisions of this API.