> ## 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 x-fern-server-name: Production security: - bearerAuth: [] tags: - name: Billing Events and Metrics - name: Checkout Sessions - name: Credit Notes - name: Credits - name: Customer Portal Sessions - name: Customers - name: Feedback - 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: Users - 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 schema: default: 50 description: Page size format: int32 maximum: 100 minimum: 1 type: integer - in: query name: offset schema: default: 0 description: Number of quotes to skip format: int32 minimum: 0 type: integer - in: query name: status schema: description: Filter by document status enum: - draft - pending_approval - approved - 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: oneOf: - $ref: '#/components/schemas/ErrorResponse' - $ref: '#/components/schemas/GatewayErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Forbidden — the organization does not have access to this feature '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 '502': description: >- Bad Gateway — sent by the infrastructure in front of the API; the body is not JSON. Safe to retry. '503': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Service Unavailable — a dependency is temporarily unavailable. Retry with backoff. '504': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: >- Gateway Timeout — the request did not finish in time. Retry with backoff; use an idempotency key for writes. 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: description: The body of every error the API returns. properties: detail: description: Explanation of what went wrong type: string status: description: HTTP status code of the response format: int64 type: integer title: description: >- HTTP status text. Sent only by version, idempotency and credit-refusal errors. type: string type: description: Always `about:blank`. Sent only by version and idempotency errors. type: string required: - status - detail type: object GatewayErrorResponse: description: >- Returned by the API gateway when a request carries no valid API key, before the API handles it. properties: code: description: Machine-readable error code, e.g. `unauthenticated` type: string details: nullable: true type: object message: description: Explanation of what went wrong type: string required: - code - message type: object QuoteResponse: properties: approval: allOf: - $ref: '#/components/schemas/QuoteApprovalResponse' description: >- The quote's current approval. A new-business quote shows the approval of its subscription's creation; a quote that amends or renews an existing subscription shows the approval of its own issuance. 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 - approved - 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: - approval - 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 QuoteApprovalResponse: properties: decided_at: description: When the approval request was decided, if decided example: '2026-08-21T12:00:00Z' format: date-time nullable: true type: string flow_id: description: >- The approval request. Errors that an approval refuses name the same request in approval.flow_id. example: 3f2b8c1e-5d4a-4f7b-9c2e-1a6d8e0f4b21 nullable: true type: string generation: description: >- Version of the approval request's content; it increases when the request is evaluated again for changed terms example: 1 format: int64 nullable: true type: integer operation: description: >- The action the approval covers: send_quote sends the quote once approved, manual_hold leaves it for someone to send, activate activates the subscription. Absent when no approval was requested. enum: - send_quote - manual_hold - activate example: send_quote nullable: true type: string requested_at: description: When the approval was requested example: '2026-08-21T10:00:00Z' format: date-time nullable: true type: string status: description: >- Where the current approval stands. none: no approval was requested. pending: waiting for a decision. approved_manual_hold: approved, and waiting for someone to send the quote. approved_awaiting_execution: approved, and the approved action has not run yet. executed: approved, and the approved action ran. failed: approved, but the approved action failed. stale: the quote's subscription changed after the request, so the approval no longer applies and approval must be requested again for the current terms. rejected: an approver rejected the request. canceled: the request was canceled. enum: - none - pending - approved_awaiting_execution - approved_manual_hold - executed - stale - failed - rejected - canceled example: pending type: string required: - status 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 enum: - fixed - monthly_rolling 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 x-fern-bearer: env: ALGUNA_API_KEY name: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.