{"openapi":"3.1.0","info":{"title":"filings.legal","version":"0.1.0","summary":"One agent-native endpoint for every government filing, priced on the receipt. The pro-se provisional patent filing is open and receipt-metered; reserved filings route to independent licensed professionals who sign under their own credential.","description":"One agent-native endpoint for every government filing, priced on the receipt. Reads are keyless and typed (OK | EMPTY | BLOCKED). The one open act — the pro-se provisional patent filing — mints a real Matter on the api.lawyer substrate and returns a receipt-metered ACCEPTED. Reserved filings return a typed PENDING_SIGNER and are never sold: an agent is never routed to sign."},"servers":[{"url":"https://filings.legal"}],"paths":{"/filings":{"get":{"operationId":"listFilings","summary":"List filings — keyless, typed, branching on its query","description":"Plain GET answers 200 OK with your filings (live off the substrate). ?agency= or ?status= narrow the list and answer 200 EMPTY when nothing matches. ?scope=admin or ?scope=internal answer 403 BLOCKED — those scopes are reserved to the platform.","parameters":[{"name":"agency","in":"query","required":false,"schema":{"type":"string"},"description":"narrow by agency — a value matching nothing answers a typed EMPTY"},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"description":"narrow by filing status — a value matching nothing answers a typed EMPTY"},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["admin","internal"]},"description":"platform-reserved scopes — always answered 403 BLOCKED"}],"responses":{"200":{"description":"OK (results) or EMPTY (truthful empty set) envelope","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/FilingsOk"},{"$ref":"#/components/schemas/Empty"}]}}}},"403":{"description":"BLOCKED — the requested scope is reserved to the platform","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Blocked"}}}}}}},"/filings/{id}":{"get":{"operationId":"getFiling","summary":"One filing — stage, registry serial, and Meter state","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"the filing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingEnvelope"}}}},"404":{"description":"no such filing"},"502":{"description":"the api.lawyer substrate refused the call"}}}},"/file/provisional":{"post":{"operationId":"fileProvisional","summary":"File a pro-se provisional patent — the open act","description":"$199 flat, receipt-metered; government fees pass through at cost. Mints a real patent-rail Matter on the substrate and returns a typed ACCEPTED with the Meter unreleased — no filing, no charge.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileProvisional"}}}},"responses":{"202":{"description":"ACCEPTED — the filing is tracked; the Meter is unreleased until the receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"400":{"description":"the filing body is malformed (needs title and inventor)"},"502":{"description":"the api.lawyer substrate refused the call; nothing was minted or charged"}}}},"/file/{reserved}":{"post":{"operationId":"fileReserved","summary":"A reserved filing — described, never sold","description":"utility | patent-oa | trademark-oa. Returns a typed PENDING_SIGNER with the required credential, a sovereign refusal, and NO ship date. No substrate write happens; an agent is never routed to sign.","parameters":[{"name":"reserved","in":"path","required":true,"schema":{"type":"string","enum":["utility","patent-oa","trademark-oa"]}}],"responses":{"202":{"description":"PENDING_SIGNER — routed to an independent licensed professional","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingSigner"}}}},"404":{"description":"no such reserved filing act"}}}},"/pricing":{"get":{"operationId":"getPricing","summary":"The AXP Pricing Document","description":"Answers 200 with the closed pricing model (AXP Appendix A.2). Preview build declares \"free\": keyless reads; the receipt-released meter arrives with real billing.","responses":{"200":{"description":"the Pricing Document","content":{"application/json":{"schema":{"type":"object","required":["model"],"properties":{"model":{"type":"string","enum":["free","metered"]}}}}}}}}},"/healthz":{"get":{"operationId":"getHealth","summary":"Liveness — typed OK","responses":{"200":{"description":"service is up","content":{"application/json":{"schema":{"type":"object","required":["type","ok","service"],"properties":{"type":{"const":"OK"},"ok":{"type":"boolean"},"service":{"type":"string"}}}}}}}}}},"components":{"schemas":{"FilingSummary":{"type":"object","required":["id","filing","status","meter"],"properties":{"id":{"type":"string"},"filing":{"type":"string"},"status":{"type":"string"},"title":{"type":"string"},"assetId":{"type":["string","null"]},"serial":{"type":["string","null"]},"meter":{"type":"object","required":["predicate","released","amountUsd"],"properties":{"predicate":{"type":"string","const":"uspto.receipt"},"released":{"type":"boolean"},"amountUsd":{"type":"number"}}}}},"FilingsOk":{"type":"object","required":["type","results"],"properties":{"type":{"const":"OK"},"results":{"type":"array","items":{"$ref":"#/components/schemas/FilingSummary"}}}},"Empty":{"type":"object","required":["type","results"],"properties":{"type":{"const":"EMPTY"},"results":{"type":"array","maxItems":0},"message":{"type":"string"}}},"Blocked":{"type":"object","required":["type","reason"],"properties":{"type":{"const":"BLOCKED"},"reason":{"type":"string"}}},"FilingEnvelope":{"type":"object","required":["type","filing"],"properties":{"type":{"const":"OK"},"filing":{"$ref":"#/components/schemas/FilingSummary"}}},"FileProvisional":{"type":"object","required":["title","inventor"],"properties":{"title":{"type":"string","description":"the invention title — becomes the Asset title"},"inventor":{"type":"string","description":"the applicant of record"},"applicantState":{"type":"string","description":"optional; vacuous for federal patent scope"}}},"Accepted":{"type":"object","required":["type","verb","filing","trackingId","meter"],"properties":{"type":{"const":"ACCEPTED"},"verb":{"const":"file"},"filing":{"const":"patent.provisional"},"trackingId":{"type":"string"},"assetId":{"type":"string"},"meter":{"$ref":"#/components/schemas/Meter"},"eta":{"type":"string"}}},"PendingSigner":{"type":"object","required":["type","filing","gate","shipDate"],"properties":{"type":{"const":"PENDING_SIGNER"},"filing":{"type":"string"},"reserved":{"const":true},"gate":{"type":"object","properties":{"requiresSigner":{"type":"string","enum":["uspto-registration","state-bar"]}}},"refusal":{"type":"string"},"shipDate":{"type":"null"}}},"Meter":{"type":"object","required":["predicate","released","amountUsd"],"properties":{"predicate":{"const":"uspto.receipt"},"released":{"type":"boolean"},"amountUsd":{"type":"number"}}}}}}