Skip to content

List quotes

GET/documents/quotes

Costs 1 rate-limit point · Rate limits

The quotes the Draft orders page knows about: invoices raised from Shopify draft orders, newest first, as list rows. A quote is the same record as an invoice with document_type 'quote', so the rows read like invoice rows plus the draft order gid. Trashed quotes are left out unless link=trashed. Read-only.

document_type values: invoice (Invoice), quote (Quote), credit_note (Credit note), pro_forma (Pro forma invoice), custom (Custom invoice).

link values: linked (Created from a Shopify order), not_linked (Standalone (no Shopify order)), trashed (In the trash).

Also searched aslist quotesshow my quotesdraft order invoicesfind a quotequotes for a draft orderquotes from last week

Query parameters

  • linkstring

    'trashed' to list quotes in the trash instead. One of: linked (Created from a Shopify order), not_linked (Standalone (no Shopify order)), trashed (In the trash).

    One of linkednot_linkedtrashed
  • sortstring

    'created_at desc' (default) or 'created_at asc'.

    One of created_at desccreated_at asc
  • pageinteger

    1-based page number.

  • per_pageinteger

    Rows per page, default 25, max 100.

  • fromstring

    Created on or after this date (ISO 8601).

  • tostring

    Created on or before this date (ISO 8601).

  • order_idstring

    The Shopify draft order, as a gid (gid://shopify/DraftOrder/123) or a bare number.

  • qstring

    Free text over quote number, draft order name, customer name and email.

Returns

  • itemsarray of objects
    Show 20 child attributesHide child attributes
    • idinteger
      Example: 980191056
    • document_typestring
      Example: quote
    • invoice_numberstring
      Example: Q-1001
    • titlestring
      Example: Quote
    • orderobject
      Show 3 child attributesHide child attributes
      • shopify_order_idstring
        Example: gid://shopify/DraftOrder/990777
      • namestring
        Example: #D1001
      • numberinteger, nullable
    • customerobject
      Show 3 child attributesHide child attributes
      • idinteger, nullable
      • namestring, nullable
      • emailstring
        Example: quote@example.com
    • financial_statusstring, nullable
    • currencystring
      Example: EUR
    • totalstring
      Example: 50.00
    • issued_onstring
      Example: 2026-11-10
    • due_onstring, nullable
    • sent_atstring, nullable
    • printed_atstring, nullable
    • reminder_sent_atstring, nullable
    • paidboolean
      Example: false
    • editedboolean
      Example: true
    • trashedboolean
      Example: false
    • e_invoice_statusstring, nullable
    • created_atstring
      Example: 2026-11-10T09:24:23Z
    • shopify_draft_order_idstring
      Example: gid://shopify/DraftOrder/990777
  • pageobject

    Offset paging of a list (page, per_page query params).

    Show 4 child attributesHide child attributes
    • numberinteger

      1-based page number.

    • sizeinteger

      Rows per page, max 100.

    • totalinteger

      Rows across all pages.

    • total_pagesinteger
      Example: 1

Errors

401

Missing or unknown X-Auth-Token, or the shop uninstalled the app.

403

v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.

422

The request failed validation. Nothing was saved.

429

Rate limited: cost-weighted per key (reads cost less than writes). Wait Retry-After seconds; see X-RateLimit-* headers.

Every error has the same shape: see Errors.

GET/documents/quotes
curl "https://app.invoicefalcon.com/api/v3/external/documents/quotes" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "items": [
    {
      "id": 980191056,
      "document_type": "quote",
      "invoice_number": "Q-1001",
      "title": "Quote",
      "order": {
        "shopify_order_id": "gid://shopify/DraftOrder/990777",
        "name": "#D1001",
        "number": null
      },
      "customer": {
        "id": null,
        "name": null,
        "email": "quote@example.com"
      },
      "financial_status": null,
      "currency": "EUR",
      "total": "50.00",
      "issued_on": "2026-11-10",
      "due_on": null,
      "sent_at": null,
      "printed_at": null,
      "reminder_sent_at": null,
      "paid": false,
      "edited": true,
      "trashed": false,
      "e_invoice_status": null,
      "created_at": "2026-11-10T09:24:23Z",
      "shopify_draft_order_id": "gid://shopify/DraftOrder/990777"
    }
  ],
  "page": {
    "number": 1,
    "size": 25,
    "total": 1,
    "total_pages": 1
  }
}