List Invoices

GET /invoices

Retrieve a paginated collection of Invoices belonging to your Organization

Headers

Authorization string Required

Authorize your API calls with an Arta API token

Query parameters

page integer

Page number of the results to fetch.

Default value is 1.
page_size integer

Results per page (max 50)

Default value is 20.

Responses

200 application/json

A collection of Invoice records
Hide headers attributes Show headers attributes
- content-type string
- x-arta-request-id string
  
  A unique identifier for the Arta API call
Hide response attributes Show response attributes object
- items array[object]
  
  Hide items attributes Show items attributes object
  
  amount_owed string
  
  amount_owed_currency string
  
  amount_paid string
  
  amount_paid_currency string
  
  created_at string
  
  id integer
  
  invoice_url string | null
  
  issued_on string | null
  
  shipment_id string | null
  
  status string
  
  updated_at string
- metadata object
  
  Additional properties are allowed.
  
  Hide metadata attributes Show metadata attributes object
  
  page integer(int64)
  
  page_size integer(int64)
  
  total_count integer(int64)

GET /invoices

curl \
 -X GET https://api.arta.io/invoices \
 -H "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y"

Response examples (200)

# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx

# Payload
{
  "items": [
    {
      "id": 2216,
      "status": "closed",
      "issued_on": "2021-03-10",
      "created_at": "2021-03-10T20:15:34.096258",
      "updated_at": "2021-03-10T20:16:10.202836",
      "amount_owed": "276.91",
      "amount_paid": "276.91",
      "invoice_url": null,
      "shipment_id": "53d6bdec-1eae-46e2-97c2-3e56b1a1095d",
      "amount_owed_currency": "USD",
      "amount_paid_currency": "USD"
    }
  ],
  "metadata": {
    "page": 1,
    "page_size": 20,
    "total_count": 1
  }
}