{"openapi":"3.1.0","info":{"title":"Falcon Docs","version":"1.0.0","description":"Bank statement extraction for agents: transactions and underwriting metrics from bank-statement PDFs, plus invoice/receipt/W-9 extraction. Paid per call with x402.","contact":{"name":"falcon.sol","email":"falconsol@mail.grokbot.com"}},"servers":[{"url":"https://falcondocs.vercel.app"}],"paths":{"/v1/preview":{"post":{"operationId":"previewDocument","summary":"Free page-1 extraction","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv","xlsx"]}},{"name":"type","in":"query","schema":{"type":"string","enum":["auto","invoice","receipt","purchase_order","w9","bank_statement","generic"]}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"type":{"type":"string"},"format":{"type":"string","enum":["json","csv","xlsx"]}},"required":["file"]}},"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/Input"}}}},"responses":{"200":{"description":"Extraction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}},"text/csv":{},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402 v2)"},"422":{"description":"Could not extract (not charged)"}}}},"/v1/extract":{"post":{"operationId":"extractDocument","summary":"Full extraction ($0.03, x402)","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv","xlsx"]}},{"name":"type","in":"query","schema":{"type":"string","enum":["auto","invoice","receipt","purchase_order","w9","bank_statement","generic"]}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"type":{"type":"string"},"format":{"type":"string","enum":["json","csv","xlsx"]}},"required":["file"]}},"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/Input"}}}},"responses":{"200":{"description":"Extraction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}},"text/csv":{},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402 v2)"},"422":{"description":"Could not extract (not charged)"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]}}},"/v1/bank-statement":{"post":{"operationId":"spreadBankStatement","summary":"Bank statement spreading + underwriting metrics ($0.40, x402)","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv","xlsx"]}},{"name":"type","in":"query","schema":{"type":"string","enum":["auto","invoice","receipt","purchase_order","w9","bank_statement","generic"]}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"type":{"type":"string"},"format":{"type":"string","enum":["json","csv","xlsx"]}},"required":["file"]}},"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/Input"}}}},"responses":{"200":{"description":"Extraction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}},"text/csv":{},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{}}},"400":{"description":"Invalid input (not charged)"},"402":{"description":"Payment required (x402 v2)"},"422":{"description":"Could not extract (not charged)"}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.400000"},"protocols":[{"x402":{}}]}}},"/accuracy":{"get":{"operationId":"accuracy","summary":"Published accuracy results","responses":{"200":{"description":"JSON"}}}}},"components":{"schemas":{"Input":{"type":"object","properties":{"url":{"type":"string"},"file_base64":{"type":"string"},"type":{"type":"string"},"format":{"type":"string"}}},"Field":{"type":"object","properties":{"value":{},"confidence":{"type":"number"},"source":{"type":"string"}}},"Result":{"type":"object","properties":{"document_type":{"type":"string"},"classification_confidence":{"type":"number"},"method":{"type":"string","enum":["text_layer","vision"]},"pages":{"type":"integer"},"fields":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Field"}},"line_items":{"type":"array","items":{"type":"object"}},"transactions":{"type":"array","items":{"type":"object"}},"metrics":{"type":"object"},"disclaimer":{"type":"string"}},"required":["document_type","fields"]}}}}