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

Retrieves a link to an invoice’s pdf, generated by Lotus.

Authorizations

Authorization
string
headerrequired

Token-based authentication with required prefix "Token"

Path Parameters

invoice_id
string
required

Either an invoice ID (in the format invoice_<uuid>) or an invoice number (in the format YYMMDD-000001)

Response

200 - application/json
amount
number
required
cost_due
number
required
currency
object
required
customer
object
required
due_date
string | null
required
end_date
string
required
external_payment_obj_id
string | null
required
external_payment_obj_status
string | null
external_payment_obj_type
enum<string> | null
required
  • stripe - Stripe
  • braintree - Braintree
Available options:
stripe,
braintree,
invoice_id
string
required
invoice_number
string
required
invoice_pdf
string | null
required
issue_date
string
required
line_items
object[]
required
payment_status
enum<string>
required
  • draft - draft
  • voided - voided
  • paid - paid
  • unpaid - unpaid
Available options:
draft,
voided,
paid,
unpaid
seller
object
required
start_date
string
required