# HFSAA Developer

> Documentation for the HFSAA public directory API.

- [HFSAA Public API](https://hfsaa.mintlify.app/index.md): A public directory API for HFSAA-certified restaurants, meat markets, and dining halls.
- [Getting started](https://hfsaa.mintlify.app/getting-started.md): Use the HFSAA Public API.
- [API access administration](https://hfsaa.mintlify.app/admin-operations.md): Review applications and control HFSAA Developer API keys.
- [Google Forms intake setup](https://hfsaa.mintlify.app/google-forms-setup.md): Connect the public API application form to the HFSAA Worker.
- [AI integration guide](https://hfsaa.mintlify.app/ai-integration-guide.md): A precise implementation guide for people and AI coding agents using the HFSAA Public API.
- [Data policy](https://hfsaa.mintlify.app/data-policy.md): Permitted uses, verification requirements, and freshness rules for HFSAA public API data.
- [List locations](https://hfsaa.mintlify.app/api-reference/locations/list-locations.md): Returns HFSAA-certified directory locations across all supported types.
- [Get a location](https://hfsaa.mintlify.app/api-reference/locations/get-a-location.md): Returns a single HFSAA-certified directory location by its opaque HFSAA ID.
- [List chapters](https://hfsaa.mintlify.app/api-reference/chapters/list-chapters.md): Returns HFSAA chapters represented by public directory locations.
- [Get dataset metadata](https://hfsaa.mintlify.app/api-reference/metadata/get-dataset-metadata.md): Returns metadata about the directory dataset and API contract.
- [Download a dataset snapshot](https://hfsaa.mintlify.app/api-reference/metadata/download-a-dataset-snapshot.md): Downloads the exact immutable JSON artifact identified by a dataset version. Use the version-specific URL returned by GET /v1/dataset to ensure the checksum and artifact refer to the same snapshot.
- [Check API availability](https://hfsaa.mintlify.app/api-reference/operations/check-api-availability.md): Public liveness check. It returns service status only and never exposes directory data.
- [Open the API access application form](https://hfsaa.mintlify.app/api-reference/developer-access/open-the-api-access-application-form.md)
- [Submit an API access application](https://hfsaa.mintlify.app/api-reference/developer-access/submit-an-api-access-application.md): Sends an email-verification link before the request enters manual HFSAA review.
- [Open the email-verification confirmation page](https://hfsaa.mintlify.app/api-reference/developer-access/open-the-email-verification-confirmation-page.md)
- [Confirm an application email address](https://hfsaa.mintlify.app/api-reference/developer-access/confirm-an-application-email-address.md): Consumes the one-time token only after the person submits the confirmation form, preventing email scanners from using it.
- [Open the API-key claim confirmation page](https://hfsaa.mintlify.app/api-reference/developer-access/open-the-api-key-claim-confirmation-page.md): Does not generate or consume the key until the confirmation form is submitted.
- [Claim an approved API key once](https://hfsaa.mintlify.app/api-reference/developer-access/claim-an-approved-api-key-once.md): Generates the API key at confirmation time. The raw key is returned once and is never stored by HFSAA.
- [Open accountless API-key management](https://hfsaa.mintlify.app/api-reference/developer-access/open-accountless-api-key-management.md): Requests a one-time sign-in link by email; no developer account or password is required.
- [Request a one-time management link](https://hfsaa.mintlify.app/api-reference/developer-access/request-a-one-time-management-link.md): Always returns a generic response so callers cannot discover which email addresses are eligible.
- [List API access applications](https://hfsaa.mintlify.app/api-reference/administration/list-api-access-applications.md)
- [Approve an application and email a one-time claim link](https://hfsaa.mintlify.app/api-reference/administration/approve-an-application-and-email-a-one-time-claim-link.md)
- [Deny an application and email the reason](https://hfsaa.mintlify.app/api-reference/administration/deny-an-application-and-email-the-reason.md)
- [List API keys and current-month usage](https://hfsaa.mintlify.app/api-reference/administration/list-api-keys-and-current-month-usage.md)
- [Inspect usage for an API key](https://hfsaa.mintlify.app/api-reference/administration/inspect-usage-for-an-api-key.md)
- [Revoke an API key and notify its owner](https://hfsaa.mintlify.app/api-reference/administration/revoke-an-api-key-and-notify-its-owner.md)

## OpenAPI Specs

- [openapi](/openapi.yaml)