POST /v1/billing/quote - SEC API for AI

curl -X POST \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  -H "content-type: application/json" \
  -d '{"path":"/v1/facts","method":"GET","units":1}' \
  "https://api.secapi.ai/v1/billing/quote"

{
  "object": "billing_quote",
  "planKey": "personal",
  "meterClass": "fact_lookup",
  "meterFamily": "standard_read",
  "units": 1,
  "unitAmountUsd": 0,
  "amountUsd": 0,
  "amountCents": 0,
  "currency": "usd",
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "budget": {},
  "budgetGate": null
}

Quote a billable workflow or meter class against the current billing plan and budget gates

Audience: application and coding agent.

Canonical metadata

requestId
traceparent
planKey
meterClass
units
budget
budgetGate

Example request

curl -X POST \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  -H "content-type: application/json" \
  -d '{"path":"/v1/facts","method":"GET","units":1}' \
  "https://api.secapi.ai/v1/billing/quote"

Example response

{
  "object": "billing_quote",
  "planKey": "personal",
  "meterClass": "fact_lookup",
  "meterFamily": "standard_read",
  "units": 1,
  "unitAmountUsd": 0,
  "amountUsd": 0,
  "amountCents": 0,
  "currency": "usd",
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "budget": {},
  "budgetGate": null
}

Request body

Provide meterClass or path. method is used with path and defaults to GET; planKey and positive units are optional. The quote reflects the current plan and budget gate. It does not reserve usage or guarantee a later request’s billing state.

Give this prompt to your agent

Failure posture

treat non-2xx responses as contract-aware failures, not free-form errors
preserve requestId and traceparent in logs and downstream reports
if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff