GEgetlago
quotes

List all quotes

Changed on

This endpoint is used to list all existing quotes. Quotes are ordered by creation date, from the most recent to the oldest. This is a premium feature.

get/quotes

Request

Query parameters

pageinteger
Example:1

Page number. Defaults to 1. A value that is not a positive integer, such as 0, returns the first page.

per_pageinteger
Example:20

Number of records per page. Defaults to 100. The maximum is 200, unless another maximum is configured for your organization. A value above the maximum returns a 422 error with value_is_out_of_range on per_page. A value that is not a positive integer, such as 0, returns the default number of records.

status[]string[]

Filter quotes by the status of their current version. Possible values are draft, approved and voided.

order_type[]string[]

Filter quotes by order type. Possible values are subscription_creation, subscription_amendment and one_off.

number[]string[]

Filter quotes by their number, as assigned by Lago.

[
  "QT-2026-0001",
  "QT-2026-0002"
]
owner_id[]string[]

Filter quotes by the Lago identifiers of the users owning them.

[
  "1a901a90-1a90-1a90-1a90-1a901a901a90"
]
external_customer_id[]string[]

Filter quotes by the external unique identifiers of their customers (provided by your own application).

[
  "external_id_1234"
]
from_datestring date
Example:2026-01-01

Filter quotes created from a specific date.

to_datestring date
Example:2026-12-31

Filter quotes created up to a specific date.

Response

Quotes

Example response

{
  "quotes": [
    {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "number": "QT-2026-0001",
      "order_type": "subscription_creation",
      "lago_customer_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_subscription_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "lago_organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "created_at": "2026-04-29T08:59:51Z",
      "updated_at": "2026-04-29T08:59:51Z",
      "current_version": {
        "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "lago_quote_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "lago_organization_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "version": 1,
        "status": "draft",
        "currency": "USD",
        "billing_entity_code": "acme_corp",
        "void_reason": "manual",
        "approved_at": "2026-04-29T08:59:51Z",
        "voided_at": "2026-04-29T08:59:51Z",
        "created_at": "2026-04-29T08:59:51Z",
        "updated_at": "2026-04-29T08:59:51Z"
      }
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 4,
    "total_count": 70
  }
}

Changes