---
title: "List all Billing Document's Transaction Records"
method: GET
path: "/2024-09/billing_documents/{id}/transaction_records"
tags: ["Billing Documents"]
---

# List all Billing Document's Transaction Records

`GET /2024-09/billing_documents/{id}/transaction_records`

## Request

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

Retrieve a list of all billing document's transactions.
Pagination of this endpoint is not indexed.
`count` on the response body will always be `null`.

Required authorization scope: `public.transaction_record:read`

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `from_date` string, date
- `to_date` string, date

## Response `200`

list of billing document's transaction records

- 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

## Changes

- **2026-11-03** `b47b54b748a7`: 3 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`
  - 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`
  - added the new `Tax & Duty Adjustment by Courier Invoice` enum value to the `oneOf[subschema #1]/transaction_records/items/adjustment_type` response property for the response status `200`

[Operation history](https://skmtc.dev/easyship/apis/easyship-public-api/changes/2024-09/billing_documents/:id/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)
