# Transaction Status Filters

**Filter by transaction status**  
`DECLINED`, `EXPIRED`, `PENDING`, `RETURNED`, `REVERSED`, `SETTLED`, `VOIDED`

**Filter by transaction result**  
`APPROVED`, `DECLINED`

# Transaction Details

### Financial Account Token
- Filter by financial account token

### Business Account Token
- Filter by business account token

### Account Token
- Filter by account token

### Transaction Category
**Filter by transaction category**  
`ACH`, `WIRE`, `BALANCE_OR_FUNDING`, `FEE`, `REWARD`, `ADJUSTMENT`, `DERECOGNITION`, `DISPUTE`, `CARD`, `EXTERNAL_ACH`, `EXTERNAL_CHECK`, `EXTERNAL_FEDNOW`, `EXTERNAL_RTP`, `EXTERNAL_TRANSFER`, `EXTERNAL_WIRE`, `MANAGEMENT_ADJUSTMENT`, `MANAGEMENT_DISPUTE`, `MANAGEMENT_FEE`, `MANAGEMENT_REWARD`, `MANAGEMENT_DISBURSEMENT`, `HOLD`, `PROGRAM_FUNDING`

### Date Filters
- **begin**: Date string in RFC 3339 format.
- **ending_before**: A cursor representing an item's token before which a page of results should end.
- **end**: Date string in RFC 3339 format.
- **page_size**: Page size for pagination.
- **starting_after**: A cursor representing an item's token after which a page of results should begin.

# Response Structure

### 200 Successful response with unified transaction data
**object**  
A response containing a list of transactions

- **has_more**: `boolean` (required)
  - Indicates if there are more transactions available for pagination

- **data**: `array of objects` (required)
  - List containing all transaction types in the ledger service:
  - **status**: `string` (required)
    - The status of the transaction  
    `PENDING`, `SETTLED`, `DECLINED`, `REVERSED`, `CANCELED`, `RETURNED`
  - **token**: `uuid` (required)
    - Unique identifier for the transaction
  - **created**: `date-time` (required)
    - ISO 8601 timestamp of when the transaction was created
  - **updated**: `date-time` (required)
    - ISO 8601 timestamp of when the transaction was last updated
  - **family**: `const` (required)
    - `INTERNAL`
  - **category**: `string` (required)
    - Transaction category
  - **result**: `string` (required)
    - Transaction result
  - **currency**: `string` (required)
    - Currency of the transaction, represented in ISO 4217 format
  - **settled_amount**: `integer` (required)
    - Settled amount in cents
  - **pending_amount**: `integer` (required)
    - Pending amount in cents
  - **events**: `array of objects` (required)
    - List of financial events
  - **descriptor**: `string` (required)
    - Transaction descriptor
  - **financial_account_token**: `uuid` (required)
    - Financial account token associated with the transaction

### Sample Transaction Response
```json
{
  "has_more": true,
  "data": [
    {
      "status": "PENDING",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created": "2026-07-18T00:25:34.410Z",
      "updated": "2026-07-18T00:25:34.410Z",
      "family": "INTERNAL",
      "category": "ACH",
      "result": "APPROVED",
      "currency": "USD",
      "settled_amount": 200,
      "pending_amount": 500,
      "events": [
        {
          "amount": 0,
          "created": "2026-07-18T00:25:34.410Z",
          "result": "APPROVED",
          "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "type": "ACH_ORIGINATION_CANCELLED"
        }
      ],
      "descriptor": "Transaction Descriptor",
      "financial_account_token": "0cc87075-57cf-4607-8722-f42e2cb2c0cd"
    }
  ]
}
```

### Error Responses
- `400 Bad request`  
- `401 Unauthorized`  
- `403 Forbidden`  
- `500 Internal server error`

**Updated 3 months ago**