# Housr API

## Docs

- [Get bearer token](https://docs.us.housr.com/api-reference/auth/get-bearer-token.md): Issue a short-lived bearer token for API authentication. The token expires in approximately 1 hour  and provides access to the Housr API based on your client credentials and associated scopes.
- [Health check](https://docs.us.housr.com/api-reference/health-check/health-check.md)
- [Overview](https://docs.us.housr.com/api-reference/overview.md): Discover, manage, and redeem exclusive perks for your users.
- [Fetch perk categories](https://docs.us.housr.com/api-reference/perks/fetch-perk-categories.md)
- [Get a single perk](https://docs.us.housr.com/api-reference/perks/get-a-single-perk.md)
- [Get list of perks for a user](https://docs.us.housr.com/api-reference/perks/get-list-of-perks-for-a-user.md)
- [Get perks](https://docs.us.housr.com/api-reference/perks/get-perks.md): Browse perks with filters, pagination, and sorting.
- [Redeem a perk for a user](https://docs.us.housr.com/api-reference/perks/redeem-a-perk-for-a-user.md): Redeem a perk for a user.

## OpenAPI Specs

- [openapi](https://docs.us.housr.com/openapi.yaml)