List Bottle invoices

GET

/billing/invoices

const url = 'https://example.com/billing/invoices';
const options = {
  method: 'GET',
  headers: {cookie: 'bottle.session_token=<bottle.session_token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/billing/invoices \
  --cookie bottle.session_token=<bottle.session_token>

Newest first. Each one links to its own page, where the VAT breakdown and a PDF live.

Authorizations

sessionCookie
billing:read
apiKey
billing:read

Responses

200

The invoices, or none yet

application/json

object

invoices

required

Array<object>

object

required

string

number

required

string | null

date

required

string format: date-time

total

required

integer

currency

required

ISO 4217, lower case, as Stripe writes it.

string

status

required

string

Allowed values: draft open paid uncollectible void

url

required

string | null format: uri

pdfUrl

required

string | null format: uri

Example

{
  "invoices": [
    {
      "status": "draft"
    }
  ]
}

401

Not signed in

application/json

object

error

required

string

message

required

string

Example

{
  "error": "not_found",
  "message": "Customer not found"
}

403

Not allowed to manage billing, or asking for a key to do it

application/json

object

error

required

string

message

required

string

Example

{
  "error": "not_found",
  "message": "Customer not found"
}