Data and API documentation

The complete directory is available without authentication through stable, cacheable JSON and CSV resources.

Endpoints

Schema stability

Collection responses expose schemaVersion and are described by the machine-readable JSON Schema. Version 1.x uses stable provider IDs and slugs, ISO 8601 calendar dates, typed status and free-tier fields, canonical URLs, and source objects. Additive fields may appear in minor versions; incompatible changes require a major version.

Provenance

Provider-level sources list official destinations. freeTier.source supports the overall offer; allowance, credit, usage, and trial objects also carry claim-level sources with url, type, and accessedAt. Missing market or referral fields mean no supported value was recorded; they are not negative findings.

Caching and access

Responses permit cross-origin GET access and publish cache headers suitable for agents and applications. Consumers should cache responses, identify their user agent, respect robots.txt, and use the envelope-level datasetUpdatedAt plus provider updatedAt values for change detection.

Attribution and license

See the license page. When presenting a claim, link to its canonical provider page and preserve its verification date.