> ## Documentation Index
> Fetch the complete documentation index at: https://docs.us.housr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Discover, manage, and redeem exclusive perks for your users.

# Housr Perks API

The Housr Perks API lets you browse, manage, and redeem perks for your users.\
All endpoints require `Authorization: Bearer <token>` over HTTPS, except `health-check` and `/auth/token`.

## Base URLs

* **Production:** `https://v2.api.us.housr.com/partners`
* **Sandbox:** `https://v2.staging.api.us.housr.com/partners`

## What’s inside

* **Hourly-expiring token** via HTTP Basic to `/auth/token`
* **Perks**: list, get
* **Redemptions**: redemption endpoint
* **Categories** and **User perks**
* **Consistent pagination, filtering & sorting**

## Quick start

1. [Get a token](/api-reference/auth/get-bearer-token)
2. Hit the [Perks endpoints](/api-reference/perks/get-perks) with your Bearer token