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

# Overview

> Read-only access to on-chain payment transactions.

Transaction IDs use `txn_...` opaque tokens.

## Authentication

```
Authorization: Bearer sk_live_...
```

**Scope:** `transactions:read` (legacy `payments:read` is no longer accepted).

***

## List transactions

`GET /v1/transactions`

Cursor pagination. Optional filters: `invoice_id` (`inv_...`), `type`, `status`.

Rate limit: read bucket (`observe`).

***

## Retrieve transaction

`GET /v1/transactions/{id}`

Path id: `txn_...`.

***

## Lookup by hash

`GET /v1/transactions/by-hash/{transactionHash}`

On-chain hash lookup within the store scope.

***

## Invoice transactions

`GET /v1/invoices/{id}/transactions`

Lists transactions linked to invoice `inv_...`. Requires `transactions:read`.

### Example (Node.js)

```javascript theme={null}
const res = await fetch(
  `https://api.meum.io/v1/invoices/${invoiceId}/transactions`,
  { headers: { Authorization: `Bearer ${apiKey}` } }
);
```

Money fields (`amount`) are always strings in JSON responses.