GET
/
api
/
invoices
/
curl --request GET \
  --url https://api.uselotus.io/api/invoices/ \
  --header 'Authorization: <api-key>'
[
  {
    "invoice_id": "<string>",
    "invoice_number": "<string>",
    "cost_due": 5000000000,
    "amount": 0,
    "currency": {
      "code": "<string>",
      "name": "<string>",
      "symbol": "<string>"
    },
    "issue_date": "2023-11-07T05:31:56Z",
    "payment_status": "draft",
    "external_payment_obj_id": "<string>",
    "external_payment_obj_type": "stripe",
    "external_payment_obj_status": "<string>",
    "line_items": [
      {
        "name": "<string>",
        "start_date": "2023-11-07T05:31:56Z",
        "end_date": "2023-11-07T05:31:56Z",
        "quantity": 5000000000,
        "billing_type": "in_arrears",
        "metadata": {},
        "plan": {
          "plan_name": "<string>",
          "plan_id": "<string>",
          "version_id": "<string>",
          "version": 123
        },
        "subscription_filters": [
          {
            "value": "<string>",
            "property_name": "<string>"
          }
        ],
        "base": 0,
        "adjustments": [
          {
            "amount": "<string>",
            "account": "<string>",
            "adjustment_type": "sales_tax"
          }
        ],
        "amount": 0,
        "subtotal": 0
      }
    ],
    "customer": {
      "customer_name": "<string>",
      "email": "jsmith@example.com",
      "customer_id": "<string>",
      "address": {
        "city": "<string>",
        "country": "AW",
        "line1": "<string>",
        "line2": "<string>",
        "postal_code": "<string>",
        "state": "<string>"
      }
    },
    "due_date": "2023-11-07T05:31:56Z",
    "start_date": "2023-12-25",
    "end_date": "2023-12-25",
    "seller": {
      "name": "<string>",
      "address": {
        "city": "<string>",
        "country": "AW",
        "line1": "<string>",
        "line2": "<string>",
        "postal_code": "<string>",
        "state": "<string>"
      },
      "phone": "<string>",
      "email": "jsmith@example.com"
    },
    "invoice_pdf": "<string>"
  }
]

Retrieves an array of invoice objects.

lotus.list_invoices(
    customer_id="cus_1234567890",
)

lotus.list_invoices(
    status=["unpaid"],
)

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

​
customer_id
string | null

A filter for invoices for a specific customer

Minimum length: 1
​
payment_status
enum<string>[]

A filter for invoices with a specific payment status

Response

200 - application/json

The response is of type object[].