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

# List all Transaction Records

`GET /2024-09/transaction_records`

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' | 'Account Consolidation' | 'Others', 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

---

[API](https://skmtc.net/easyship/apis/easyship-public-api.md) · [All operations](https://skmtc.net/easyship/apis/easyship-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/easyship/easyship-public-api/revisions/71d737a5fcbf/schema)
