---
title: "Get a list of transactions"
method: GET
path: "/transactions/"
tags: ["Transaction"]
---

# Get a list of transactions

`GET /transactions/`

Lists all transactions for the authenticated account. Requires a secret key.

## Query parameters

- `page_size` integer
- `search` string
- `state` string
- `subscription_id` integer
- `payment_id` integer
- `created_at_after` string, date
- `created_at_before` string, date
- `paid_at_after` string, date
- `paid_at_before` string, date

## Response `200`

Successful operation

- union
  - Transaction[]
    - `uuid` string, uuid
    - `data` object — Arbitrary data on transaction from payment processor
    - `state` 'failed' | 'settled' | 'inital' | 'pending' | 'canceled' | 'refunded'
    - `amount` string
    - `currency` string
  - TransactionPaginated
    - `count` integer
    - `next` string
    - `previous` string
    - `results` Transaction[]
      - `uuid` string, uuid
      - `data` object — Arbitrary data on transaction from payment processor
      - `state` 'failed' | 'settled' | 'inital' | 'pending' | 'canceled' | 'refunded'
      - `amount` string
      - `currency` string

## Other responses

- `400` — Invalid status value

---

[API](https://skmtc.dev/askell/apis/a-skell-api.md) · [All operations](https://skmtc.dev/askell/apis/a-skell-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/askell/a-skell-api/revisions/9234f937fa26/schema)