Skip to main content
POST
/
2025-07
/
transactions:query
Search transactions
curl --request POST \
  --url https://api.shipbob.com/2025-07/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_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 transaction charge date.

​
invoice_ids
string[] | null

List of invoice IDs to filter transactions

​
invoiced_status
boolean | null

Filter Transactions by invoicing status:

  • True(Billed Transactions)
  • False(Unbilled Transactions)
  • null (Billed + Unbilled Transactions)
​
page_size
integer

Number of transactions to return per page (default is 100, to be entered when API is called for first time). Must be between 1 and 1000.

​
reference_ids
string[] | null

List of reference IDs (like Shipment ID, WRO id) to filter transactions (can be numeric or string identifiers).

​
reference_types
string[] | null

The type of reference associated with the ReferenceId. Available options:

  • Shipment
  • Return
  • WRO
  • URO
​
sort_order
enum<string>
Available options:
Ascending,
Descending
​
to_date
string<date-time> | null

End date for filtering transactions by transaction charge date.

​
transaction_fees
string[] | null
<p>To get all the available transaction fees use this endpoint:- '/transaction-fees'</p>
​
transaction_types
string[] | null

The classification or nature of the transaction Transaction Types - 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