Skip to main content
POST
/
2026-01
/
transactions:query
Search Transactions
curl --request POST \
  --url https://sandbox-api.shipbob.com/2026-01/transactions:query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from_date": "2019-08-24",
  "invoice_ids": [
    "12345"
  ],
  "invoiced_status": true,
  "page_size": 10,
  "reference_ids": [
    "11553288",
    "43-12000928-Pallet00"
  ],
  "reference_types": [
    "FC"
  ],
  "sort_order": "Ascending",
  "to_date": "2019-08-24",
  "transaction_fees": [
    "Kitting Fee",
    "Warehousing Fee"
  ],
  "transaction_types": [
    "Charge"
  ]
}
'
{
  "first": "f8cUk/xJkbeYp2L8oHqxL2hFiGz3qjre",
  "items": [
    {
      "additional_details": {
        "comment": "TestInvoice"
      },
      "amount": 0.09,
      "charge_date": "2025-01-01",
      "currency_code": "USD",
      "fulfillment_center": "Altona VIC",
      "invoice_date": "2025-01-01",
      "invoice_id": 12345,
      "invoice_type": "Shipping",
      "invoiced_status": true,
      "reference_id": "12345",
      "reference_type": "Shipment",
      "taxes": [
        {
          "tax_amount": 0.01,
          "tax_rate": 10,
          "tax_type": "GST"
        }
      ],
      "transaction_fee": "Shipping",
      "transaction_id": "01AN4Z07BY79KA1307SR9X4MV3",
      "transaction_type": "Charge"
    }
  ],
  "last": "f8cUk/xJkbeYp2L8oHqxL2hFiGz3qjqt",
  "next": "f8cUk/xjhyEYp2L8oHqxL2hFiGz3qjqt",
  "prev": "f8cUk/xJkbeYp2L8oHqxL2hFiGz3qjcc"
}

Authorizations

​
Authorization
string
header
required

Authentication using Personal Access Token (PAT) token

Query Parameters

​
Cursor
string

[Optional] A pagination token used to jump to first, last, next or previous pages. When supplied, it overrides all other filter parameters.

Body

application/json

Used to filter transactions based on search criteria. Required if cursor is not provided. Ignored when cursor is present (i.e., for paginated requests).

​
from_date
string<date-time> | null

Start date for filtering transactions by charge date. Defaults to 7 days before the current date if not specified.

​
invoice_ids
string[] | null

List of invoice IDs to filter transactions by.

​
invoiced_status
boolean | null

Filter transactions by invoicing status. True returns billed transactions, false returns unbilled transactions, and null returns both billed and unbilled transactions.

​
page_size
integer<int32>

Number of transactions to return per page. Default is 100. Must be between 1 and 1000.

​
reference_ids
string[] | null

List of reference IDs (such as Shipment IDs, WRO IDs) to filter transactions. Can be numeric or string identifiers.

​
reference_types
enum<string>[] | null

The types of references associated with the reference IDs to filter by.

Available options:
Shipment,
Return,
WRO,
URO
​
sort_order
enum<string>
default:Descending

Sort order for results. Ascending sorts from lowest to highest, Descending sorts from highest to lowest.

Available options:
Ascending,
Descending
​
to_date
string<date-time> | null

End date for filtering transactions by charge date. Defaults to the current date if not specified.

​
transaction_fees
string[] | null

List of transaction fee types to filter by. To get all available transaction fees, use the '/transaction-fees' endpoint.

​
transaction_types
enum<string>[] | null

The classification or nature of the transactions to filter by.

Available options:
Charge,
Refund,
Credit,
Payment,
BalanceAdjustment

Response

Success

​
first
string | null

Go to the first page

​
items
object[] | null
​
last
string | null

Go to the Last page

​
next
string | null

Go to the Next page

​
prev
string | null

Go to the Previous page