---
title: "List all Transaction Records"
method: GET
path: "/2024-09/transaction_records"
tags: ["Transaction Records"]
---

# List all Transaction Records

`GET /2024-09/transaction_records`

## Request

- Base URL: `https://public-api.easyship.com`
- URL: `https://public-api.easyship.com/2024-09/transaction_records`
- Auth: HTTP bearer

Retrieve a list of all transactions within range.
Pagination of this endpoint is not indexed.
`count` on the response body will always be `null`.

Required authorization scope: `public.transaction_record:read`

## Query parameters

- `page` integer
- `per_page` integer
- `from_date` string, date
- `to_date` string, date
- `days_from_now` integer
- `easyship_shipment_id` EasyshipShipmentId (unresolved $ref)
- `adjustment` boolean
- `type` 'shipment' | 'pickup' | 'claim' | 'policy' | 'payment'

## Response `200`

list of transactions

- union
  - object: List of Transaction Records
    - `transaction_records` TransactionRecord[]
      - `id` string, uuid: ID of transaction record
      - `adjustment_type` 'Refund after Cancellation' | 'Remote Area Surcharge (ODA Reconciliation)' | 'Declared Value Revaluation (Tax Reconciliation)' | 'Adjustment based on Weight (Weight Reconciliation)' | 'Payment of Tax & Duty on behalf of Consignee' | 'Return Fees' | 'Declared Value Revaluation' | 'Address Correction Fee' | 'Refund (100%)' | 'Residential Area Surcharge' | 'Charge After Refund' | 'Warehouse Handling Fee' | 'Refund for Fixed Shipment' | 'Charge for Fixed Shipment' | 'Refund (50%)' | 'Oversized Surcharge' | 'Refund - Damaged' | 'Refund - Lost' | 'Pay On Scan' | 'Tax & Duty Adjustment by Courier Invoice' | 'Account Consolidation' | 'Others' | 'Bank Account Charge Failed' | 'Pay by Bank Cashback', nullable: Type of adjustment
      - `amount` number: Amount of adjustment
      - `description` string, nullable: Description of adjustment
      - `payment_recipient` string: Recipient of payment
      - `settled_at` string, date-time, nullable: Date and time of settlement
      - `easyship_shipment_id` string, nullable: Readable identifier prefixed with ES (Easyship) and destination country code
    - `meta` MetaWithPagination
      - `pagination` Pagination: Pagination
        - `next` integer, nullable
        - `count` integer, nullable: The total number of items. The `null` value is used with countless pagination (used for faster response on large datasets, like shipments).
        - `page` integer: Current page
      - `request_id` string: An unique ID represent the request.
  - string: Transaction Records in CSV format

## Other responses

- `422`: failed validations

## Changes

- **2026-11-03** `b47b54b748a7`: 6 warning
  - added the new `Bank Account Charge Failed` enum value to the `oneOf[subschema #1]/transaction_records/items/adjustment_type` response property for the response status `200` (media type: application/json)
  - added the new `Bank Account Charge Failed` enum value to the `oneOf[subschema #1]/transaction_records/items/adjustment_type` response property for the response status `200` (media type: text/csv)
  - added the new `Pay by Bank Cashback` enum value to the `oneOf[subschema #1]/transaction_records/items/adjustment_type` response property for the response status `200` (media type: application/json)
  - added the new `Pay by Bank Cashback` enum value to the `oneOf[subschema #1]/transaction_records/items/adjustment_type` response property for the response status `200` (media type: text/csv)
  - …2 more

[Operation history](https://skmtc.dev/easyship/apis/easyship-public-api/changes/2024-09/transaction_records/get.md)

---

[API](https://skmtc.dev/easyship/apis/easyship-public-api.md) - [All operations](https://skmtc.dev/easyship/apis/easyship-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyship/apis/easyship-public-api/revisions/b47b54b748a7?raw)