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

# API Overview

> Read-only API for accessing your MyTruv financial data programmatically.

## Authentication

Authenticate with a personal access token (PAT) sent as a Bearer token:

```
Authorization: Bearer <your_access_token>
```

Tokens are prefixed with `pat_` and are issued in the MyTruv web app under Settings > API keys. Log in at [app.mytruv.com](https://app.mytruv.com/login) to generate one.

### Example request

```bash theme={null}
curl -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.mytruv.com/v1/user
```

<Warning>
  Keep your access token secure!

  * Never expose your token in client-side code
  * Don't commit credentials to version control
  * Use environment variables in production
  * Tokens are shown once at creation - store them right away. If lost, rotate the token from Settings > API keys.
</Warning>

***

## Base URL

All API requests use the same base URL:

```
https://api.mytruv.com
```

***

## Available endpoints

The API exposes read-only endpoints for retrieving:

* User profile - name, email, phone, and lifecycle status
* Financial data - balances, transactions, income, spending, liabilities, and balance history
* Account links - connected financial institutions and payroll providers

***

## Next steps

<div className="mytruv-card-grid">
  <a className="mytruv-card" href="/api-reference/errors">
    <span className="mytruv-card__icon">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75" strokeLinecap="round" strokeLinejoin="round">
        <circle cx="12" cy="12" r="10" />

        <path d="M12 8v4" />

        <path d="M12 16h.01" />
      </svg>
    </span>

    <h3 className="mytruv-card__title">Errors</h3>
    <p className="mytruv-card__body">HTTP error codes and handling guidance</p>

    <span className="mytruv-card__arrow">
      <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
        <path d="M7 17L17 7" />

        <path d="M8 7h9v9" />
      </svg>
    </span>
  </a>

  <a className="mytruv-card" href="/api-reference/pagination">
    <span className="mytruv-card__icon">
      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75" strokeLinecap="round" strokeLinejoin="round">
        <path d="M5 12h14" />

        <path d="M12 5l7 7-7 7" />
      </svg>
    </span>

    <h3 className="mytruv-card__title">Pagination</h3>
    <p className="mytruv-card__body">How to paginate through large result sets</p>

    <span className="mytruv-card__arrow">
      <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
        <path d="M7 17L17 7" />

        <path d="M8 7h9v9" />
      </svg>
    </span>
  </a>
</div>
