# PermitCore

## Docs

- [API reference overview](https://docs.permitcore.io/api-reference/introduction.md): Base URL, versioning, auth conventions, and the endpoint catalog.
- [GET /v1/jurisdictions/{slug}/cohorts/distribution](https://docs.permitcore.io/api-reference/jurisdictions/cohort-distribution.md): Per-jurisdiction breakdown across the canonical 18 cohorts. Cached 1 hour.
- [Jurisdictions resource](https://docs.permitcore.io/api-reference/jurisdictions/overview.md): Overview of jurisdiction-scoped endpoints. Slug conventions, status field, listing endpoint contract.
- [API key management](https://docs.permitcore.io/api-reference/keys.md): Programmatic key creation, listing, revocation, + per-key usage telemetry. Coming with the Bucket 2 data-pipeline release (~3 weeks).
- [Permits (listing endpoint)](https://docs.permitcore.io/api-reference/permits.md): Paginate permit rows by jurisdiction × cohort × date. Coming with the Bucket 2 data-pipeline release (~3 weeks).
- [Authentication](https://docs.permitcore.io/authentication.md): Bearer-token auth via API key. Key formats, header conventions, security guidance.
- [Changelog](https://docs.permitcore.io/changelog.md): Versioned release notes for the PermitCore API + docs site.
- [Cohorts](https://docs.permitcore.io/concepts/cohorts.md): The canonical 18-cohort taxonomy that PermitCore's pipeline classifies every permit into.
- [Data freshness](https://docs.permitcore.io/concepts/data-freshness.md): Daily refresh cadence, the `as_of_utc` timestamp, and field-level data-quality flags.
- [Data licensing](https://docs.permitcore.io/concepts/data-licensing.md): What you can and can't do with PermitCore data. Public-record source columns vs PermitCore-enriched columns, commercial use, and attribution.
- [Jurisdictions](https://docs.permitcore.io/concepts/jurisdictions.md): What a jurisdiction is, the 26-metro coverage map today, and the MAPPED / SOURCE / DEPLOY-PENDING status model.
- [Rate limits](https://docs.permitcore.io/concepts/rate-limits.md): Per-tier monthly quotas, `429 Too Many Requests` handling, and the Bucket 2 tier-aware enforcement roadmap.
- [Errors](https://docs.permitcore.io/errors.md): Canonical error codes, response shape, and retry guidance for every non-2xx response.
- [Welcome to PermitCore](https://docs.permitcore.io/introduction.md): Daily-refreshed US building-permit data with field-level provenance and a canonical 18-cohort taxonomy.
- [Quickstart](https://docs.permitcore.io/quickstart.md): Sign up, grab a key, make your first request. Five minutes.

## OpenAPI Specs

- [openapi](https://docs.permitcore.io/api-reference/openapi.json)