---
title: "Get Transactions"
method: GET
path: "/transactions/"
tags: ["Transactions"]
---

# Get Transactions

`GET /transactions/`

## Request

- Base URL: `https://api.envelopebudget.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.envelopebudget.com/transactions/`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2 (password, token URL `token`)

Returns all transactions associated with the currently authenticated user.

Args:
- offset (int, optional): The starting index of transactions to return.
- limit (int, optional): Max number of transactions to return.
- pending (bool, optional): If True, only transactions with a null `envelope_id` will be returned.

Returns:
- A list of transactions associated with the currently authenticated user.

## Query parameters

- `offset` integer
- `limit` integer: Max number of transactions to return. Max limit is 100.
- `pending` boolean
- `cleared` boolean

## Response `200`

Successful Response

- TransactionResponse
  - `transactions` Transaction[], required
    - `id` integer, required
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `account` integer, required
    - `account_name` string, required
    - `date` string, date, required
    - `amount` number, required
    - `payee` string, required
    - `number` string
    - `memo` string
    - `cleared` boolean, required
    - `uid` string
    - `envelope` integer
  - `total` integer, required
  - `pages` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/envelopebudget/apis/envelopebudget-api.md) · [All operations](https://skmtc.dev/envelopebudget/apis/envelopebudget-api/llms.txt) · [OpenAPI document](https://skmtc.dev/envelopebudget/apis/envelopebudget-api/revisions/0988535610ff?raw)