> ## Documentation Index > Fetch the complete documentation index at: https://alguna.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List quotes > Returns a paginated list of quotes, filterable by subscription, kind, and status. ## OpenAPI ````yaml /api-reference/v2/specs/2026-04-01.json get /quotes openapi: 3.1.0 info: title: Alguna Public API version: '2026-04-01' servers: - url: https://api.alguna.io security: - bearerAuth: [] tags: - name: Billing Events and Metrics - name: Checkout Sessions - name: Credit Notes - name: Credits - name: Customer Portal Sessions - name: Customers - name: Insights - name: Integrations - name: Invoices - name: Merchants - name: Payments - name: Plans - name: Product Bundles - name: Products - name: Quotes - name: Refunds - name: Revenue Schedules - name: Subscription Changes - name: Subscription Versions - name: Subscriptions - name: Tags - name: Tax - name: Wallet Grants - name: Wallets paths: /quotes: get: tags: - Quotes summary: List quotes description: >- Returns a paginated list of quotes, filterable by subscription, kind, and status. operationId: list-quotes parameters: - in: header name: Alguna-Version required: true schema: enum: - '2026-04-01' type: string - in: query name: kind schema: description: Filter by quote kind enum: - new - renewal - amendment type: string - in: query name: limit required: true schema: description: Page size format: int64 maximum: 100 minimum: 1 type: integer - in: query name: offset required: true schema: description: Number of quotes to skip format: int64 minimum: 0 type: integer - in: query name: status schema: description: Filter by document status enum: - draft - pending_approval - sent - signed - rejected - withdrawn - expired type: string - in: query name: subscription_id schema: description: Only quotes documenting this subscription type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/QuoteListResponse' description: Success '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Not Found '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error components: schemas: QuoteListResponse: properties: data: description: List of quotes items: $ref: '#/components/schemas/QuoteResponse' type: array pagination: allOf: - $ref: '#/components/schemas/PaginationMeta' description: Pagination metadata required: - data - pagination type: object ErrorResponse: properties: detail: type: string status: format: int64 type: integer required: - status - detail type: object QuoteResponse: properties: auto_activate: description: >- Whether this quote takes effect on its own once signed; otherwise activate it with Activate a Signed Quote example: false type: boolean contract: allOf: - $ref: '#/components/schemas/ContractResponse' description: Term of the subscription this quote documents created_at: description: When the quote was created example: '2026-08-21T10:00:00Z' format: date-time type: string currency: description: ISO 4217 currency code example: USD type: string customer_id: description: Customer ID example: cust_abc123 type: string expires_at: description: When the signing offer expires; null means it never expires example: '2026-09-30T23:59:59Z' format: date-time nullable: true type: string id: description: Quote ID example: qt_abc123 type: string kind: description: Quote kind enum: - new - renewal - amendment example: new type: string name: description: >- Display name of the quote: its own override when one is set, otherwise the name of the subscription it documents example: Acme Platform 2026 type: string signing_url: description: >- Hosted page where the customer reviews and signs. Present on a single quote while a customer signature is pending, so a lost link can be recovered; omitted on the list. example: https://acme.alguna.io/hs/elt_abc123 nullable: true type: string status: description: Document status enum: - draft - pending_approval - sent - signed - rejected - withdrawn - expired example: draft type: string subscription_id: description: >- The subscription this quote creates or amends. Whether the deal is in effect is that subscription's state, not the quote's: read it, or its phases, once the quote is signed. example: sub_abc123 type: string updated_at: description: When the quote was last updated example: '2026-08-21T10:00:00Z' format: date-time type: string withdrawal_reason: description: Reason recorded on withdrawal example: Superseded by revised terms nullable: true type: string withdrawn_at: description: When the quote was withdrawn, if withdrawn example: '2026-09-15T09:00:00Z' format: date-time nullable: true type: string required: - auto_activate - contract - created_at - currency - customer_id - id - kind - name - status - subscription_id - updated_at type: object PaginationMeta: properties: per_page: description: Number of items returned per page example: 20 format: int64 type: integer total_pages: description: Total number of pages available example: 5 format: int64 type: integer required: - per_page - total_pages type: object ContractResponse: properties: duration_months: description: Contract duration in months example: 12 format: int64 nullable: true type: integer end_date: description: Contract end date example: '2027-01-01T00:00:00Z' format: date-time nullable: true type: string period_type: description: Contract period type example: fixed type: string start_date: description: Contract start date example: '2026-01-01T00:00:00Z' format: date-time nullable: true type: string required: - period_type type: object securitySchemes: bearerAuth: bearerFormat: API Key description: API key authentication. Pass your API key as a Bearer token. scheme: bearer type: http ````