{"openapi":"3.1.0","info":{"title":"The JQ API","version":"2.5.0","description":"Hosted jq 1.8.2 REST API and stateless MCP server on Cloudflare Workers. Free: 100 calls/IP/day or 1,000/UUID/day, shared across REST/MCP/uploads. Optional 0.005 USDC per-query payment or 2 USDC / 30-day unlimited private pass; no automatic renewal. Document and execution limits apply. Discovery and metadata reads do not consume quota.","contact":{"name":"Craftsman Founder LLC","email":"contact@thejqapi.com","url":"https://thejqapi.com/privacy"}},"servers":[{"url":"https://thejqapi.com"}],"externalDocs":{"description":"Human-readable API reference","url":"https://thejqapi.com/api"},"x-mcp":{"url":"https://thejqapi.com/mcp","transport":"streamable-http","server_card":"https://thejqapi.com/mcp/server-card"},"paths":{"/process":{"post":{"operationId":"process_json","summary":"Apply a jq filter to inline JSON, a public HTTPS URL, or a reusable upload","security":[{},{"uuid":[]}],"parameters":[{"name":"X-JQ-Privacy","in":"header","required":false,"description":"Set required to forbid tracked free access for an unpaid or mistyped key. Previously paid UUIDs already fail closed after expiry.","schema":{"type":"string","enum":["required"]}},{"name":"X-JQ-Payment","in":"header","required":false,"description":"Choose pass for 2 USDC / 30 days, or query for 0.005 USDC per execution attempt. Query mode requires a fresh Idempotency-Key UUID per logical query. Payment occurs before execution; runtime/URL errors are chargeable. Active passes never incur another charge.","schema":{"type":"string","enum":["pass","query"]}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Required in query payment mode. A fresh UUID for each logical query; keep it on signed and identical delivery retries. Changed requests return 409. Includes at most three delivery attempts within 15 minutes of settlement; results are re-executed, never cached.","schema":{"type":"string","format":"uuid"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"Base64 x402 v2 PaymentPayload from an authorized wallet client. Never put signatures or wallet keys in the body.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JqRequest"},"example":{"input":{"name":"Alice"},"filter":".name"}}}},"responses":{"200":{"description":"jq results; no application payload logs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JqResponse"}}},"headers":{"X-JQ-Purchase-Id":{"schema":{"type":"string","format":"uuid"},"description":"Per-query receipt ID, also the idempotency key"},"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"Base64 x402 settlement receipt when payment was supplied"},"X-JQ-Privacy":{"schema":{"enum":["zero_application_query_logs","no_payload_logs_with_payment_receipts"]},"description":"Pass privacy or per-query billing privacy; per-query retains receipts and temporary retry metadata"}}},"202":{"description":"Settlement pending; no execution. Check purchase_id without another payment, then retry the original identical request/key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"400":{"description":"Invalid input, jq filter, or payment request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A secret UUID bearer token is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Explicit x402 challenge: 5000 atomic USDC for query mode or 2000000 for the 30-day pass. No query has run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64 x402 v2 requirements; sign only under an authorized 0.005-USDC query or 2-USDC pass spending policy matching the selected mode"}}},"403":{"description":"Required private access is inactive or expired; no free-tier tracking","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Upload is missing or deleted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Idempotency key conflicts with another request, or delivery attempts are exhausted; no additional charge","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Upload or paid query delivery window expired","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Document exceeds 5 MiB or request exceeds its bounded size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported content type or invalid JSON document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Free daily quota exhausted; includes reset time and paid upgrade instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaExceeded"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until the next UTC reset"},"Link":{"schema":{"type":"string"},"description":"Pricing and browser checkout links, rel=payment"}}},"502":{"description":"URL fetch failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"URL fetch timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/uploads":{"post":{"operationId":"upload_json","summary":"Store one JSON document privately for 15 minutes","description":"Send a raw JSON document or a multipart file field named file. This is explicit temporary R2 storage, including for paid users. Access expires after 900 seconds; delayed physical cleanup cannot extend access. Upload creation consumes a free quota call; active passes bypass counters.","security":[{},{"uuid":[]}],"parameters":[{"name":"X-JQ-Privacy","in":"header","required":false,"description":"Set required to forbid tracked free access for an unpaid or mistyped key. Previously paid UUIDs already fail closed after expiry.","schema":{"type":"string","enum":["required"]}},{"name":"X-JQ-Payment","in":"header","required":false,"description":"Explicitly choose the 2-USDC / 30-day pass. An inactive UUID receives an x402 402 challenge on this request; a signed retry activates access before processing. This is not a per-call fee. Active passes are never charged again.","schema":{"type":"string","enum":["pass"]}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"Base64 x402 v2 PaymentPayload from an authorized wallet client. Never put signatures or wallet keys in the body.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{},"example":{"items":[1,2,3]}},"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary","description":"JSON file, at most 5 MiB"}}}}}},"responses":{"201":{"description":"Secret reusable upload ID, expiry, and byte size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Upload"}}}},"202":{"description":"Pass settlement is pending; query has not run. Check the purchase status without paying again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"400":{"description":"Invalid input, jq filter, or payment request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A secret UUID bearer token is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Explicit pass upgrade: x402 v2 challenge for 2 USDC / 30 days","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64 x402 v2 requirements; sign only with an authorized 2-USDC spending policy"}}},"403":{"description":"Required private access is inactive or expired; no free-tier tracking","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Document exceeds 5 MiB or request exceeds its bounded size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported content type or invalid JSON document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Free daily quota exhausted; includes reset time and paid upgrade instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaExceeded"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until the next UTC reset"},"Link":{"schema":{"type":"string"},"description":"Pricing and browser checkout links, rel=payment"}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/uploads/from-url":{"post":{"operationId":"upload_json_from_url","summary":"Fetch a public HTTPS JSON document and store it for 15 minutes","security":[{},{"uuid":[]}],"parameters":[{"name":"X-JQ-Privacy","in":"header","required":false,"description":"Set required to forbid tracked free access for an unpaid or mistyped key. Previously paid UUIDs already fail closed after expiry.","schema":{"type":"string","enum":["required"]}},{"name":"X-JQ-Payment","in":"header","required":false,"description":"Explicitly choose the 2-USDC / 30-day pass. An inactive UUID receives an x402 402 challenge on this request; a signed retry activates access before processing. This is not a per-call fee. Active passes are never charged again.","schema":{"type":"string","enum":["pass"]}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"Base64 x402 v2 PaymentPayload from an authorized wallet client. Never put signatures or wallet keys in the body.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Public HTTPS on port 443; no caller credentials, private networks, or custom headers. Three redirects and ten seconds maximum."}}}}}},"responses":{"201":{"description":"Reusable upload capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Upload"}}}},"202":{"description":"Pass settlement is pending; query has not run. Check the purchase status without paying again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"400":{"description":"Invalid input, jq filter, or payment request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A secret UUID bearer token is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Explicit pass upgrade: x402 v2 challenge for 2 USDC / 30 days","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64 x402 v2 requirements; sign only with an authorized 2-USDC spending policy"}}},"403":{"description":"Required private access is inactive or expired; no free-tier tracking","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Document exceeds 5 MiB or request exceeds its bounded size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported content type or invalid JSON document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Free daily quota exhausted; includes reset time and paid upgrade instructions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaExceeded"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until the next UTC reset"},"Link":{"schema":{"type":"string"},"description":"Pricing and browser checkout links, rel=payment"}}},"502":{"description":"URL fetch failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"URL fetch timed out","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/uploads/{upload_id}":{"get":{"operationId":"get_upload","summary":"Inspect availability, expiry, and size without reading JSON or consuming quota","security":[],"parameters":[{"name":"upload_id","in":"path","required":true,"description":"Secret upload capability, not a filename. Anyone holding it can read or delete this document.","schema":{"type":"string","pattern":"^\\d{13}-[0-9a-f]{64}$"}}],"responses":{"200":{"description":"Metadata; missing/expired documents return available=false","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadMetadata"}}}},"400":{"description":"Invalid input, jq filter, or payment request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"delete_upload","summary":"Delete one upload early; retries are safe and do not consume quota","security":[],"parameters":[{"name":"upload_id","in":"path","required":true,"description":"Secret upload capability, not a filename. Anyone holding it can read or delete this document.","schema":{"type":"string","pattern":"^\\d{13}-[0-9a-f]{64}$"}}],"responses":{"200":{"description":"Deletion confirmed, including already deleted or expired uploads","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"deleted":{"const":true}}}}}},"400":{"description":"Invalid input, jq filter, or payment request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quota":{"get":{"operationId":"get_quota","summary":"Read remaining free quota or active paid access without consuming calls","security":[{},{"uuid":[]}],"parameters":[{"name":"X-JQ-Privacy","in":"header","required":false,"description":"Set required to forbid tracked free access for an unpaid or mistyped key. Previously paid UUIDs already fail closed after expiry.","schema":{"type":"string","enum":["required"]}}],"responses":{"200":{"description":"Paid usage fields are null because paid query counts are not collected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quota"}}}},"403":{"description":"Required private access is inactive or expired; no free-tier tracking","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/pricing":{"get":{"operationId":"get_pricing","summary":"Read live price, availability, payment network, and privacy boundaries","security":[],"responses":{"200":{"description":"Current non-recurring plan and whether payments are available","content":{"application/json":{"schema":{"type":"object","required":["available","price","auto_renew"],"properties":{"available":{"type":"boolean"},"plan":{"const":"unlimited_30d"},"price":{"type":"object","properties":{"amount":{"const":"2.00"},"amount_atomic":{"const":"2000000"},"currency":{"const":"USDC"},"network":{"const":"eip155:8453"},"asset":{"type":"string"},"pay_to":{"type":["string","null"]}}},"per_query":{"type":"object","properties":{"available":{"type":"boolean"},"amount":{"const":"0.005"},"amount_atomic":{"const":"5000"},"currency":{"const":"USDC"},"network":{"const":"eip155:8453"},"rest_endpoint":{"type":"string","format":"uri"},"mcp_tool":{"const":"process_json"},"charged_before_processing":{"const":true},"processing_errors_are_chargeable":{"const":true},"retry_window_seconds":{"const":900},"max_delivery_attempts":{"const":3},"privacy":{"const":"no_payload_logs_with_payment_receipts"},"billing_records":{"type":"string"},"active_passes_charged":{"const":false}}},"auto_renew":{"const":false},"duration_seconds":{"const":2592000},"setup_url":{"type":"string","format":"uri"},"disclosures":{"type":"array","items":{"type":"string"}}}}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/access/status":{"get":{"operationId":"get_access","summary":"Check a UUID’s access, expiry, and privacy lock even after expiry; no quota writes","security":[{"uuid":[]}],"responses":{"200":{"description":"Access status without query history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Access"}}}},"401":{"description":"A secret UUID bearer token is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/access/purchases":{"post":{"operationId":"purchase_access","summary":"Create or resume a non-recurring 2-USDC, 30-day pass purchase","description":"Save a secret UUID first. An active pass returns access without a new charge. Open purchases coalesce across REST/MCP. Check pending orders instead of sending a second payment. Ordinary MCP clients can use a paid UUID without wallet support.","security":[{"uuid":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"purchase_id":{"type":"string","format":"uuid","description":"Resume a known order belonging to this UUID"}}}}}},"responses":{"200":{"description":"Existing purchase or active access","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Purchase"},{"$ref":"#/components/schemas/Access"}]}}}},"201":{"description":"New purchase and checkout_url","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"400":{"description":"Invalid input, jq filter, or payment request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A secret UUID bearer token is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/access/purchases/{purchase_id}":{"get":{"operationId":"get_purchase","summary":"Recover purchase and settlement status without making another payment","security":[{"uuid":[]}],"parameters":[{"name":"purchase_id","in":"path","required":true,"description":"Purchase identifier, bound to the bearer UUID.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Receipt, expiry, or pending status; never query contents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"401":{"description":"A secret UUID bearer token is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No purchase for this UUID","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/access/purchases/{purchase_id}/pay":{"post":{"operationId":"pay_purchase","summary":"Receive or satisfy an x402 v2 challenge for a 30-day pass","description":"Native USDC on Base. Sign only under an explicit 2-USDC spending policy. One EIP-3009 authorization, no allowance or automatic renewal. PAYMENT-REQUIRED and PAYMENT-RESPONSE are base64 JSON. Retry the same order after uncertain settlement; never create another payment while pending.","security":[{"uuid":[]}],"parameters":[{"name":"purchase_id","in":"path","required":true,"description":"Purchase identifier, bound to the bearer UUID.","schema":{"type":"string","format":"uuid"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"Base64 x402 v2 PaymentPayload from an authorized wallet client. Never put signatures or wallet keys in the body.","schema":{"type":"string"}}],"responses":{"200":{"description":"Settled receipt or existing active access","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/Purchase"},{"$ref":"#/components/schemas/Access"}]}}},"headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"Base64 x402 settlement receipt"}}},"202":{"description":"Settlement pending: check GET purchase status; do not pay again","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Purchase"}}}},"400":{"description":"Invalid input, jq filter, or payment request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"A secret UUID bearer token is required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"x402 payment required; body matches decoded PAYMENT-REQUIRED","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"Base64 x402 v2 payment requirements"}}},"409":{"description":"Expired quote or mismatched/already-bound authorization","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Storage, billing verification, or payment acceptance is unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/health":{"get":{"operationId":"get_health","summary":"Check endpoint health without using query quota","security":[],"responses":{"200":{"description":"Endpoint health","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"const":"healthy"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/engine.json":{"get":{"operationId":"get_engine","summary":"Read the jq engine version, supported options, and document/upload limits","security":[],"responses":{"200":{"description":"Live engine capabilities","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/status.json":{"get":{"operationId":"get_status","summary":"Read public synthetic monitor results; no customer query data","security":[],"responses":{"200":{"description":"Public monitor evidence","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"securitySchemes":{"uuid":{"type":"http","scheme":"bearer","bearerFormat":"UUID","description":"A caller-generated secret UUID selects free UUID quota or its paid pass. It is not OAuth or a wallet private key. Keep it out of URLs, Git, and tool arguments."}},"schemas":{"JqRequest":{"type":"object","required":["filter"],"properties":{"input":{"description":"Any JSON value, including null. Raw/text stream modes require a string."},"url":{"type":"string","maxLength":4096,"description":"Public HTTPS input, at most 5 MiB, three redirects, ten seconds; caller credentials are never forwarded."},"upload_id":{"type":"string","pattern":"^\\d{13}-[0-9a-f]{64}$"},"filter":{"type":"string","minLength":1,"description":"jq expression, e.g. .name or .items | length; . reads the whole document."},"options":{"$ref":"#/components/schemas/JqOptions"}},"oneOf":[{"required":["input"],"not":{"anyOf":[{"required":["url"]},{"required":["upload_id"]}]}},{"required":["url"],"not":{"anyOf":[{"required":["input"]},{"required":["upload_id"]}]}},{"required":["upload_id"],"not":{"anyOf":[{"required":["input"]},{"required":["url"]}]}}],"description":"Exactly one input source. raw_input and input_stream are mutually exclusive. No shell or local filesystem access."},"JqOptions":{"type":"object","properties":{"slurp":{"type":"boolean","description":"Collect all input values into an array (-s)"},"null_input":{"type":"boolean","description":"Run once with null (-n); a source is still required"},"raw_input":{"type":"boolean","description":"Read inline or fetched text as lines (-R)"},"input_stream":{"type":"boolean","description":"Parse a string as a sequence of JSON texts"},"args":{"type":"object","additionalProperties":{"type":"string"},"description":"Named string variables (--arg)"},"argjson":{"type":"object","additionalProperties":{},"description":"Named JSON variables (--argjson); overrides args for duplicate names"},"modules":{"type":"object","additionalProperties":{"type":"string"},"description":"Relative .jq/.json filenames mapped to module source, only in memory for this request; no traversal"},"raw_output":{"type":"boolean","description":"Raw strings in stdout (-r)"},"join_output":{"type":"boolean","description":"Raw stdout without separating newlines (-j)"},"compact_output":{"type":"boolean","description":"Compact JSON stdout (-c)"},"sort_keys":{"type":"boolean","description":"Sort object keys in stdout (-S)"},"ascii_output":{"type":"boolean","description":"ASCII escaped stdout (-a)"}}},"JqResponse":{"type":"object","required":["success"],"properties":{"success":{"type":"boolean"},"result":{},"results":{"type":"array","items":{}},"rawResult":{"type":"string"},"stdout":{"type":"string"},"stderr":{"type":"string"},"jqVersion":{"type":"string"},"executionTime":{"type":"number","description":"Processing time in milliseconds"},"error":{"type":"string"},"status":{"type":"integer"}}},"Error":{"type":"object","properties":{"success":{"const":false},"error":{"type":"string"},"status":{"type":"integer"}}},"QuotaExceeded":{"type":"object","required":["error","upgrade","reset_at"],"properties":{"error":{"const":"Rate limit exceeded"},"limit":{"type":"integer"},"remaining":{"const":0},"reset_at":{"type":"string","format":"date-time"},"upgrade":{"type":"object","example":{"pricing_url":"https://thejqapi.com/pricing","setup_url":"https://thejqapi.com/access","purchase_url":"https://thejqapi.com/access/purchases","mcp_tool":"purchase_access","same_request_upgrade":{"headers":{"X-JQ-Payment":"pass"},"payment_required_status":402,"description":"With a secret UUID bearer token and an authorized 2-USDC spending policy, retry this REST endpoint with X-JQ-Payment: pass. The first request returns an x402 challenge; the signed retry buys the 30-day pass and runs the original request. This is a pass purchase, not a per-call fee."},"per_query":{"endpoint":"https://thejqapi.com/process","mcp_tool":"process_json","price":{"amount":"0.005","amount_atomic":"5000","currency":"USDC","network":"eip155:8453"},"headers":{"X-JQ-Payment":"query","Idempotency-Key":"A fresh UUID per logical query; reuse only for identical delivery retries"},"mcp_metadata":"com.thejqapi/payment: {mode:query, idempotency_key:UUID}","privacy":"no_payload_logs_with_payment_receipts","description":"Explicit x402 payment before execution. Runtime/input-fetch errors are chargeable. Three identical delivery attempts within 15 minutes; one receipt per logical query and temporary keyed retry data. Active passes are never charged. Upload creation is free-tier or pass only."},"plan":"unlimited_30d","price":{"amount":"2.00","currency":"USDC","network":"eip155:8453"},"duration_seconds":2592000,"auto_renew":false,"privacy":"zero_application_query_logs","instructions":"Generate and save a secret UUID, send it as Authorization: Bearer YOUR_UUID, then use browser checkout or purchase_access. Purchases require an explicit spending policy; never send a second payment for a pending order. GET /pricing reports current availability."}}}},"Quota":{"type":"object","properties":{"success":{"const":true},"tier":{"enum":["anonymous","uuid","paid"]},"limit":{"type":["integer","null"]},"used":{"type":["integer","null"]},"remaining":{"type":["integer","null"]},"reset_at":{"type":["string","null"],"format":"date-time"},"unlimited":{"type":"boolean"},"expires_at":{"type":"string","format":"date-time"},"privacy":{"const":"zero_application_query_logs"},"auto_renew":{"const":false}}},"Upload":{"type":"object","required":["success","upload_id","expires_at","size_bytes"],"properties":{"success":{"const":true},"upload_id":{"type":"string","pattern":"^\\d{13}-[0-9a-f]{64}$"},"expires_at":{"type":"string","format":"date-time"},"size_bytes":{"type":"integer","maximum":5242880}}},"UploadMetadata":{"type":"object","properties":{"success":{"const":true},"available":{"type":"boolean"},"status":{"enum":["available","missing","expired"]},"expires_at":{"type":["string","null"],"format":"date-time"},"expires_in_seconds":{"type":["integer","null"]},"size_bytes":{"type":["integer","null"]}}},"Access":{"type":"object","required":["success","active","expires_at","privacy_required","auto_renew"],"properties":{"success":{"const":true},"active":{"type":"boolean"},"expires_at":{"type":["string","null"],"format":"date-time"},"privacy":{"enum":["zero_application_query_logs",null]},"privacy_required":{"type":"boolean"},"auto_renew":{"const":false}}},"Purchase":{"type":"object","properties":{"success":{"const":true},"purchase_id":{"type":"string","format":"uuid"},"kind":{"enum":["pass","query"]},"usable":{"type":"boolean"},"retry_until":{"type":["string","null"],"format":"date-time"},"remaining_delivery_attempts":{"type":"integer","minimum":0,"maximum":3},"status":{"enum":["created","verifying","settling","pending","settled","failed","cancelled"]},"active":{"type":"boolean"},"expires_at":{"type":["string","null"],"format":"date-time"},"auto_renew":{"const":false},"checkout_url":{"type":"string","format":"uri"},"transaction":{"type":"string"},"retry_after_seconds":{"type":"integer"},"message":{"type":"string"},"price":{"type":"object"}}},"PaymentRequired":{"type":"object","required":["x402Version","resource","accepts"],"properties":{"x402Version":{"const":2},"resource":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"const":"application/json"}}},"accepts":{"type":"array","minItems":1,"items":{"type":"object","required":["scheme","network","amount","asset","payTo"],"properties":{"scheme":{"const":"exact"},"network":{"const":"eip155:8453"},"amount":{"enum":["5000","2000000"]},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object"}}}},"extensions":{"type":"object"}}}}}}