List Invoices

get/invoices

List Invoices

Query ParametersExpand Collapse

subject_id: string

The ID or external ID of the subject to list invoices for.

limit: optional number

maximum100

minimum1

offset: optional number

minimum0

ReturnsExpand Collapse

has_more: boolean

invoices: array of object { id, created_at, hosted_url, 4 more }

id: string

The ID of the invoice.

created_at: string

The date and time the invoice was created.

formatdate-time

hosted_url: string

The URL of the hosted invoice.

line_items: array of object { amount, description, price_in_unit_amount, quantity }

The line items of the invoice.

amount: AmountOutput { currency_code, value }

currency_code: string

The currency code of the amount.

value: string

The value of the amount in the smallest unit of the currency.

description: string

price_in_unit_amount: AmountOutput { currency_code, value }

currency_code: string

The currency code of the amount.

value: string

The value of the amount in the smallest unit of the currency.

quantity: number

status: "draft" or "open" or "paid" or 2 more

The status of the invoice.

Accepts one of the following:

"draft"

"open"

"paid"

"uncollectible"

"void"

subject_id: string

The ID of the subject for the invoice.

total_amount: AmountOutput { currency_code, value }

The total amount of the invoice.

currency_code: string

The currency code of the amount.

value: string

The value of the amount in the smallest unit of the currency.

List Invoices

curl https://api.uselark.ai/invoices \
    -H "X-API-Key: $LARK_API_KEY"

{
  "has_more": false,
  "invoices": [
    {
      "id": "in_1SS1tIDHrpDCEzdlVd8FH0V4",
      "created_at": "2021-01-01T00:00:00Z",
      "hosted_url": "https://invoice.stripe.com/i/acct_6Q96h5avMho8OKe/test_9USnMMVPQmtUHVUYXV2M...",
      "line_items": [
        {
          "amount": {
            "currency_code": "USD",
            "value": "100"
          },
          "description": "Test Invoice",
          "price_in_unit_amount": {
            "currency_code": "USD",
            "value": "100"
          },
          "quantity": 1
        }
      ],
      "status": "draft",
      "subject_id": "subj_VyX6Q96h5avMho8O7QWlKeXE",
      "total_amount": {
        "currency_code": "USD",
        "value": "100"
      }
    }
  ]
}

Returns Examples

{
  "has_more": false,
  "invoices": [
    {
      "id": "in_1SS1tIDHrpDCEzdlVd8FH0V4",
      "created_at": "2021-01-01T00:00:00Z",
      "hosted_url": "https://invoice.stripe.com/i/acct_6Q96h5avMho8OKe/test_9USnMMVPQmtUHVUYXV2M...",
      "line_items": [
        {
          "amount": {
            "currency_code": "USD",
            "value": "100"
          },
          "description": "Test Invoice",
          "price_in_unit_amount": {
            "currency_code": "USD",
            "value": "100"
          },
          "quantity": 1
        }
      ],
      "status": "draft",
      "subject_id": "subj_VyX6Q96h5avMho8O7QWlKeXE",
      "total_amount": {
        "currency_code": "USD",
        "value": "100"
      }
    }
  ]
}