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

# Taeh API

> Read-only API access for approved third-party integrations.

## Overview

Taeh provides read-only API access for approved third-party integrations.
Use the API to search people records from the current open event or from a
specific event when you provide an `eventId`.

<Note>
  API access is managed through API clients and keys in the Taeh dashboard.
  Keys are shown once when created and are stored only as hashes.
</Note>

## Available endpoints

<CardGroup cols={2}>
  <Card title="Search people" icon="users" href="/people/search">
    Search lost, found, and delivered people records with an API client key.
  </Card>
</CardGroup>

## Shared behavior

* Authentication uses `Authorization: Bearer orion_live_<keyId>_<secret>`.
* API client requests are audited.
* API clients only receive access to scopes assigned to their key.
* The People endpoint requires the `people:read` scope.

## Request conventions

* JSON property names are `camelCase`.
* Enum query values use names such as `Male`, `Female`, `Lost`, `Found`, and `Delivered`.
* IDs are ULIDs.

## Next pages

<CardGroup cols={2}>
  <Card title="Search people" icon="users" href="/people/search">
    Learn how to search people records with an API client key.
  </Card>
</CardGroup>