{"openapi":"3.1.0","info":{"title":"Public Records, Crime & Regulatory Intelligence API","version":"1.0.0","description":"Normalize court and enforcement records, compare public crime statistics, cluster incidents, extract police notices, and cross-reference subjects—while distinguishing allegations, charges, and judgments and never inferring guilt. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses the x402 protocol with exact USDC on Base (chain id 8453). Each POST operation has a fixed USD price.\nHow to call an operation:\n1. POST a JSON body matching the operation's requestBody schema to the operation path. Include an Idempotency-Key header (64 hex characters, 32 random bytes).\n2. If you have not paid, the server responds 402 with payment requirements in the body. Pay the exact amount to the payTo address on Base.\n3. Retry the identical request with the same Idempotency-Key and add a payment-signature header containing the x402 payment payload. On success (200) the operation result is returned.\n4. Reuse the same Idempotency-Key only for retries of the same operation and request body; it will not be charged twice.\nAll outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Verify time-sensitive or official data with the cited source before acting."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/public-records/court-decision-search-normalize":{"post":{"operationId":"normalize_court_decision_records","summary":"Normalize court decision records","description":"Normalize supplied court records and label allegation, investigation, charge, and judgment statuses separately. Guilt is never inferred.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"courtRecords":[{"id":"CRT-1","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","parties":["City","Example Co"],"businessName":"Example Co","date":"2026-01-10","status":"charge","disposition":"complaint filed","source":"Caller-supplied docket excerpt"},{"id":"CRT-2","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","parties":["City","Example Co"],"businessName":"Example Co","date":"2026-06-01","status":"judgment","disposition":"judgment entered","source":"Caller-supplied docket excerpt"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"recordCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"caseNumber":{"type":"string"},"court":{"type":"string"},"title":{"type":"string"},"parties":{"type":"array","items":{"type":"string"}},"businessName":{"type":"string"},"date":{"type":"string"},"disposition":{"type":"string"},"summary":{"type":"string"},"country":{"type":"string"},"jurisdiction":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"normalized","recordCount":2,"items":[{"id":"CRT-1","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","parties":["City","Example Co"],"businessName":"Example Co","date":"2026-01-10","disposition":"complaint filed","summary":"","country":"","jurisdiction":"","source":"Caller-supplied docket excerpt","sourceUrl":"","status":"charge","isAllegation":false,"isInvestigation":false,"isCharge":true,"isJudgment":false,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false},{"id":"CRT-2","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","parties":["City","Example Co"],"businessName":"Example Co","date":"2026-06-01","disposition":"judgment entered","summary":"","country":"","jurisdiction":"","source":"Caller-supplied docket excerpt","sourceUrl":"","status":"judgment","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":true,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"non_judgment","subject":"CRT-1","detail":"charge is not a final judgment. Guilt is not inferred."}],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/court-case-timeline-extract":{"post":{"operationId":"extract_court_case_timelines","summary":"Extract court case timelines","description":"Group supplied court records by case number into dated timelines. Non-judgment steps are not treated as guilt.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"courtRecords":[{"id":"CRT-1","caseNumber":"22-CV-100","court":"District Court","title":"Complaint","date":"2026-01-10","status":"charge","disposition":"complaint filed"},{"id":"CRT-2","caseNumber":"22-CV-100","court":"District Court","title":"Judgment","date":"2026-06-01","status":"judgment","disposition":"judgment entered"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"caseCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"caseKey":{"type":"string"},"caseNumber":{"type":"string"},"court":{"type":"string"},"eventCount":{"type":"number"},"hasJudgment":{"type":"boolean"},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"date":{"type":"string"},"title":{"type":"string"},"disposition":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"source":{"type":"string"},"sourceUrl":{"type":"string"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"extracted","caseCount":1,"items":[{"caseKey":"22-cv-100","caseNumber":"22-CV-100","court":"District Court","eventCount":2,"hasJudgment":true,"events":[{"id":"CRT-1","date":"2026-01-10","title":"Complaint","disposition":"complaint filed","status":"charge","isAllegation":false,"isInvestigation":false,"isCharge":true,"isJudgment":false,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"source":"","sourceUrl":""},{"id":"CRT-2","date":"2026-06-01","title":"Judgment","disposition":"judgment entered","status":"judgment","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":true,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"source":"","sourceUrl":""}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"non_judgment_step","subject":"CRT-1","detail":"Timeline includes charge, which is not treated as guilt."}],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/regulatory-enforcement-search":{"post":{"operationId":"search_regulatory_enforcement_actions","summary":"Search regulatory enforcement actions","description":"List supplied regulatory enforcement actions with explicit status labels. Investigations are not treated as guilt.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"businessName":"Example Co","enforcementActions":[{"id":"ENF-1","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"investigation opened","date":"2025-11-01","status":"investigation","source":"Caller-supplied notice"},{"id":"ENF-2","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"civil penalty","date":"2026-03-01","status":"penalty","penaltyAmount":25000,"currency":"USD","source":"Caller-supplied order"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"actionCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"authority":{"type":"string"},"subject":{"type":"string"},"businessName":{"type":"string"},"action":{"type":"string"},"date":{"type":"string"},"penaltyAmount":{"type":"number"},"penaltyAmountSupplied":{"type":"boolean"},"currency":{"type":"string"},"summary":{"type":"string"},"country":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"searched","actionCount":2,"items":[{"id":"ENF-1","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"investigation opened","date":"2025-11-01","penaltyAmount":0,"penaltyAmountSupplied":false,"currency":"","summary":"","country":"","source":"Caller-supplied notice","sourceUrl":"","status":"investigation","isAllegation":false,"isInvestigation":true,"isCharge":false,"isJudgment":false,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false},{"id":"ENF-2","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"civil penalty","date":"2026-03-01","penaltyAmount":25000,"penaltyAmountSupplied":true,"currency":"USD","summary":"","country":"","source":"Caller-supplied order","sourceUrl":"","status":"penalty","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":false,"isPenalty":true,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"non_final_enforcement","subject":"ENF-1","detail":"investigation is not a final judgment or admission of guilt."}],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/crime-statistics-compare":{"post":{"operationId":"compare_public_crime_statistics","summary":"Compare public crime statistics","description":"Compare supplied official crime counts or rates across periods for the same offense and area. Missing values are not invented.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"crimeStats":[{"id":"S-1","area":"Metro","country":"US","period":"2024","offense":"burglary","count":1200,"rate":3.1,"source":"Caller-supplied official stats"},{"id":"S-2","area":"Metro","country":"US","period":"2025","offense":"burglary","count":1100,"rate":2.8,"source":"Caller-supplied official stats"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"seriesCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"offense":{"type":"string"},"area":{"type":"string"},"country":{"type":"string"},"periodCount":{"type":"number"},"earliestPeriod":{"type":"string"},"latestPeriod":{"type":"string"},"countDelta":{"type":"number"},"countDeltaSupplied":{"type":"boolean"},"rateDelta":{"type":"number"},"rateDeltaSupplied":{"type":"boolean"},"points":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"period":{"type":"string"},"count":{"type":"number"},"countSupplied":{"type":"boolean"},"rate":{"type":"number"},"rateSupplied":{"type":"boolean"},"source":{"type":"string"},"sourceUrl":{"type":"string"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"compared","seriesCount":1,"items":[{"offense":"burglary","area":"Metro","country":"US","periodCount":2,"earliestPeriod":"2024","latestPeriod":"2025","countDelta":-100,"countDeltaSupplied":true,"rateDelta":-0.3,"rateDeltaSupplied":true,"points":[{"id":"S-1","period":"2024","count":1200,"countSupplied":true,"rate":3.1,"rateSupplied":true,"source":"Caller-supplied official stats","sourceUrl":""},{"id":"S-2","period":"2025","count":1100,"countSupplied":true,"rate":2.8,"rateSupplied":true,"source":"Caller-supplied official stats","sourceUrl":""}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/incident-cluster":{"post":{"operationId":"cluster_public_incidents","summary":"Cluster public incidents","description":"Cluster supplied public incidents by offense and area. Allegation or investigation labels are preserved and guilt is not inferred.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"incidents":[{"id":"INC-1","date":"2026-09-01","area":"Downtown","country":"US","offense":"theft","status":"allegation","summary":"Reported theft under investigation","source":"Caller-supplied blotter"},{"id":"INC-2","date":"2026-09-08","area":"Downtown","country":"US","offense":"theft","status":"allegation","summary":"Another reported theft","source":"Caller-supplied blotter"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"clusterCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"clusterKey":{"type":"string"},"offense":{"type":"string"},"area":{"type":"string"},"country":{"type":"string"},"incidentCount":{"type":"number"},"statuses":{"type":"array","items":{"type":"string"}},"dates":{"type":"array","items":{"type":"string"}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"date":{"type":"string"},"summary":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"clustered","clusterCount":1,"items":[{"clusterKey":"theft|downtown","offense":"theft","area":"Downtown","country":"US","incidentCount":2,"statuses":["allegation"],"dates":["2026-09-01","2026-09-08"],"items":[{"id":"INC-1","date":"2026-09-01","summary":"Reported theft under investigation","source":"Caller-supplied blotter","sourceUrl":"","status":"allegation","isAllegation":true,"isInvestigation":false,"isCharge":false,"isJudgment":false,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false},{"id":"INC-2","date":"2026-09-08","summary":"Another reported theft","source":"Caller-supplied blotter","sourceUrl":"","status":"allegation","isAllegation":true,"isInvestigation":false,"isCharge":false,"isJudgment":false,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"incident_non_judgment","subject":"INC-1","detail":"allegation incident is not a finding of guilt."},{"kind":"observation","code":"incident_non_judgment","subject":"INC-2","detail":"allegation incident is not a finding of guilt."}],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/police-notice-extract":{"post":{"operationId":"extract_police_public_notices","summary":"Extract police public notices","description":"Extract structured fields and wording signals from supplied police or public safety notices without inferring guilt.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"notices":[{"id":"NTC-1","agency":"City Police","title":"Public safety advisory","date":"2026-09-15","area":"River District","body":"Police issued an advisory about a suspected burglary pattern. No charges are stated in this notice.","status":"notice","source":"Caller-supplied bulletin"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"noticeCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"agency":{"type":"string"},"title":{"type":"string"},"date":{"type":"string"},"area":{"type":"string"},"country":{"type":"string"},"bodyPreview":{"type":"string"},"extracted":{"type":"object","properties":{"hasSuspectLanguage":{"type":"boolean"},"hasChargeLanguage":{"type":"boolean"},"hasArrestLanguage":{"type":"boolean"},"hasSafetyAdvisory":{"type":"boolean"}},"additionalProperties":true},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"extracted","noticeCount":1,"items":[{"id":"NTC-1","agency":"City Police","title":"Public safety advisory","date":"2026-09-15","area":"River District","country":"","bodyPreview":"Police issued an advisory about a suspected burglary pattern. No charges are stated in this notice.","extracted":{"hasSuspectLanguage":false,"hasChargeLanguage":true,"hasArrestLanguage":false,"hasSafetyAdvisory":true},"source":"Caller-supplied bulletin","sourceUrl":"","status":"notice","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":false,"isPenalty":false,"isNotice":true,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/business-litigation-history":{"post":{"operationId":"list_business_litigation_history","summary":"List business litigation history","description":"List supplied court records linked to a business name. Charges and allegations are not treated as convictions.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"businessName":"Example Co","courtRecords":[{"id":"CRT-1","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","businessName":"Example Co","parties":["City","Example Co"],"date":"2026-01-10","status":"charge","disposition":"complaint filed"},{"id":"CRT-2","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","businessName":"Example Co","parties":["City","Example Co"],"date":"2026-06-01","status":"judgment","disposition":"judgment entered"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"recordCount":{"type":"number"},"judgmentCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"caseNumber":{"type":"string"},"court":{"type":"string"},"title":{"type":"string"},"businessName":{"type":"string"},"parties":{"type":"array","items":{"type":"string"}},"date":{"type":"string"},"disposition":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"listed","recordCount":2,"judgmentCount":1,"items":[{"id":"CRT-1","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","businessName":"Example Co","parties":["City","Example Co"],"date":"2026-01-10","disposition":"complaint filed","source":"","sourceUrl":"","status":"charge","isAllegation":false,"isInvestigation":false,"isCharge":true,"isJudgment":false,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false},{"id":"CRT-2","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","businessName":"Example Co","parties":["City","Example Co"],"date":"2026-06-01","disposition":"judgment entered","source":"","sourceUrl":"","status":"judgment","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":true,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"litigation_non_judgment","subject":"CRT-1","detail":"charge court record is listed for history only and is not treated as guilt."}],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/regulatory-penalty-history":{"post":{"operationId":"list_regulatory_penalty_history","summary":"List regulatory penalty history","description":"List supplied penalty and fine actions with amounts when present. Missing amounts are not invented.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"businessName":"Example Co","enforcementActions":[{"id":"ENF-1","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"civil penalty","date":"2026-03-01","status":"penalty","penaltyAmount":25000,"currency":"USD"},{"id":"ENF-2","authority":"Regulator B","subject":"Example Co","businessName":"Example Co","action":"fine","date":"2025-08-12","status":"penalty","penaltyAmount":5000,"currency":"USD"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"penaltyCount":{"type":"number"},"totalPenaltyAmount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"authority":{"type":"string"},"subject":{"type":"string"},"businessName":{"type":"string"},"action":{"type":"string"},"date":{"type":"string"},"penaltyAmount":{"type":"number"},"penaltyAmountSupplied":{"type":"boolean"},"currency":{"type":"string"},"summary":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"listed","penaltyCount":2,"totalPenaltyAmount":30000,"items":[{"id":"ENF-1","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"civil penalty","date":"2026-03-01","penaltyAmount":25000,"penaltyAmountSupplied":true,"currency":"USD","summary":"","source":"","sourceUrl":"","status":"penalty","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":false,"isPenalty":true,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false},{"id":"ENF-2","authority":"Regulator B","subject":"Example Co","businessName":"Example Co","action":"fine","date":"2025-08-12","penaltyAmount":5000,"penaltyAmountSupplied":true,"currency":"USD","summary":"","source":"","sourceUrl":"","status":"penalty","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":false,"isPenalty":true,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/investigation-cross-reference":{"post":{"operationId":"cross_reference_public_investigations","summary":"Cross-reference public investigations","description":"Cross-reference subjects across court, enforcement, and notice records while preserving non-judgment statuses and never inferring guilt.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"businessName":"Example Co","courtRecords":[{"id":"CRT-1","caseNumber":"22-CV-100","title":"City v Example Co","businessName":"Example Co","parties":["Example Co"],"status":"charge","date":"2026-01-10"}],"enforcementActions":[{"id":"ENF-1","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"investigation opened","status":"investigation","date":"2025-11-01"}],"notices":[{"id":"NTC-1","agency":"City Police","title":"Notice mentioning Example Co","body":"Example Co is referenced in a public advisory. No judgment is stated.","status":"notice","date":"2026-02-01"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"subjectCount":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"subjectKey":{"type":"string"},"courtRecordCount":{"type":"number"},"enforcementCount":{"type":"number"},"noticeCount":{"type":"number"},"statuses":{"type":"array","items":{"type":"string"}},"courtRecordIds":{"type":"array","items":{"type":"string"}},"enforcementIds":{"type":"array","items":{"type":"string"}},"noticeIds":{"type":"array","items":{"type":"string"}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"cross_referenced","subjectCount":1,"items":[{"subjectKey":"example co","courtRecordCount":1,"enforcementCount":1,"noticeCount":1,"statuses":["charge","investigation","notice"],"courtRecordIds":["CRT-1"],"enforcementIds":["ENF-1"],"noticeIds":["NTC-1"],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"crossref_non_guilt","subject":"example co","detail":"Cross-referenced records include non-judgment statuses. Guilt is not inferred."}],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]}}},"/api/v1/public-records/evidence-report":{"post":{"operationId":"build_public_records_evidence_report","summary":"Build public records evidence report","description":"Aggregate court, enforcement, crime-stat, incident, notice, litigation, penalty, and cross-reference findings. Distinguishes allegations, charges, and judgments; never infers guilt.","tags":["public-records"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":200000},"json":{"type":"string","maxLength":200000},"csv":{"type":"string","maxLength":200000},"file":{"type":"object","properties":{"filename":{"type":"string","minLength":1,"maxLength":180},"mediaType":{"type":"string","enum":["text/plain","text/csv","application/json","application/xml","text/xml"]},"fileBase64":{"type":"string","minLength":1,"maxLength":12000000}},"required":["mediaType","fileBase64"],"additionalProperties":false},"courtRecords":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"caseNumber":{"type":"string","maxLength":120},"court":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"parties":{"maxItems":40,"type":"array","items":{"type":"string","maxLength":200}},"businessName":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"disposition":{"type":"string","maxLength":200},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"jurisdiction":{"type":"string","maxLength":160},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"enforcementActions":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"authority":{"type":"string","maxLength":200},"subject":{"type":"string","maxLength":200},"businessName":{"type":"string","maxLength":200},"action":{"type":"string","maxLength":200},"date":{"type":"string","maxLength":40},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"penaltyAmount":{"type":"number","minimum":0,"maximum":1000000000000},"currency":{"type":"string","maxLength":12},"summary":{"type":"string","maxLength":5000},"country":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"crimeStats":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"period":{"type":"string","maxLength":40},"offense":{"type":"string","maxLength":160},"count":{"type":"number","minimum":0,"maximum":1000000000},"rate":{"type":"number","minimum":0,"maximum":1000000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"incidents":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"offense":{"type":"string","maxLength":160},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"summary":{"type":"string","maxLength":2000},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"notices":{"maxItems":400,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"agency":{"type":"string","maxLength":200},"title":{"type":"string","maxLength":400},"date":{"type":"string","maxLength":40},"area":{"type":"string","maxLength":160},"country":{"type":"string","maxLength":80},"body":{"type":"string","maxLength":20000},"status":{"type":"string","enum":["allegation","investigation","charge","judgment","penalty","notice","statistic","unknown"]},"source":{"type":"string","maxLength":200},"sourceUrl":{"type":"string","maxLength":500}},"additionalProperties":false}},"feed":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"format":"uri"},"limit":{"type":"integer","minimum":1,"maximum":40}},"additionalProperties":false},"asOf":{"type":"string","maxLength":40},"businessName":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80}},"additionalProperties":false},"example":{"asOf":"2026-11-01","businessName":"Example Co","courtRecords":[{"id":"CRT-1","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","businessName":"Example Co","parties":["City","Example Co"],"date":"2026-01-10","status":"charge","disposition":"complaint filed","source":"Caller-supplied"},{"id":"CRT-2","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","businessName":"Example Co","parties":["City","Example Co"],"date":"2026-06-01","status":"judgment","disposition":"judgment entered","source":"Caller-supplied"}],"enforcementActions":[{"id":"ENF-1","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"civil penalty","date":"2026-03-01","status":"penalty","penaltyAmount":25000,"currency":"USD","source":"Caller-supplied"}],"crimeStats":[{"id":"S-1","area":"Metro","country":"US","period":"2024","offense":"burglary","count":1200,"rate":3.1,"source":"Caller-supplied"},{"id":"S-2","area":"Metro","country":"US","period":"2025","offense":"burglary","count":1100,"rate":2.8,"source":"Caller-supplied"}],"incidents":[{"id":"INC-1","date":"2026-09-01","area":"Downtown","offense":"theft","status":"allegation","summary":"Reported theft","source":"Caller-supplied"}],"notices":[{"id":"NTC-1","agency":"City Police","title":"Advisory","date":"2026-09-15","body":"Public advisory. No charges stated.","status":"notice","source":"Caller-supplied"}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. Conditional fields depend on the result and data-source availability.","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string"},"status":{"type":"string"},"asOf":{"type":"string"},"sections":{"type":"object","properties":{"court":{"type":"object","properties":{"recordCount":{"type":"number"}},"additionalProperties":true},"timelines":{"type":"object","properties":{"caseCount":{"type":"number"}},"additionalProperties":true},"enforcement":{"type":"object","properties":{"actionCount":{"type":"number"}},"additionalProperties":true},"crimeStats":{"type":"object","properties":{"seriesCount":{"type":"number"}},"additionalProperties":true},"incidents":{"type":"object","properties":{"clusterCount":{"type":"number"}},"additionalProperties":true},"notices":{"type":"object","properties":{"noticeCount":{"type":"number"}},"additionalProperties":true},"litigation":{"type":"object","properties":{"recordCount":{"type":"number"},"judgmentCount":{"type":"number"}},"additionalProperties":true},"penalties":{"type":"object","properties":{"penaltyCount":{"type":"number"},"totalPenaltyAmount":{"type":"number"}},"additionalProperties":true},"crossReference":{"type":"object","properties":{"subjectCount":{"type":"number"}},"additionalProperties":true}},"additionalProperties":true},"distinction":{"type":"object","properties":{"allegation":{"type":"string"},"investigation":{"type":"string"},"charge":{"type":"string"},"judgment":{"type":"string"},"penalty":{"type":"string"}},"additionalProperties":true},"court":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"caseNumber":{"type":"string"},"court":{"type":"string"},"title":{"type":"string"},"parties":{"type":"array","items":{"type":"string"}},"businessName":{"type":"string"},"date":{"type":"string"},"disposition":{"type":"string"},"summary":{"type":"string"},"country":{"type":"string"},"jurisdiction":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"enforcement":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"authority":{"type":"string"},"subject":{"type":"string"},"businessName":{"type":"string"},"action":{"type":"string"},"date":{"type":"string"},"penaltyAmount":{"type":"number"},"penaltyAmountSupplied":{"type":"boolean"},"currency":{"type":"string"},"summary":{"type":"string"},"country":{"type":"string"},"source":{"type":"string"},"sourceUrl":{"type":"string"},"status":{"type":"string"},"isAllegation":{"type":"boolean"},"isInvestigation":{"type":"boolean"},"isCharge":{"type":"boolean"},"isJudgment":{"type":"boolean"},"isPenalty":{"type":"boolean"},"isNotice":{"type":"boolean"},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"crossReference":{"type":"array","items":{"type":"object","properties":{"subjectKey":{"type":"string"},"courtRecordCount":{"type":"number"},"enforcementCount":{"type":"number"},"noticeCount":{"type":"number"},"statuses":{"type":"array","items":{"type":"string"}},"courtRecordIds":{"type":"array","items":{"type":"string"}},"enforcementIds":{"type":"array","items":{"type":"string"}},"noticeIds":{"type":"array","items":{}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"}},"additionalProperties":true}},"guiltInferred":{"type":"boolean"},"allegationTreatedAsJudgment":{"type":"boolean"},"chargeTreatedAsConviction":{"type":"boolean"},"investigationTreatedAsGuilt":{"type":"boolean"},"paidProviderUsed":{"type":"boolean"},"apiKeyRequired":{"type":"boolean"},"publicSources":{"type":"array","items":{}},"findings":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string"},"code":{"type":"string"},"subject":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"checkedAt":"2026-11-04T21:00:00.000Z","status":"reported","asOf":"2026-11-01","sections":{"court":{"recordCount":2},"timelines":{"caseCount":1},"enforcement":{"actionCount":1},"crimeStats":{"seriesCount":1},"incidents":{"clusterCount":1},"notices":{"noticeCount":1},"litigation":{"recordCount":2,"judgmentCount":1},"penalties":{"penaltyCount":1,"totalPenaltyAmount":25000},"crossReference":{"subjectCount":1}},"distinction":{"allegation":"An assertion not established as a final judgment.","investigation":"An inquiry or probe. Not a finding of guilt.","charge":"A formal accusation. Not a conviction.","judgment":"A final court disposition as labeled in the supplied record.","penalty":"A regulatory or civil penalty amount/action as labeled; not criminal guilt unless the record status is judgment."},"court":[{"id":"CRT-1","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","parties":["City","Example Co"],"businessName":"Example Co","date":"2026-01-10","disposition":"complaint filed","summary":"","country":"","jurisdiction":"","source":"Caller-supplied","sourceUrl":"","status":"charge","isAllegation":false,"isInvestigation":false,"isCharge":true,"isJudgment":false,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false},{"id":"CRT-2","caseNumber":"22-CV-100","court":"District Court","title":"City v Example Co","parties":["City","Example Co"],"businessName":"Example Co","date":"2026-06-01","disposition":"judgment entered","summary":"","country":"","jurisdiction":"","source":"Caller-supplied","sourceUrl":"","status":"judgment","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":true,"isPenalty":false,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"enforcement":[{"id":"ENF-1","authority":"Regulator A","subject":"Example Co","businessName":"Example Co","action":"civil penalty","date":"2026-03-01","penaltyAmount":25000,"penaltyAmountSupplied":true,"currency":"USD","summary":"","country":"","source":"Caller-supplied","sourceUrl":"","status":"penalty","isAllegation":false,"isInvestigation":false,"isCharge":false,"isJudgment":false,"isPenalty":true,"isNotice":false,"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"crossReference":[{"subjectKey":"example co","courtRecordCount":2,"enforcementCount":1,"noticeCount":0,"statuses":["charge","judgment","penalty"],"courtRecordIds":["CRT-1","CRT-2"],"enforcementIds":["ENF-1"],"noticeIds":[],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false}],"guiltInferred":false,"allegationTreatedAsJudgment":false,"chargeTreatedAsConviction":false,"investigationTreatedAsGuilt":false,"paidProviderUsed":false,"apiKeyRequired":false,"publicSources":[],"findings":[{"kind":"observation","code":"non_judgment","subject":"CRT-1","detail":"charge is not a final judgment. Guilt is not inferred."},{"kind":"observation","code":"non_judgment_step","subject":"CRT-1","detail":"Timeline includes charge, which is not treated as guilt."},{"kind":"observation","code":"incident_non_judgment","subject":"INC-1","detail":"allegation incident is not a finding of guilt."},{"kind":"observation","code":"litigation_non_judgment","subject":"CRT-1","detail":"charge court record is listed for history only and is not treated as guilt."},{"kind":"observation","code":"crossref_non_guilt","subject":"example co","detail":"Cross-referenced records include non-judgment statuses. Guilt is not inferred."}],"limitations":["Court, enforcement, crime-statistic, incident, and notice records are copied only from labeled fields supplied by the caller, or from a key-free public feed when feed.url is requested.","No paid public-records provider is used and no API key is required.","Allegations, investigations, charges, penalties, and final judgments are labeled separately. Guilt is never inferred.","An allegation, investigation, or charge is never treated as a conviction or final judgment.","Missing counts, penalty amounts, and dispositions are not invented."]}}}},"400":{"description":"Invalid JSON or request schema."},"402":{"description":"Payment Required"},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Reusing the key cannot trigger a second charge."},"413":{"description":"Request body exceeds the 24 MB limit."},"500":{"description":"Operation failed. With upfront settlement this may occur after payment; reuse the same idempotency key to retrieve the stored result."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}