# Attestly API

## Docs

- [List ingested reference sources](https://docs-attestly.code4source.com/api-reference/catalog/list-ingested-reference-sources.md): Returns one entry per source in the registry — eager-ingested and lazy-indexed alike — with aggregate feature count, country coverage, SPDX license, category, and bounding box. Subscription-gated under ``BILLING_ENABLED=true``.
- [Return reference areas within a distance range of a geometry](https://docs-attestly.code4source.com/api-reference/distance/return-reference-areas-within-a-distance-range-of-a-geometry.md): Accepts a GeoJSON Polygon, MultiPolygon, or Point and returns reference areas whose great-circle distance to the input lies in ``[min_distance_m, max_distance_m]`` across all registered datasets. Content is negotiated via the ``Accept`` header:
- [Return reference areas intersecting a geometry](https://docs-attestly.code4source.com/api-reference/intersections/return-reference-areas-intersecting-a-geometry.md): Accepts a GeoJSON Polygon, MultiPolygon, or Point and returns the reference areas that intersect it. No compliance verdict is applied — callers wire their own downstream logic.
- [Evaluate a ruleset against a geometry](https://docs-attestly.code4source.com/api-reference/ruleset-evaluation/evaluate-a-ruleset-against-a-geometry.md): Runs every check in the ruleset against the submitted geometry and returns a verdict with per-check evidence plus reproducibility metadata. Pass either ``ruleset_id`` (catalog reference) or ``ruleset`` (inline body).
- [Create a new catalog ruleset version](https://docs-attestly.code4source.com/api-reference/rulesets/create-a-new-catalog-ruleset-version.md): Persists a ruleset under the declared ``name@version``. Existing ``name@version`` combinations are rejected with 409 — rulesets are immutable once stored. Omitting ``version`` auto-assigns the next integer under that name (``1`` if no prior version exists).
- [Get a specific ruleset version](https://docs-attestly.code4source.com/api-reference/rulesets/get-a-specific-ruleset-version.md)
- [Get the latest version of a ruleset](https://docs-attestly.code4source.com/api-reference/rulesets/get-the-latest-version-of-a-ruleset.md)
- [List catalog rulesets, paginated](https://docs-attestly.code4source.com/api-reference/rulesets/list-catalog-rulesets-paginated.md)
- [Look up an identifier across all subject-register sources](https://docs-attestly.code4source.com/api-reference/subjects/look-up-an-identifier-across-all-subject-register-sources.md): Accepts a typed identifier (``{ type, value }``) and returns every matching entry across all registered ``subject_register`` sources (sanctions lists, ownership registers, etc.). No compliance verdict is applied — callers wire their own downstream logic.
- [Authentication](https://docs-attestly.code4source.com/api/authentication.md): Pass your API key as a Bearer token. That's it.
- [POST /v1/distance](https://docs-attestly.code4source.com/api/distance.md): Find nearest reference features within a radius.
- [POST /v1/evaluate](https://docs-attestly.code4source.com/api/evaluate.md): Run a ruleset and return a compliance verdict.
- [POST /v1/intersections](https://docs-attestly.code4source.com/api/intersections.md): List reference areas that overlap a geometry.
- [Rulesets catalog](https://docs-attestly.code4source.com/api/rulesets.md): Save, list, and inspect rulesets.
- [GET /v1/sources](https://docs-attestly.code4source.com/api/sources.md): List the reference datasets available to your Organization.
- [POST /v1/subjects](https://docs-attestly.code4source.com/api/subjects.md): Match an identifier against subject registers (sanctions, blacklists, registries).
- [Visual builder](https://docs-attestly.code4source.com/authoring/builder.md): Author rulesets visually on the playground — drag nodes, connect them, run them on a map.
- [Ruleset catalog](https://docs-attestly.code4source.com/authoring/catalog.md): Save your ruleset once, reference it by name@version.
- [Examples](https://docs-attestly.code4source.com/authoring/examples.md): Full rulesets for common compliance policies.
- [Ruleset basics](https://docs-attestly.code4source.com/authoring/ruleset-basics.md): Encode your compliance policy as a JSON ruleset.
- [How it works](https://docs-attestly.code4source.com/concepts/how-it-works.md): Geometry → sources → checks → verdict.
- [Sources](https://docs-attestly.code4source.com/concepts/sources.md): The reference datasets your rulesets and queries match against.
- [Verdicts](https://docs-attestly.code4source.com/concepts/verdicts.md): How check outcomes compose into a status + outcome.
- [Introduction](https://docs-attestly.code4source.com/introduction.md): Spatial compliance API for socio-environmental risk.
- [Quickstart](https://docs-attestly.code4source.com/quickstart.md): Make your first compliance check in under a minute.
- [Billing](https://docs-attestly.code4source.com/reference/billing.md): How billable requests are charged, idempotency, and DEGRADED policy.
- [Errors](https://docs-attestly.code4source.com/reference/errors.md): Error codes you may encounter and how to handle them.
- [Quotas & rate limits](https://docs-attestly.code4source.com/reference/quotas.md): How billing periods, monthly caps, and rate limits work.

## OpenAPI Specs

- [openapi](https://docs-attestly.code4source.com/openapi.json)
- [builder](https://docs-attestly.code4source.com/openapi/builder.json)
- [viewer](https://docs-attestly.code4source.com/openapi/viewer.json)