Skip to main content
GET
/
Experimental
/
invoices
Get Invoices
curl --request GET \
  --url https://gateway-dev.shipbob.dev/Experimental/invoices \
  --header 'Authorization: Bearer <token>'
{
  "first": "m8cUk/xJkbeYp2JJvL8oHqxL2hFuGz3qjqtkQ",
  "items": [
    {
      "amount": 0.01,
      "currencyCode": "USD",
      "invoiceDate": "2019-08-24",
      "invoiceId": 12345,
      "invoiceType": "Shipping",
      "runningBalance": 123.01
    }
  ],
  "last": "n8cUk/xJkbeYp2JJvL8oHqxL2hFiGz3qjqtkQ",
  "next": "m8cUk/xJkbeYp2JhvL8oHqxL3hFiGz3qjqtkQ",
  "prev": "m8cUk/xJkbeYp2JJvL8oHqxL2hFvGz3qjqtkQ"
}

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.

​
fromDate
string<date-time>

[Optional] Start date for filtering invoices by invoice date. Default is current - 1 month date.

​
toDate
string<date-time>

[Optional] End date for filtering invoices by invoice date. Default is current date.

​
invoiceTypes
string[]

[Optional] Filter invoices by invoice type. Valid values: Shipping,WarehouseStorage,Inbound Fee,Return,AdditionalFee,Credits

​
pageSize
number<int32>

Number of invoices to return per page (default: 100). Must be between 1 and 1000.

​
sortOrder
string

Sort invoices by Invoice Date. Values - Ascending, Descending. Default: Descending.

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

Last modified on November 11, 2025