Corporate Entities
Operational beta, read-only corporate identity graph and intelligence API for canonical ecgc identifiers, resolution, provenance, relationships, financial and XBRL facts, history, analytics, the SEC EDGAR filing catalogue and archived filing documents, registries, schools, and nearby incidents.
Integration
https://corporations.datasourceapi.comOpenhttps://corporations.datasourceapi.com/api/v1/docsOpenhttps://corporations.datasourceapi.com/openapi.jsonOpenhttps://corporations.datasourceapi.com/api/v1/statusOpenhttps://github.com/coopalliance/cca-entitiesOpenhttps://services.datasourceapi.com/api/v1/services/entitiesOpenhttps://services.datasourceapi.com/services/entities.mdOpenAuthentication: No authentication is required for documented public read operations; administration and deep operational status remain private.
Capabilities
Provenance and freshness
- CCA Entities production contract: Version 0.1.0 implementation, OpenAPI contract, aliases, documentation, llms.txt, RFC 9727 catalog, and ETag behavior verified at repository commit 5e88d1fe1c71bd08c1f5d117723292a7574a099d. The live OpenAPI document publishes 46 GET operations; deep readiness, capacity, and administration routes are deliberately excluded from this catalog. Source
- Published SEC EDGAR releases: Live public status verified 2026-09-08 reports seven complete releases, no active release, one open conflict, 8,006 entities, and 39,480 identifiers; the latest sec-edgar cycle is 2026-09-04 and capacity is healthy and fresh with the largest shard role at 13.79 percent of the D1 cap. Source
- SEC EDGAR filing catalogue coverage: Filing coverage reports 18,738,157 catalogued filings filed between 1993-02-11 and 2026-09-04 across eight filing shards, with 14,665 archived documents totaling about 254 GB of immutable object storage and no degraded shard. Source
- Published data limitations: Documents material and known limits for contractor headcount, private-company financials, EIN and domain coverage, registry variation, and release-based rather than real-time freshness. Source
- Machine-readable API discovery: Live OpenAPI 3.1, HTML documentation, llms.txt, and RFC 9727 linkset describe the public read-only integration surface. Source
Update cadence: The populated SEC EDGAR source is checked daily and published through immutable, release-based cycles; the current cycle is 2026-09-04. Other configured sources range from continuous and daily to weekly, monthly, as-needed, or jurisdiction-dependent and are not claimed as populated.
Metadata verified: 2026-09-08
Governance: Production version 0.1.0 remains beta but is operational: seven complete SEC releases publish 8,006 entities and 39,480 identifiers, with one open conflict and no active release. The cca-entities service owns the ecgc namespace. Public status is sanitized, topology-safe, and fresh; deep readiness, per-shard capacity, administration, and release mutation remain private. Public reads are mirror-only and release-based rather than real-time. Current populated coverage is SEC EDGAR; configured GLEIF, IRS Exempt Organizations, state registry, Wikidata, and CCA sources do not imply populated coverage. The filing catalogue indexes 18,738,157 filings, but only 14,665 filing documents are archived, so document retrieval is sparse relative to the index. Private-company financials, contractor headcount, EINs, domains, and registry fields remain incomplete, provenance-dependent, and may be null. No corpus completeness is claimed.
Agent readiness
OpenAPI 3.1, HTML documentation, llms.txt, RFC 9727 discovery, examples, upstream operation identifiers, provenance, limitations, and topology-safe status are live, and 41 public read operations are cataloged. Agent use must remain source- and release-aware because version 0.1.0 is beta, only SEC EDGAR is populated, filing-document archival is sparse relative to the index, and documented fields may be null.
Example queries
Service status
Inspect the topology-safe public corpus, release, source, and capacity summary.
GET https://corporations.datasourceapi.com/api/v1/statusSearch entities
Search the current published release for Apple and return one matching canonical entity.
GET https://corporations.datasourceapi.com/api/v1/search?q=Apple&limit=1Canonical entity
Read the current canonical entity bundle for the Apple Inc. entity in the initial SEC release.
GET https://corporations.datasourceapi.com/api/v1/entities/ecgc-b2psffdc85laEntity analytics
Aggregate the current published entity projection by entity type.
GET https://corporations.datasourceapi.com/api/v1/analytics?group_by=entity_type&metric=countFiling catalogue coverage
Report indexed filing counts, archived document coverage, and filed-date range for the SEC EDGAR catalogue.
GET https://corporations.datasourceapi.com/api/v1/filings/coverage