# Listrak Mobile App Push API

> REST API for registering mobile devices and recording engagement events for push notification targeting.
> Base URL `https://api.listrak.com/mobileclient`. Auth: API key — send your key in the `x-api-key` request header.
> This documentation is plain markdown, designed to be fetched and read directly by coding agents.

## Start here
- [Getting started](https://api-docs.tools.listrak.com/apppush/guides/getting-started.md): register a device, patch it, and report engagement events
- [Authentication (API key)](https://api-docs.tools.listrak.com/apppush/guides/authentication.md): x-api-key header; on-device vs backend-proxy trade-off and what the key exposes
- [Errors & retries](https://api-docs.tools.listrak.com/apppush/guides/errors.md): status codes, MobileClientError, and which methods are safe to retry
- [PII & logging](https://api-docs.tools.listrak.com/apppush/guides/pii-logging.md): identifiers and deviceToken are sensitive; deviceUid is the safe handle
- [Copy-paste client & recipes](https://api-docs.tools.listrak.com/apppush/guides/recipes.md): full Python + TypeScript client, token rotation, opt-out, tap attribution

## Other resources
- [app-push-mobile-client-device](https://api-docs.tools.listrak.com/apppush/reference/app-push-mobile-client-device.md): Endpoints to manage app push devices.
- [app-push-mobile-client-engagements](https://api-docs.tools.listrak.com/apppush/reference/app-push-mobile-client-engagements.md): Endpoints to manage app push mobile client engagements.

## Optional
- [Full reference (single file)](https://api-docs.tools.listrak.com/apppush/llms-full.txt): everything concatenated
- [OpenAPI spec](https://api-docs.tools.listrak.com/apppush/openapi.json): machine-readable OpenAPI 3.x