{ "openapi": "3.1.0", "info": { "title": "IntelGeist company profile API", "version": "2026-09-14.5", "description": "Company risk profile from public records (GLEIF, SEC EDGAR, OFAC, UK/EU sanctions, US state registries): identity, registrations, parents/subsidiaries, SEC filings, sanctions screen, v1 risk rating, sources and as-of dates. Send exactly one of lei, cik or domain as JSON. Companies only; no person data. USD 0.25 per successful profile; not-found (404), invalid (422) and failed requests are not charged. Payment constitutes acceptance of https://api.intelgeist.ai/terms (version 2026-09-13).", "termsOfService": "https://api.intelgeist.ai/terms" }, "servers": [ { "url": "https://api.intelgeist.ai" } ], "paths": { "/x402/company/profile": { "post": { "operationId": "companyProfile", "summary": "Company risk profile (x402, USDC on Base)", "description": "Company risk profile from public records (GLEIF, SEC EDGAR, OFAC, UK/EU sanctions, US state registries): identity, registrations, parents/subsidiaries, SEC filings, sanctions screen, v1 risk rating, sources and as-of dates. Send exactly one of lei, cik or domain as JSON. Companies only; no person data. USD 0.25 per successful profile; not-found (404), invalid (422) and failed requests are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string", "pattern": "^(?=.{4,253}$)([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$" } }, "oneOf": [ { "required": [ "lei" ] }, { "required": [ "cik" ] }, { "required": [ "domain" ] } ] }, "examples": { "lei": { "value": { "lei": "HWUPKR0MPOU8FGXBT394" } }, "cik": { "value": { "cik": "789019" } }, "domain": { "value": { "domain": "stripe.com" } } } } } }, "x-payment-info": { "protocol": "x402", "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "asset_symbol": "USDC", "decimals": 6, "amount": "250000", "price_usd": "0.25", "payTo": "0xE7fE727F37C5166383899ea4E0AB7c4bca72Aba3", "facilitator": "Coinbase CDP" }, "responses": { "200": { "description": "Paid and settled: profile JSON (schema intelgeist.company_profile.v2)", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "IntelGeist company profile (intelgeist.company_profile.v2)", "type": "object", "properties": { "schema_version": { "type": "string", "const": "intelgeist.company_profile.v2" }, "generated_at": { "type": "string", "format": "date-time" }, "query": { "type": "object", "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string" }, "jurisdiction": { "type": "string" } }, "required": [], "additionalProperties": false, "minProperties": 1, "description": "Echo of the request body (exactly one of lei, cik, domain on the paid routes)." }, "resolved": { "type": "boolean", "const": true }, "match": { "type": "object", "properties": { "method": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "method", "score" ], "additionalProperties": true }, "org": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "canonical_name": { "type": "string" }, "jurisdiction": { "type": [ "string", "null" ] }, "entity_type": { "type": [ "string", "null" ] }, "status": { "type": [ "string", "null" ] }, "status_as_of": { "type": [ "string", "null" ], "format": "date" }, "formed_on": { "type": [ "string", "null" ], "format": "date" }, "dissolved_on": { "type": [ "string", "null" ], "format": "date" }, "primary_domain": { "type": [ "string", "null" ] }, "primary_source": { "type": [ "string", "null" ] }, "updated_at": { "type": "string", "format": "date-time" }, "source": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "canonical_name", "jurisdiction", "status", "source", "as_of" ], "additionalProperties": true }, "identifiers": { "type": "array", "items": { "type": "object", "properties": { "scheme": { "type": "string" }, "qualifier": { "type": "string" }, "value": { "type": "string" }, "link_method": { "type": [ "string", "null" ] }, "link_confidence": { "type": [ "number", "null" ] }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "scheme", "qualifier", "value", "source", "as_of" ], "additionalProperties": true } }, "names": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "kind": { "type": "string", "enum": [ "legal", "trade", "former", "alias" ] }, "valid_from": { "type": [ "string", "null" ], "format": "date" }, "valid_to": { "type": [ "string", "null" ], "format": "date" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "name", "kind", "source", "as_of" ], "additionalProperties": true } }, "addresses": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "registered", "principal", "mailing" ] }, "line": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "region": { "type": [ "string", "null" ] }, "postcode": { "type": [ "string", "null" ] }, "country": { "type": [ "string", "null" ] }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "kind", "source", "as_of" ], "additionalProperties": true } }, "registrations": { "type": "array", "items": { "type": "object", "properties": { "registry": { "type": "string" }, "registry_id": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "status_as_of": { "type": [ "string", "null" ], "format": "date" }, "entity_type": { "type": [ "string", "null" ] }, "formed_on": { "type": [ "string", "null" ], "format": "date" }, "link_method": { "type": [ "string", "null" ] }, "link_confidence": { "type": [ "number", "null" ] }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "registry", "registry_id", "status", "source", "as_of" ], "additionalProperties": true } }, "ownership": { "type": "object", "properties": { "parents": { "type": "array", "items": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "canonical_name": { "type": "string" }, "kind": { "type": "string", "enum": [ "direct_parent", "ultimate_parent", "psc_corporate_owner" ] }, "percent": { "type": [ "number", "null" ] }, "valid_from": { "type": [ "string", "null" ], "format": "date" }, "valid_to": { "type": [ "string", "null" ], "format": "date" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "org_id", "canonical_name", "kind", "percent", "valid_from", "valid_to", "source", "as_of" ], "additionalProperties": true, "description": "An entity that consolidates the queried company: kind direct_parent / ultimate_parent means this row entity is the queried company's direct / ultimate accounting parent (GLEIF Level 2)." } }, "direct_children": { "type": "array", "items": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "canonical_name": { "type": "string" }, "kind": { "type": "string", "enum": [ "direct_child" ] }, "percent": { "type": [ "number", "null" ] }, "valid_from": { "type": [ "string", "null" ], "format": "date" }, "valid_to": { "type": [ "string", "null" ], "format": "date" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "org_id", "canonical_name", "kind", "percent", "valid_from", "valid_to", "source", "as_of" ], "additionalProperties": true, "description": "A direct subsidiary of the queried company: this row entity IS_DIRECTLY_CONSOLIDATED_BY the queried company (GLEIF Level 2)." }, "maxItems": 200 }, "ultimate_children": { "type": "array", "items": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "canonical_name": { "type": "string" }, "kind": { "type": "string", "enum": [ "ultimate_child" ] }, "percent": { "type": [ "number", "null" ] }, "valid_from": { "type": [ "string", "null" ], "format": "date" }, "valid_to": { "type": [ "string", "null" ], "format": "date" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "org_id", "canonical_name", "kind", "percent", "valid_from", "valid_to", "source", "as_of" ], "additionalProperties": true, "description": "An ultimate subsidiary of the queried company: this row entity IS_ULTIMATELY_CONSOLIDATED_BY the queried company (GLEIF Level 2)." }, "maxItems": 200 }, "children_total": { "type": "integer", "minimum": 0, "description": "Distinct subsidiaries (direct or ultimate) in GLEIF Level 2; an entity that is both counts once." }, "direct_children_total": { "type": "integer", "minimum": 0, "description": "Distinct direct subsidiaries." }, "ultimate_children_total": { "type": "integer", "minimum": 0, "description": "Distinct ultimate subsidiaries." }, "direct_children_truncated": { "type": "boolean" }, "ultimate_children_truncated": { "type": "boolean" }, "relationship_note": { "type": "string" }, "note": { "type": "string" } }, "required": [ "parents", "direct_children", "ultimate_children", "children_total", "direct_children_total", "ultimate_children_total", "direct_children_truncated", "ultimate_children_truncated", "relationship_note", "note" ], "additionalProperties": true }, "sanctions_screen": { "type": "array", "items": { "type": "object", "properties": { "list": { "type": "string", "enum": [ "OFAC_SDN", "OFAC_CONS", "UK", "EU" ] }, "list_uid": { "type": "string" }, "name": { "type": "string" }, "programs": { "type": [ "array", "null" ] }, "listed_on": { "type": [ "string", "null" ], "format": "date" }, "method": { "type": "string", "enum": [ "identifier_exact", "name_trgm" ] }, "score": { "type": [ "number", "null" ] }, "reviewed": { "type": "boolean" }, "computed_at": { "type": "string", "format": "date-time" }, "result": { "type": "string", "enum": [ "match", "possible_match" ] }, "matched_on": { "type": "string" }, "list_version": { "type": [ "string", "null" ] }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "list", "list_uid", "name", "method", "score", "result", "matched_on", "source", "as_of" ], "additionalProperties": true } }, "sec_filings": { "type": "array", "items": { "type": "object", "properties": { "accession": { "type": "string", "pattern": "^\\d{10}-\\d{2}-\\d{6}$" }, "form": { "type": "string" }, "filed_on": { "type": "string", "format": "date" }, "report_date": { "type": [ "string", "null" ], "format": "date" }, "primary_doc_url": { "type": [ "string", "null" ], "format": "uri" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "accession", "form", "filed_on", "source", "as_of" ], "additionalProperties": true }, "maxItems": 20 }, "risk": { "type": "object", "properties": { "rating": { "type": "string", "enum": [ "LOW", "MODERATE", "HIGH" ] }, "rating_basis": { "type": "string" }, "factors": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "const": "direct_sanctions_match" }, "framework": { "type": "string" }, "result": { "type": "string", "enum": [ "match", "possible_match", "no_match_found" ] }, "analytic_confidence": { "type": [ "string", "null" ], "enum": [ "LOW", "MODERATE", "HIGH", null ] }, "weakest_link": { "type": [ "string", "null" ] }, "lists": { "type": "array", "items": { "type": "object", "properties": { "list": { "type": "string", "enum": [ "OFAC_SDN", "OFAC_CONS", "UK", "EU" ] }, "status": { "type": "string", "enum": [ "match", "possible_match", "no_match_found" ] }, "list_version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": [ "boolean", "null" ] }, "checked": { "type": "boolean" } }, "required": [ "list", "status", "list_version", "as_of", "stale", "checked" ], "additionalProperties": true }, "minItems": 4, "maxItems": 4 }, "evidence": { "type": "array", "items": { "type": "object" } } }, "required": [ "id", "framework", "result", "analytic_confidence", "weakest_link", "lists", "evidence" ], "additionalProperties": true }, { "type": "object", "properties": { "id": { "type": "string", "const": "ownership_sanctions_exposure" }, "framework": { "type": "string" }, "caveat": { "type": "string" }, "scope": { "type": "string" }, "result": { "type": "string", "enum": [ "possible_exposure", "no_exposure_found" ] }, "analytic_confidence": { "type": [ "string", "null" ], "enum": [ "LOW", null ] }, "weakest_link": { "type": [ "string", "null" ] }, "evidence": { "type": "array", "items": { "type": "object" } } }, "required": [ "id", "framework", "caveat", "scope", "result", "analytic_confidence", "weakest_link", "evidence" ], "additionalProperties": true, "description": "Indicative only: GLEIF records accounting consolidation, not ownership percentages, so the 50% test cannot be established." }, { "type": "object", "properties": { "id": { "type": "string", "const": "jurisdiction_risk" }, "framework": { "type": "string" }, "result": { "type": "string", "enum": [ "not_run", "flag", "no_flags_found" ] }, "reason": { "type": "string" } }, "required": [ "id", "framework", "result" ], "additionalProperties": true }, { "type": "object", "properties": { "id": { "type": "string", "const": "status_registration_anomalies" }, "framework": { "type": "string" }, "result": { "type": "string", "enum": [ "flag", "no_flags_found" ] }, "analytic_confidence": { "type": [ "string", "null" ], "enum": [ "LOW", "MODERATE", "HIGH", null ] }, "weakest_link": { "type": [ "string", "null" ] }, "flags": { "type": "array", "items": { "type": "object", "properties": { "flag": { "type": "string" }, "detail": { "type": "string" }, "records": { "type": "array", "items": { "type": "object" } } }, "required": [ "flag", "detail", "records" ], "additionalProperties": true } } }, "required": [ "id", "framework", "result", "analytic_confidence", "weakest_link", "flags" ], "additionalProperties": true } ] }, "minItems": 4, "maxItems": 4 }, "coverage": { "type": "object", "properties": { "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "source", "version", "as_of" ], "additionalProperties": true } }, "factors_run": { "type": "array", "items": { "type": "string" } }, "factors_not_run": { "type": "array", "items": { "type": "string" } }, "stale_sanctions_lists": { "type": "array", "items": { "type": "string" } }, "not_available": { "type": "array", "items": { "type": "string" } } }, "required": [ "checked", "factors_run", "factors_not_run", "stale_sanctions_lists", "not_available" ], "additionalProperties": true }, "statement": { "type": "string", "description": "Present when rating is LOW: names the list dates and says it is not a statement of safety." } }, "required": [ "rating", "rating_basis", "factors", "coverage" ], "additionalProperties": true }, "coverage": { "type": "object", "properties": { "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "as_of", "stale" ], "additionalProperties": true } }, "records_found_in": { "type": "array", "items": { "type": "string" } }, "no_record_found_in": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" } }, "required": [ "checked", "records_found_in", "no_record_found_in", "note" ], "additionalProperties": true }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "name": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "license": { "type": [ "string", "null" ] }, "attribution": { "type": [ "string", "null" ] }, "modification_note": { "type": "string" }, "source_reliability": { "type": [ "string", "null" ], "enum": [ "A", "B", "C", "D", "E", "F", null ] } }, "required": [ "source", "name", "version", "retrieved_at", "published_at", "license", "attribution", "modification_note", "source_reliability" ], "additionalProperties": true }, "minItems": 1 }, "notice": { "type": "object", "properties": { "summary": { "type": "string", "description": "Verbatim notice: informational only, AS IS, no warranty, not an FCRA consumer report." }, "sanctions": { "type": "string", "description": "Verbatim sanctions caveat: a possible match is not a legal determination; no match is not a guarantee." }, "data_as_of": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "retrieved_at", "published_at", "stale" ], "additionalProperties": true } }, "terms_url": { "type": "string", "format": "uri" }, "terms_version": { "type": "string" } }, "required": [ "summary", "sanctions", "data_as_of", "terms_url", "terms_version" ], "additionalProperties": true } }, "required": [ "schema_version", "generated_at", "query", "resolved", "match", "org", "identifiers", "names", "addresses", "registrations", "ownership", "sanctions_screen", "sec_filings", "risk", "coverage", "sources", "notice" ], "additionalProperties": false }, "example": { "schema_version": "intelgeist.company_profile.v2", "resolved": true, "match": { "method": "identifier_exact:LEI", "score": 1.0 }, "org": { "canonical_name": "Apple Inc.", "jurisdiction": "US-CA", "status": "active", "source": "gleif_l1", "as_of": "2026-09-13T16:00:00+00:00" }, "ownership": { "direct_children": [ { "canonical_name": "APPLE CANADA INC.", "kind": "direct_child", "source": "gleif_rr" } ], "children_total": 20, "direct_children_total": 8, "ultimate_children_total": 20 }, "risk": { "rating": "LOW", "rating_basis": "IntelGeist v1 factor rules; informational only, see notice" }, "sanctions_screen": [], "notice": { "terms_url": "https://api.intelgeist.ai/terms", "terms_version": "2026-09-13" } } } } }, "402": { "description": "Payment required (PAYMENT-REQUIRED header), or settlement did not complete (no data delivered)" }, "404": { "description": "Company not found in the loaded sources (coverage gap, not a clean result). Not charged." }, "409": { "description": "Payment authorization already used or still in flight. Not charged again." }, "422": { "description": "Invalid parameters (exactly one of lei, cik, domain). Not charged." }, "429": { "description": "Rate limited. Not charged." }, "502": { "description": "Backend failure. Not charged." } } } }, "/x402/company/resolve": { "post": { "operationId": "companyResolve", "summary": "Resolve a company identifier to one legal entity (x402, USDC on Base)", "description": "Which company is this? Resolves one LEI, SEC CIK or domain to one legal entity: legal name, status, jurisdiction, entity type, formation date, LEI, CIK, US state registry IDs, primary domain and match method and score. Send exactly one of lei, cik or domain as JSON. Companies only; no person data. USD 0.02 per successful lookup; not-found (404), invalid (422) and failed requests are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string", "pattern": "^(?=.{4,253}$)([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$" } }, "oneOf": [ { "required": [ "lei" ] }, { "required": [ "cik" ] }, { "required": [ "domain" ] } ] }, "examples": { "lei": { "value": { "lei": "HWUPKR0MPOU8FGXBT394" } }, "cik": { "value": { "cik": "789019" } }, "domain": { "value": { "domain": "stripe.com" } } } } } }, "x-payment-info": { "protocol": "x402", "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "asset_symbol": "USDC", "decimals": 6, "amount": "20000", "price_usd": "0.02", "payTo": "0xE7fE727F37C5166383899ea4E0AB7c4bca72Aba3", "facilitator": "Coinbase CDP" }, "responses": { "200": { "description": "Paid and settled: resolve JSON (schema intelgeist.company_resolve.v1)", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "IntelGeist company resolve (intelgeist.company_resolve.v1)", "type": "object", "properties": { "schema_version": { "type": "string", "const": "intelgeist.company_resolve.v1" }, "generated_at": { "type": "string", "format": "date-time" }, "query": { "type": "object", "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string" }, "jurisdiction": { "type": "string" } }, "required": [], "additionalProperties": false, "minProperties": 1, "description": "Echo of the request body (exactly one of lei, cik, domain on the paid routes)." }, "resolved": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "legal_name": { "type": "string" }, "match": { "type": "object", "properties": { "method": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "method", "score" ], "additionalProperties": true } }, "required": [ "org_id", "legal_name", "match" ], "additionalProperties": true }, "resolve": { "type": "object", "properties": { "legal_name": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "status_as_of": { "type": [ "string", "null" ], "format": "date" }, "jurisdiction": { "type": [ "string", "null" ] }, "entity_type": { "type": [ "string", "null" ] }, "formed_on": { "type": [ "string", "null" ], "format": "date" }, "dissolved_on": { "type": [ "string", "null" ], "format": "date" }, "primary_domain": { "type": [ "string", "null" ] }, "source": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "identifiers": { "type": "array", "items": { "type": "object", "properties": { "scheme": { "type": "string" }, "qualifier": { "type": "string" }, "value": { "type": "string" }, "link_method": { "type": [ "string", "null" ] }, "link_confidence": { "type": [ "number", "null" ] }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "scheme", "qualifier", "value", "source", "as_of" ], "additionalProperties": true } } }, "required": [ "legal_name", "status", "jurisdiction", "dissolved_on", "primary_domain", "source", "as_of", "identifiers" ], "additionalProperties": true }, "coverage": { "type": "object", "properties": { "scope": { "type": "string" }, "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "as_of", "stale" ], "additionalProperties": true } }, "records_found_in": { "type": "array", "items": { "type": "string" } }, "no_record_found_in": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" }, "full_profile": { "type": "string", "format": "uri" } }, "required": [ "scope", "checked", "records_found_in", "no_record_found_in", "note", "full_profile" ], "additionalProperties": true }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "name": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "license": { "type": [ "string", "null" ] }, "attribution": { "type": [ "string", "null" ] }, "modification_note": { "type": "string" }, "source_reliability": { "type": [ "string", "null" ], "enum": [ "A", "B", "C", "D", "E", "F", null ] } }, "required": [ "source", "name", "version", "retrieved_at", "published_at", "license", "attribution", "modification_note", "source_reliability" ], "additionalProperties": true }, "minItems": 1 }, "notice": { "type": "object", "properties": { "summary": { "type": "string", "description": "Verbatim notice: informational only, AS IS, no warranty, not an FCRA consumer report." }, "sanctions": { "type": "string", "description": "Verbatim sanctions caveat: a possible match is not a legal determination; no match is not a guarantee." }, "data_as_of": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "retrieved_at", "published_at", "stale" ], "additionalProperties": true } }, "terms_url": { "type": "string", "format": "uri" }, "terms_version": { "type": "string" } }, "required": [ "summary", "sanctions", "data_as_of", "terms_url", "terms_version" ], "additionalProperties": true } }, "required": [ "schema_version", "generated_at", "query", "resolved", "resolve", "coverage", "sources", "notice" ], "additionalProperties": false }, "example": { "schema_version": "intelgeist.company_resolve.v1", "resolved": { "legal_name": "Apple Inc.", "match": { "method": "identifier_exact:CIK", "score": 1.0 } }, "resolve": { "legal_name": "Apple Inc.", "status": "active", "jurisdiction": "US-CA", "primary_domain": "apple.com" }, "notice": { "terms_url": "https://api.intelgeist.ai/terms", "terms_version": "2026-09-13" } } } } }, "402": { "description": "Payment required (PAYMENT-REQUIRED header), or settlement did not complete (no data delivered)" }, "404": { "description": "Company not found in the loaded sources (coverage gap, not a clean result). Not charged." }, "409": { "description": "Payment authorization already used or still in flight. Not charged again." }, "422": { "description": "Invalid parameters (exactly one of lei, cik, domain). Not charged." }, "429": { "description": "Rate limited. Not charged." }, "502": { "description": "Backend failure. Not charged." } } } }, "/x402/company/sanctions": { "post": { "operationId": "companySanctions", "summary": "Sanctions screen of one company: OFAC, UK and EU lists (x402, USDC on Base)", "description": "Screens one company against OFAC SDN and Consolidated, UK and EU sanctions lists: per-list result (match, possible_match, no_match_found), list date, stale flag and matched entries. Automated comparison, not a legal determination. Send exactly one of lei, cik or domain as JSON. Companies only; no person data. USD 0.05 per successful screen; not-found (404), invalid (422) and failed requests are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string", "pattern": "^(?=.{4,253}$)([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$" } }, "oneOf": [ { "required": [ "lei" ] }, { "required": [ "cik" ] }, { "required": [ "domain" ] } ] }, "examples": { "lei": { "value": { "lei": "HWUPKR0MPOU8FGXBT394" } }, "cik": { "value": { "cik": "789019" } }, "domain": { "value": { "domain": "stripe.com" } } } } } }, "x-payment-info": { "protocol": "x402", "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "asset_symbol": "USDC", "decimals": 6, "amount": "50000", "price_usd": "0.05", "payTo": "0xE7fE727F37C5166383899ea4E0AB7c4bca72Aba3", "facilitator": "Coinbase CDP" }, "responses": { "200": { "description": "Paid and settled: sanctions JSON (schema intelgeist.company_sanctions.v1)", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "IntelGeist company sanctions (intelgeist.company_sanctions.v1)", "type": "object", "properties": { "schema_version": { "type": "string", "const": "intelgeist.company_sanctions.v1" }, "generated_at": { "type": "string", "format": "date-time" }, "query": { "type": "object", "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string" }, "jurisdiction": { "type": "string" } }, "required": [], "additionalProperties": false, "minProperties": 1, "description": "Echo of the request body (exactly one of lei, cik, domain on the paid routes)." }, "resolved": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "legal_name": { "type": "string" }, "match": { "type": "object", "properties": { "method": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "method", "score" ], "additionalProperties": true } }, "required": [ "org_id", "legal_name", "match" ], "additionalProperties": true }, "sanctions": { "type": "object", "properties": { "id": { "type": "string", "const": "direct_sanctions_match" }, "framework": { "type": "string" }, "result": { "type": "string", "enum": [ "match", "possible_match", "no_match_found" ] }, "analytic_confidence": { "type": [ "string", "null" ], "enum": [ "LOW", "MODERATE", "HIGH", null ] }, "weakest_link": { "type": [ "string", "null" ] }, "lists": { "type": "array", "items": { "type": "object", "properties": { "list": { "type": "string", "enum": [ "OFAC_SDN", "OFAC_CONS", "UK", "EU" ] }, "status": { "type": "string", "enum": [ "match", "possible_match", "no_match_found" ] }, "list_version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": [ "boolean", "null" ] }, "checked": { "type": "boolean" } }, "required": [ "list", "status", "list_version", "as_of", "stale", "checked" ], "additionalProperties": true }, "minItems": 4, "maxItems": 4 }, "evidence": { "type": "array", "items": { "type": "object" } }, "stale_lists": { "type": "array", "items": { "type": "string" } } }, "required": [ "id", "framework", "result", "analytic_confidence", "weakest_link", "lists", "evidence", "stale_lists" ], "additionalProperties": true }, "coverage": { "type": "object", "properties": { "scope": { "type": "string" }, "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "as_of", "stale" ], "additionalProperties": true } }, "records_found_in": { "type": "array", "items": { "type": "string" } }, "no_record_found_in": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" }, "full_profile": { "type": "string", "format": "uri" } }, "required": [ "scope", "checked", "records_found_in", "no_record_found_in", "note", "full_profile" ], "additionalProperties": true }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "name": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "license": { "type": [ "string", "null" ] }, "attribution": { "type": [ "string", "null" ] }, "modification_note": { "type": "string" }, "source_reliability": { "type": [ "string", "null" ], "enum": [ "A", "B", "C", "D", "E", "F", null ] } }, "required": [ "source", "name", "version", "retrieved_at", "published_at", "license", "attribution", "modification_note", "source_reliability" ], "additionalProperties": true }, "minItems": 1 }, "notice": { "type": "object", "properties": { "summary": { "type": "string", "description": "Verbatim notice: informational only, AS IS, no warranty, not an FCRA consumer report." }, "sanctions": { "type": "string", "description": "Verbatim sanctions caveat: a possible match is not a legal determination; no match is not a guarantee." }, "data_as_of": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "retrieved_at", "published_at", "stale" ], "additionalProperties": true } }, "terms_url": { "type": "string", "format": "uri" }, "terms_version": { "type": "string" } }, "required": [ "summary", "sanctions", "data_as_of", "terms_url", "terms_version" ], "additionalProperties": true } }, "required": [ "schema_version", "generated_at", "query", "resolved", "sanctions", "coverage", "sources", "notice" ], "additionalProperties": false }, "example": { "schema_version": "intelgeist.company_sanctions.v1", "resolved": { "legal_name": "Apple Inc.", "match": { "method": "identifier_exact:LEI", "score": 1.0 } }, "sanctions": { "id": "direct_sanctions_match", "result": "no_match_found", "lists": [ { "list": "OFAC_SDN", "status": "no_match_found", "list_version": "OFAC_SDN 2026-09-10", "stale": false }, { "list": "OFAC_CONS", "status": "no_match_found", "list_version": "OFAC_CONS 2026-07-27", "stale": true }, { "list": "UK", "status": "no_match_found", "list_version": "UK 2026-09-11", "stale": false }, { "list": "EU", "status": "no_match_found", "list_version": "EU 2026-08-05", "stale": true } ], "evidence": [] }, "notice": { "terms_url": "https://api.intelgeist.ai/terms", "terms_version": "2026-09-13" } } } } }, "402": { "description": "Payment required (PAYMENT-REQUIRED header), or settlement did not complete (no data delivered)" }, "404": { "description": "Company not found in the loaded sources (coverage gap, not a clean result). Not charged." }, "409": { "description": "Payment authorization already used or still in flight. Not charged again." }, "422": { "description": "Invalid parameters (exactly one of lei, cik, domain). Not charged." }, "429": { "description": "Rate limited. Not charged." }, "502": { "description": "Backend failure. Not charged." } } } }, "/x402/company/ownership": { "post": { "operationId": "companyOwnership", "summary": "Parents, subsidiaries and ownership-chain sanctions exposure (x402, USDC on Base)", "description": "GLEIF relationship records: direct and ultimate parents, up to 50 direct subsidiaries, start/end dates and an indicative ownership-chain sanctions exposure (at most LOW confidence; GLEIF is consolidation, not ownership %). Send exactly one of lei, cik or domain as JSON. Companies only; no person data. USD 0.10 per successful lookup; not-found (404), invalid (422) and failed requests are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string", "pattern": "^(?=.{4,253}$)([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$" } }, "oneOf": [ { "required": [ "lei" ] }, { "required": [ "cik" ] }, { "required": [ "domain" ] } ] }, "examples": { "lei": { "value": { "lei": "HWUPKR0MPOU8FGXBT394" } }, "cik": { "value": { "cik": "789019" } }, "domain": { "value": { "domain": "stripe.com" } } } } } }, "x-payment-info": { "protocol": "x402", "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "asset_symbol": "USDC", "decimals": 6, "amount": "100000", "price_usd": "0.10", "payTo": "0xE7fE727F37C5166383899ea4E0AB7c4bca72Aba3", "facilitator": "Coinbase CDP" }, "responses": { "200": { "description": "Paid and settled: ownership JSON (schema intelgeist.company_ownership.v2)", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "IntelGeist company ownership (intelgeist.company_ownership.v2)", "type": "object", "properties": { "schema_version": { "type": "string", "const": "intelgeist.company_ownership.v2" }, "generated_at": { "type": "string", "format": "date-time" }, "query": { "type": "object", "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string" }, "jurisdiction": { "type": "string" } }, "required": [], "additionalProperties": false, "minProperties": 1, "description": "Echo of the request body (exactly one of lei, cik, domain on the paid routes)." }, "resolved": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "legal_name": { "type": "string" }, "match": { "type": "object", "properties": { "method": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "method", "score" ], "additionalProperties": true } }, "required": [ "org_id", "legal_name", "match" ], "additionalProperties": true }, "ownership": { "type": "object", "properties": { "parents": { "type": "array", "items": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "canonical_name": { "type": "string" }, "kind": { "type": "string", "enum": [ "direct_parent", "ultimate_parent", "psc_corporate_owner" ] }, "percent": { "type": [ "number", "null" ] }, "valid_from": { "type": [ "string", "null" ], "format": "date" }, "valid_to": { "type": [ "string", "null" ], "format": "date" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "org_id", "canonical_name", "kind", "percent", "valid_from", "valid_to", "source", "as_of" ], "additionalProperties": true, "description": "An entity that consolidates the queried company: kind direct_parent / ultimate_parent means this row entity is the queried company's direct / ultimate accounting parent (GLEIF Level 2)." } }, "direct_children": { "type": "array", "items": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "canonical_name": { "type": "string" }, "kind": { "type": "string", "enum": [ "direct_child" ] }, "percent": { "type": [ "number", "null" ] }, "valid_from": { "type": [ "string", "null" ], "format": "date" }, "valid_to": { "type": [ "string", "null" ], "format": "date" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "org_id", "canonical_name", "kind", "percent", "valid_from", "valid_to", "source", "as_of" ], "additionalProperties": true, "description": "A direct subsidiary of the queried company: this row entity IS_DIRECTLY_CONSOLIDATED_BY the queried company (GLEIF Level 2)." }, "maxItems": 50 }, "direct_children_total": { "type": "integer", "minimum": 0, "description": "Distinct direct subsidiaries." }, "direct_children_truncated": { "type": "boolean" }, "ultimate_children_total": { "type": "integer", "minimum": 0, "description": "Distinct ultimate subsidiaries." }, "children_total": { "type": "integer", "minimum": 0, "description": "Distinct subsidiaries (direct or ultimate) in GLEIF Level 2; an entity that is both counts once." }, "relationship_note": { "type": "string" }, "note": { "type": "string" }, "sanctions_exposure": { "type": "object", "properties": { "id": { "type": "string", "const": "ownership_sanctions_exposure" }, "framework": { "type": "string" }, "caveat": { "type": "string" }, "scope": { "type": "string" }, "result": { "type": "string", "enum": [ "possible_exposure", "no_exposure_found" ] }, "analytic_confidence": { "type": [ "string", "null" ], "enum": [ "LOW", null ] }, "weakest_link": { "type": [ "string", "null" ] }, "evidence": { "type": "array", "items": { "type": "object" } } }, "required": [ "id", "framework", "caveat", "scope", "result", "analytic_confidence", "weakest_link", "evidence" ], "additionalProperties": true, "description": "Indicative only: GLEIF records accounting consolidation, not ownership percentages, so the 50% test cannot be established." } }, "required": [ "parents", "direct_children", "direct_children_total", "direct_children_truncated", "ultimate_children_total", "children_total", "relationship_note", "note", "sanctions_exposure" ], "additionalProperties": true }, "coverage": { "type": "object", "properties": { "scope": { "type": "string" }, "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "as_of", "stale" ], "additionalProperties": true } }, "records_found_in": { "type": "array", "items": { "type": "string" } }, "no_record_found_in": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" }, "full_profile": { "type": "string", "format": "uri" } }, "required": [ "scope", "checked", "records_found_in", "no_record_found_in", "note", "full_profile" ], "additionalProperties": true }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "name": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "license": { "type": [ "string", "null" ] }, "attribution": { "type": [ "string", "null" ] }, "modification_note": { "type": "string" }, "source_reliability": { "type": [ "string", "null" ], "enum": [ "A", "B", "C", "D", "E", "F", null ] } }, "required": [ "source", "name", "version", "retrieved_at", "published_at", "license", "attribution", "modification_note", "source_reliability" ], "additionalProperties": true }, "minItems": 1 }, "notice": { "type": "object", "properties": { "summary": { "type": "string", "description": "Verbatim notice: informational only, AS IS, no warranty, not an FCRA consumer report." }, "sanctions": { "type": "string", "description": "Verbatim sanctions caveat: a possible match is not a legal determination; no match is not a guarantee." }, "data_as_of": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "retrieved_at", "published_at", "stale" ], "additionalProperties": true } }, "terms_url": { "type": "string", "format": "uri" }, "terms_version": { "type": "string" } }, "required": [ "summary", "sanctions", "data_as_of", "terms_url", "terms_version" ], "additionalProperties": true } }, "required": [ "schema_version", "generated_at", "query", "resolved", "ownership", "coverage", "sources", "notice" ], "additionalProperties": false }, "example": { "schema_version": "intelgeist.company_ownership.v2", "resolved": { "legal_name": "Apple Inc.", "match": { "method": "identifier_exact:LEI", "score": 1.0 } }, "ownership": { "parents": [], "direct_children": [ { "canonical_name": "APPLE CANADA INC.", "kind": "direct_child", "valid_from": "2023-05-08", "source": "gleif_rr" } ], "direct_children_total": 8, "direct_children_truncated": false, "ultimate_children_total": 20, "children_total": 20, "sanctions_exposure": { "id": "ownership_sanctions_exposure", "result": "no_exposure_found" } }, "notice": { "terms_url": "https://api.intelgeist.ai/terms", "terms_version": "2026-09-13" } } } } }, "402": { "description": "Payment required (PAYMENT-REQUIRED header), or settlement did not complete (no data delivered)" }, "404": { "description": "Company not found in the loaded sources (coverage gap, not a clean result). Not charged." }, "409": { "description": "Payment authorization already used or still in flight. Not charged again." }, "422": { "description": "Invalid parameters (exactly one of lei, cik, domain). Not charged." }, "429": { "description": "Rate limited. Not charged." }, "502": { "description": "Backend failure. Not charged." } } } }, "/x402/company/status": { "post": { "operationId": "companyStatus", "summary": "Registration status and LEI status of one company (x402, USDC on Base)", "description": "Registration status of one company: GLEIF and CO/CT/NY registry records (number, status, status and formation dates), LEI status (e.g. ISSUED, LAPSED), dissolution date and a flag when registries disagree. Send exactly one of lei, cik or domain as JSON. Companies only; no registered agents or officers. USD 0.02 per successful check; not-found (404), invalid (422) and failed requests are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string", "pattern": "^(?=.{4,253}$)([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$" } }, "oneOf": [ { "required": [ "lei" ] }, { "required": [ "cik" ] }, { "required": [ "domain" ] } ] }, "examples": { "lei": { "value": { "lei": "HWUPKR0MPOU8FGXBT394" } }, "cik": { "value": { "cik": "789019" } }, "domain": { "value": { "domain": "stripe.com" } } } } } }, "x-payment-info": { "protocol": "x402", "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "asset_symbol": "USDC", "decimals": 6, "amount": "20000", "price_usd": "0.02", "payTo": "0xE7fE727F37C5166383899ea4E0AB7c4bca72Aba3", "facilitator": "Coinbase CDP" }, "responses": { "200": { "description": "Paid and settled: status JSON (schema intelgeist.company_status.v1)", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "IntelGeist company status (intelgeist.company_status.v1)", "type": "object", "properties": { "schema_version": { "type": "string", "const": "intelgeist.company_status.v1" }, "generated_at": { "type": "string", "format": "date-time" }, "query": { "type": "object", "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string" }, "jurisdiction": { "type": "string" } }, "required": [], "additionalProperties": false, "minProperties": 1, "description": "Echo of the request body (exactly one of lei, cik, domain on the paid routes)." }, "resolved": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "legal_name": { "type": "string" }, "match": { "type": "object", "properties": { "method": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "method", "score" ], "additionalProperties": true } }, "required": [ "org_id", "legal_name", "match" ], "additionalProperties": true }, "status": { "type": "object", "properties": { "company": { "type": "object", "properties": { "status": { "type": [ "string", "null" ] }, "status_as_of": { "type": [ "string", "null" ], "format": "date" }, "jurisdiction": { "type": [ "string", "null" ] }, "entity_type": { "type": [ "string", "null" ] }, "formed_on": { "type": [ "string", "null" ], "format": "date" }, "dissolved_on": { "type": [ "string", "null" ], "format": "date" }, "source": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "status", "jurisdiction", "dissolved_on", "source", "as_of" ], "additionalProperties": true }, "registrations": { "type": "array", "items": { "type": "object", "properties": { "registry": { "type": "string" }, "registry_id": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "status_as_of": { "type": [ "string", "null" ], "format": "date" }, "entity_type": { "type": [ "string", "null" ] }, "formed_on": { "type": [ "string", "null" ], "format": "date" }, "link_method": { "type": [ "string", "null" ] }, "link_confidence": { "type": [ "number", "null" ] }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "registry", "registry_id", "status", "source", "as_of" ], "additionalProperties": true } }, "lei_registration": { "type": [ "object", "null" ], "properties": { "lei": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "status_as_of": { "type": [ "string", "null" ], "format": "date" }, "source": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "lei", "status" ] }, "anomalies": { "type": "object", "properties": { "id": { "type": "string", "const": "status_registration_anomalies" }, "framework": { "type": "string" }, "result": { "type": "string", "enum": [ "flag", "no_flags_found" ] }, "analytic_confidence": { "type": [ "string", "null" ], "enum": [ "LOW", "MODERATE", "HIGH", null ] }, "weakest_link": { "type": [ "string", "null" ] }, "flags": { "type": "array", "items": { "type": "object", "properties": { "flag": { "type": "string" }, "detail": { "type": "string" }, "records": { "type": "array", "items": { "type": "object" } } }, "required": [ "flag", "detail", "records" ], "additionalProperties": true } } }, "required": [ "id", "framework", "result", "analytic_confidence", "weakest_link", "flags" ], "additionalProperties": true }, "note": { "type": "string" } }, "required": [ "company", "registrations", "lei_registration", "anomalies", "note" ], "additionalProperties": true }, "coverage": { "type": "object", "properties": { "scope": { "type": "string" }, "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "as_of", "stale" ], "additionalProperties": true } }, "records_found_in": { "type": "array", "items": { "type": "string" } }, "no_record_found_in": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" }, "full_profile": { "type": "string", "format": "uri" } }, "required": [ "scope", "checked", "records_found_in", "no_record_found_in", "note", "full_profile" ], "additionalProperties": true }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "name": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "license": { "type": [ "string", "null" ] }, "attribution": { "type": [ "string", "null" ] }, "modification_note": { "type": "string" }, "source_reliability": { "type": [ "string", "null" ], "enum": [ "A", "B", "C", "D", "E", "F", null ] } }, "required": [ "source", "name", "version", "retrieved_at", "published_at", "license", "attribution", "modification_note", "source_reliability" ], "additionalProperties": true }, "minItems": 1 }, "notice": { "type": "object", "properties": { "summary": { "type": "string", "description": "Verbatim notice: informational only, AS IS, no warranty, not an FCRA consumer report." }, "sanctions": { "type": "string", "description": "Verbatim sanctions caveat: a possible match is not a legal determination; no match is not a guarantee." }, "data_as_of": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "retrieved_at", "published_at", "stale" ], "additionalProperties": true } }, "terms_url": { "type": "string", "format": "uri" }, "terms_version": { "type": "string" } }, "required": [ "summary", "sanctions", "data_as_of", "terms_url", "terms_version" ], "additionalProperties": true } }, "required": [ "schema_version", "generated_at", "query", "resolved", "status", "coverage", "sources", "notice" ], "additionalProperties": false }, "example": { "schema_version": "intelgeist.company_status.v1", "resolved": { "legal_name": "Apple Inc.", "match": { "method": "domain_exact", "score": 1.0 } }, "status": { "company": { "status": "active", "jurisdiction": "US-CA", "formed_on": "1977-01-03", "dissolved_on": null }, "registrations": [ { "registry": "US-CO-SOS", "registry_id": "19871422707", "status": "Good Standing", "source": "us_co" } ], "lei_registration": { "lei": "HWUPKR0MPOU8FGXBT394", "status": "ISSUED", "status_as_of": "2026-03-03" }, "anomalies": { "id": "status_registration_anomalies", "result": "no_flags_found" } }, "notice": { "terms_url": "https://api.intelgeist.ai/terms", "terms_version": "2026-09-13" } } } } }, "402": { "description": "Payment required (PAYMENT-REQUIRED header), or settlement did not complete (no data delivered)" }, "404": { "description": "Company not found in the loaded sources (coverage gap, not a clean result). Not charged." }, "409": { "description": "Payment authorization already used or still in flight. Not charged again." }, "422": { "description": "Invalid parameters (exactly one of lei, cik, domain). Not charged." }, "429": { "description": "Rate limited. Not charged." }, "502": { "description": "Backend failure. Not charged." } } } }, "/x402/company/filings": { "post": { "operationId": "companyFilings", "summary": "Recent SEC EDGAR filings of one company (x402, USDC on Base)", "description": "Recent SEC EDGAR filings for one company: its CIK and up to 20 most recent filings (form, filing and report date, accession number, document link) with the loaded count. No SEC CIK or no filings on record returns 404, not charged. Send exactly one of lei, cik or domain as JSON. USD 0.02 per successful lookup; invalid (422) and failed requests are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string", "pattern": "^(?=.{4,253}$)([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$" } }, "oneOf": [ { "required": [ "lei" ] }, { "required": [ "cik" ] }, { "required": [ "domain" ] } ] }, "examples": { "lei": { "value": { "lei": "HWUPKR0MPOU8FGXBT394" } }, "cik": { "value": { "cik": "789019" } }, "domain": { "value": { "domain": "stripe.com" } } } } } }, "x-payment-info": { "protocol": "x402", "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "asset_symbol": "USDC", "decimals": 6, "amount": "20000", "price_usd": "0.02", "payTo": "0xE7fE727F37C5166383899ea4E0AB7c4bca72Aba3", "facilitator": "Coinbase CDP" }, "responses": { "200": { "description": "Paid and settled: filings JSON (schema intelgeist.company_filings.v1)", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "IntelGeist company filings (intelgeist.company_filings.v1)", "type": "object", "properties": { "schema_version": { "type": "string", "const": "intelgeist.company_filings.v1" }, "generated_at": { "type": "string", "format": "date-time" }, "query": { "type": "object", "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string" }, "jurisdiction": { "type": "string" } }, "required": [], "additionalProperties": false, "minProperties": 1, "description": "Echo of the request body (exactly one of lei, cik, domain on the paid routes)." }, "resolved": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "legal_name": { "type": "string" }, "match": { "type": "object", "properties": { "method": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "method", "score" ], "additionalProperties": true } }, "required": [ "org_id", "legal_name", "match" ], "additionalProperties": true }, "filings": { "type": "object", "properties": { "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "total_filings": { "type": "integer", "minimum": 1 }, "returned": { "type": "integer", "minimum": 0, "maximum": 20 }, "recent_filings": { "type": "array", "items": { "type": "object", "properties": { "accession": { "type": "string", "pattern": "^\\d{10}-\\d{2}-\\d{6}$" }, "form": { "type": "string" }, "filed_on": { "type": "string", "format": "date" }, "report_date": { "type": [ "string", "null" ], "format": "date" }, "primary_doc_url": { "type": [ "string", "null" ], "format": "uri" }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "accession", "form", "filed_on", "source", "as_of" ], "additionalProperties": true }, "maxItems": 20 } }, "required": [ "cik", "total_filings", "returned", "recent_filings" ], "additionalProperties": true }, "coverage": { "type": "object", "properties": { "scope": { "type": "string" }, "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "as_of", "stale" ], "additionalProperties": true } }, "records_found_in": { "type": "array", "items": { "type": "string" } }, "no_record_found_in": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" }, "full_profile": { "type": "string", "format": "uri" } }, "required": [ "scope", "checked", "records_found_in", "no_record_found_in", "note", "full_profile" ], "additionalProperties": true }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "name": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "license": { "type": [ "string", "null" ] }, "attribution": { "type": [ "string", "null" ] }, "modification_note": { "type": "string" }, "source_reliability": { "type": [ "string", "null" ], "enum": [ "A", "B", "C", "D", "E", "F", null ] } }, "required": [ "source", "name", "version", "retrieved_at", "published_at", "license", "attribution", "modification_note", "source_reliability" ], "additionalProperties": true }, "minItems": 1 }, "notice": { "type": "object", "properties": { "summary": { "type": "string", "description": "Verbatim notice: informational only, AS IS, no warranty, not an FCRA consumer report." }, "sanctions": { "type": "string", "description": "Verbatim sanctions caveat: a possible match is not a legal determination; no match is not a guarantee." }, "data_as_of": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "retrieved_at", "published_at", "stale" ], "additionalProperties": true } }, "terms_url": { "type": "string", "format": "uri" }, "terms_version": { "type": "string" } }, "required": [ "summary", "sanctions", "data_as_of", "terms_url", "terms_version" ], "additionalProperties": true } }, "required": [ "schema_version", "generated_at", "query", "resolved", "filings", "coverage", "sources", "notice" ], "additionalProperties": false }, "example": { "schema_version": "intelgeist.company_filings.v1", "resolved": { "legal_name": "Apple Inc.", "match": { "method": "identifier_exact:CIK", "score": 1.0 } }, "filings": { "cik": "320193", "total_filings": 20, "returned": 20, "recent_filings": [ { "accession": "0001140361-26-036226", "form": "4", "filed_on": "2026-09-10", "report_date": "2026-09-08", "source": "sec_submissions" } ] }, "notice": { "terms_url": "https://api.intelgeist.ai/terms", "terms_version": "2026-09-13" } } } } }, "402": { "description": "Payment required (PAYMENT-REQUIRED header), or settlement did not complete (no data delivered)" }, "404": { "description": "Company not found in the loaded sources, or it has no SEC CIK / no filings on record (coverage gap, not a clean result). Not charged." }, "409": { "description": "Payment authorization already used or still in flight. Not charged again." }, "422": { "description": "Invalid parameters (exactly one of lei, cik, domain). Not charged." }, "429": { "description": "Rate limited. Not charged." }, "502": { "description": "Backend failure. Not charged." } } } }, "/x402/company/identifiers": { "post": { "operationId": "companyIdentifiers", "summary": "Crosswalk one company ID to LEI, CIK, registry IDs, QID and domain (x402, USDC on Base)", "description": "Map one company ID to the others: crosswalk from one LEI, SEC CIK or domain to LEI, CIK, US state registry numbers, registration-authority IDs, Wikidata QID and primary domain, each with source, as-of date and link confidence. Send exactly one of lei, cik or domain as JSON. Companies only; no person data. USD 0.01 per successful lookup; not-found (404), invalid (422) and failed requests are not charged.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string", "pattern": "^(?=.{4,253}$)([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$" } }, "oneOf": [ { "required": [ "lei" ] }, { "required": [ "cik" ] }, { "required": [ "domain" ] } ] }, "examples": { "lei": { "value": { "lei": "HWUPKR0MPOU8FGXBT394" } }, "cik": { "value": { "cik": "789019" } }, "domain": { "value": { "domain": "stripe.com" } } } } } }, "x-payment-info": { "protocol": "x402", "version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "asset_symbol": "USDC", "decimals": 6, "amount": "10000", "price_usd": "0.01", "payTo": "0xE7fE727F37C5166383899ea4E0AB7c4bca72Aba3", "facilitator": "Coinbase CDP" }, "responses": { "200": { "description": "Paid and settled: identifiers JSON (schema intelgeist.company_identifiers.v1)", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "IntelGeist company identifiers (intelgeist.company_identifiers.v1)", "type": "object", "properties": { "schema_version": { "type": "string", "const": "intelgeist.company_identifiers.v1" }, "generated_at": { "type": "string", "format": "date-time" }, "query": { "type": "object", "properties": { "lei": { "type": "string", "pattern": "^[A-Z0-9]{20}$" }, "cik": { "type": "string", "pattern": "^[0-9]{1,10}$" }, "domain": { "type": "string" }, "jurisdiction": { "type": "string" } }, "required": [], "additionalProperties": false, "minProperties": 1, "description": "Echo of the request body (exactly one of lei, cik, domain on the paid routes)." }, "resolved": { "type": "object", "properties": { "org_id": { "type": "string", "format": "uuid" }, "legal_name": { "type": "string" }, "match": { "type": "object", "properties": { "method": { "type": "string" }, "score": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "method", "score" ], "additionalProperties": true } }, "required": [ "org_id", "legal_name", "match" ], "additionalProperties": true }, "identifiers": { "type": "object", "properties": { "ids": { "type": "array", "items": { "type": "object", "properties": { "scheme": { "type": "string" }, "qualifier": { "type": "string" }, "value": { "type": "string" }, "link_method": { "type": [ "string", "null" ] }, "link_confidence": { "type": [ "number", "null" ] }, "source_snapshot_id": { "type": [ "integer", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "scheme", "qualifier", "value", "source", "as_of" ], "additionalProperties": true }, "minItems": 1 }, "registry_ids": { "type": "array", "items": { "type": "object", "properties": { "registry": { "type": "string" }, "registry_id": { "type": "string" }, "link_method": { "type": [ "string", "null" ] }, "link_confidence": { "type": [ "number", "null" ] }, "source": { "type": "string" }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "registry", "registry_id", "source", "as_of" ], "additionalProperties": true } }, "domain": { "type": [ "object", "null" ], "properties": { "value": { "type": "string" }, "link_confidence": { "type": [ "number", "null" ] }, "source": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "value", "source", "as_of" ] } }, "required": [ "ids", "registry_ids", "domain" ], "additionalProperties": true }, "coverage": { "type": "object", "properties": { "scope": { "type": "string" }, "checked": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "as_of": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "as_of", "stale" ], "additionalProperties": true } }, "records_found_in": { "type": "array", "items": { "type": "string" } }, "no_record_found_in": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" }, "full_profile": { "type": "string", "format": "uri" } }, "required": [ "scope", "checked", "records_found_in", "no_record_found_in", "note", "full_profile" ], "additionalProperties": true }, "sources": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "name": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "license": { "type": [ "string", "null" ] }, "attribution": { "type": [ "string", "null" ] }, "modification_note": { "type": "string" }, "source_reliability": { "type": [ "string", "null" ], "enum": [ "A", "B", "C", "D", "E", "F", null ] } }, "required": [ "source", "name", "version", "retrieved_at", "published_at", "license", "attribution", "modification_note", "source_reliability" ], "additionalProperties": true }, "minItems": 1 }, "notice": { "type": "object", "properties": { "summary": { "type": "string", "description": "Verbatim notice: informational only, AS IS, no warranty, not an FCRA consumer report." }, "sanctions": { "type": "string", "description": "Verbatim sanctions caveat: a possible match is not a legal determination; no match is not a guarantee." }, "data_as_of": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "version": { "type": [ "string", "null" ] }, "retrieved_at": { "type": [ "string", "null" ], "format": "date-time" }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "stale": { "type": "boolean" } }, "required": [ "source", "version", "retrieved_at", "published_at", "stale" ], "additionalProperties": true } }, "terms_url": { "type": "string", "format": "uri" }, "terms_version": { "type": "string" } }, "required": [ "summary", "sanctions", "data_as_of", "terms_url", "terms_version" ], "additionalProperties": true } }, "required": [ "schema_version", "generated_at", "query", "resolved", "identifiers", "coverage", "sources", "notice" ], "additionalProperties": false }, "example": { "schema_version": "intelgeist.company_identifiers.v1", "resolved": { "legal_name": "Apple Inc.", "match": { "method": "domain_exact", "score": 1.0 } }, "identifiers": { "ids": [ { "scheme": "CIK", "value": "320193", "link_confidence": 0.95, "source": "sec_submissions" }, { "scheme": "LEI", "value": "HWUPKR0MPOU8FGXBT394", "link_confidence": 1.0, "source": "gleif_l1" }, { "scheme": "QID", "value": "Q312", "link_confidence": 0.95, "source": "wikidata_xwalk" } ], "domain": { "value": "apple.com", "link_confidence": 1.0, "source": "gleif_l1" } }, "notice": { "terms_url": "https://api.intelgeist.ai/terms", "terms_version": "2026-09-13" } } } } }, "402": { "description": "Payment required (PAYMENT-REQUIRED header), or settlement did not complete (no data delivered)" }, "404": { "description": "Company not found in the loaded sources (coverage gap, not a clean result). Not charged." }, "409": { "description": "Payment authorization already used or still in flight. Not charged again." }, "422": { "description": "Invalid parameters (exactly one of lei, cik, domain). Not charged." }, "429": { "description": "Rate limited. Not charged." }, "502": { "description": "Backend failure. Not charged." } } } } } }