Skip to main content
GET
/
public
/
{user_id}
/
invoices
List Invoices
curl --request GET \
  --url https://apigw.ipxo.com/ecommerce/public/{user_id}/invoices \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "uuid": "a13651d4-0940-411c-8935-ac80fc3c3ddd",
      "reference": "INV845kv",
      "status": "sent",
      "placed_at": "2025-10-23T22:02:48.0000000+00:00",
      "sub_total": {
        "currency": "USD",
        "amount": "3774.00",
        "amount_minor": 377400
      },
      "discount_total": {
        "currency": "USD",
        "amount": "269.00",
        "amount_minor": 26900
      },
      "tax_total": {
        "currency": "USD",
        "amount": "206.00",
        "amount_minor": 20600
      },
      "credits_total": {
        "currency": "USD",
        "amount": "0.00",
        "amount_minor": 0
      },
      "total": {
        "currency": "USD",
        "amount": "3711.00",
        "amount_minor": 371100
      },
      "total_before_tax": {
        "currency": "USD",
        "amount": "0.00",
        "amount_minor": 0
      },
      "invoicable_id": "4538d276-3428-3c35-837d-d7f4f1ab8be8",
      "invoicable_type": "order"
    },
    {
      "uuid": "a13651d4-1a4d-4ae5-b715-b06849287976",
      "reference": "INV292ep",
      "status": "sent",
      "placed_at": "2025-07-16T10:52:43.0000000+00:00",
      "sub_total": {
        "currency": "USD",
        "amount": "3665.00",
        "amount_minor": 366500
      },
      "discount_total": {
        "currency": "USD",
        "amount": "876.00",
        "amount_minor": 87600
      },
      "tax_total": {
        "currency": "USD",
        "amount": "885.00",
        "amount_minor": 88500
      },
      "credits_total": {
        "currency": "USD",
        "amount": "0.00",
        "amount_minor": 0
      },
      "total": {
        "currency": "USD",
        "amount": "3674.00",
        "amount_minor": 367400
      },
      "total_before_tax": {
        "currency": "USD",
        "amount": "0.00",
        "amount_minor": 0
      },
      "invoicable_id": "83de5562-bbb2-357b-95cd-2ff24f783d15",
      "invoicable_type": "order"
    }
  ],
  "meta": {
    "current_page": 1,
    "total": 2,
    "per_page": 10
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
user_id
string
required

The ID of the user.

Query Parameters

​
sort
enum<string>

A comma-separated list of fields to sort. Multiple allowed. Prefix with - to sort descending.

Available options:
placed_at
Example:

"placed_at"

​
filter[invoicable_id]
string
Example:

"4cdf32b8-47e2-4714-88b4-9ab307a097f9"

​
filter[invoicable_type]
string
Example:

"order"

​
filter[uuid]
string
Example:

"4cdf32b8-47e2-4714-88b4-9ab307a097f9"

​
filter[status]
string
Example:

"paid"

​
filter[placed_at]
string
Example:

"2023-10-07T12:16:27+00:00"

Response

200 - application/json
​
data
object[]
Example:
[
  {
    "uuid": "a13651d4-0940-411c-8935-ac80fc3c3ddd",
    "reference": "INV845kv",
    "status": "sent",
    "placed_at": "2025-10-23T22:02:48+00:00",
    "sub_total": {
      "currency": "USD",
      "amount": "3774.00",
      "amount_minor": 377400
    },
    "discount_total": {
      "currency": "USD",
      "amount": "269.00",
      "amount_minor": 26900
    },
    "tax_total": {
      "currency": "USD",
      "amount": "206.00",
      "amount_minor": 20600
    },
    "credits_total": {
      "currency": "USD",
      "amount": "0.00",
      "amount_minor": 0
    },
    "total": {
      "currency": "USD",
      "amount": "3711.00",
      "amount_minor": 371100
    },
    "total_before_tax": {
      "currency": "USD",
      "amount": "0.00",
      "amount_minor": 0
    },
    "invoicable_id": "4538d276-3428-3c35-837d-d7f4f1ab8be8",
    "invoicable_type": "order"
  },
  {
    "uuid": "a13651d4-1a4d-4ae5-b715-b06849287976",
    "reference": "INV292ep",
    "status": "sent",
    "placed_at": "2025-07-16T10:52:43+00:00",
    "sub_total": {
      "currency": "USD",
      "amount": "3665.00",
      "amount_minor": 366500
    },
    "discount_total": {
      "currency": "USD",
      "amount": "876.00",
      "amount_minor": 87600
    },
    "tax_total": {
      "currency": "USD",
      "amount": "885.00",
      "amount_minor": 88500
    },
    "credits_total": {
      "currency": "USD",
      "amount": "0.00",
      "amount_minor": 0
    },
    "total": {
      "currency": "USD",
      "amount": "3674.00",
      "amount_minor": 367400
    },
    "total_before_tax": {
      "currency": "USD",
      "amount": "0.00",
      "amount_minor": 0
    },
    "invoicable_id": "83de5562-bbb2-357b-95cd-2ff24f783d15",
    "invoicable_type": "order"
  }
]
​
meta
object