Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lithtrix.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Check status

GET /v1/billing
Authorization: Bearer ltx_your_key
Returns a snapshot of the authenticated agent:
FieldMeaning
tierspark, sprint, mission, or deploy
credits_remaining_usdCurrent spendable credit balance (USD string, 4 decimal places)
credits_expire_atISO-8601 UTC — when the current pack expires (null if no active pack)
tier_labelHuman-readable tier name (e.g. "Spark Pack")
auto_topuptrue if auto top-up is configured
over_limittrue if storage, memory, or parse quota is at cap
memory_ops_this_monthMemory operations logged this UTC month
memory_storage_bytesKV JSON storage (bytes)
blob_embed_storage_bytesBytes used by parsed document chunk embeddings
combined_memory_storage_bytesmemory_storage_bytes + blob_embed_storage_bytes
search_calls_this_monthWeb-discovery calls this UTC month
browse_calls_this_monthBrowse calls this UTC month (paid packs only)
parse_ops_this_month / parse_ops_lifetimeParse usage

​
Buy a credit pack

POST /v1/billing/packs/checkout
Authorization: Bearer ltx_your_key
Content-Type: application/json

{
  "pack": "sprint"
}
pack must be one of: sprint (25),‘mission‘(25), `mission` (50), deploy ($100). Returns a Stripe Checkout URL — open it to complete payment. On success, credits are granted immediately via webhook and pack expiry is set to 90 days from grant (UTC).
PackPriceCreditsBrowse
Spark (trial)$5 on register, no card~1,000 searchesNot included
Sprint$25 one-off~5,000 searches or browse callsIncluded
Mission$50 one-off~10,000 searches or browse callsIncluded
Deploy$100 one-off~20,000 searches or browse callsIncluded
Per-call rates: Search 0.005∗∗,Browse∗∗0.005**, Browse **0.005.

​
Auto top-up

Set a threshold and saved payment method — Lithtrix refills automatically when your balance drops below it. 
POST /v1/billing/auto-topup
Authorization: Bearer ltx_your_key
Content-Type: application/json

{
  "enabled": true,
  "threshold_usd": "5.00",
  "pack": "sprint",
  "payment_method_id": "pm_..."
}

​
Webhook

POST /v1/billing/webhook — Stripe-signed events. Configure STRIPE_WEBHOOK_SECRET on the host.

​
Environment (ops)

  • STRIPE_PRICE_PACK_SPRINT — Stripe Price ID for Sprint
  • STRIPE_PRICE_PACK_MISSION — Stripe Price ID for Mission
  • STRIPE_PRICE_PACK_DEPLOY — Stripe Price ID for Deploy
  • STRIPE_SECRET_KEY, STRIPE_PUBLISHABLE_KEY, STRIPE_WEBHOOK_SECRET
See also GET /v1/capabilities for the pricing block and per-call rates.