List Invoices

List the invoices generated for your Nebula Block credit purchases.

Retrieve a paginated list of your invoices, including details such as the invoice ID, price, invoiced time, and invoice type.

HTTP Request

GET {API_URL}/users/invoices?limit={limit}&offset={offset}

Parameters	Requirements	Type	Description
limit	Optional	int	The number of records to display per page
offset	Optional	int	The starting point for record retrieval (i.e., how many records to skip before starting to display)

Response Attributes

data dict

• invoices: List of user invoices objects.

• total_invoices: total records count of user invoices.

Note: When the account has no invoices at all, data is an empty list rather than an object with these keys, and status is still success. Handle both shapes.

status string

Indicates the result of the request. success signifies success, while failed indicates an error.

message string

A message confirming the successful retrieval of user invoices.

Example

Request

curl -X GET '{API_URL}/users/invoices?limit=2&offset=0'
-H 'Authorization: Bearer {TOKEN/KEY}'

Response

{
    "data": {
        "invoices": [
            {
                "invoiced_time": "EST 2024-10-29 14:19:32",
                "invoice_id": "#NB-20241029181932-266",
                "price": 229.95,
                "type": "Reload",
                "id": 3688,
                "user_id": 266
            },
            {
                "invoiced_time": "EST 2024-10-29 14:18:54",
                "invoice_id": "#NB-20241029181853-266",
                "price": 11.5,
                "type": "Reload",
                "id": 3687,
                "user_id": 266
            },
            {
                "invoiced_time": "EST 2024-10-29 14:15:29",
                "invoice_id": "#NB-20241029181528-266",
                "price": 114.98,
                "type": "Reload",
                "id": 3686,
                "user_id": 266
            }
        ],
        "total_invoices": 3
    },
    "message": "User invoices retrieved successfully",
    "status": "success"
}