> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marro.si/llms.txt
> Use this file to discover all available pages before exploring further.

# Read a published customer quote

> Requires the private 43-character quote bearer token, not an organization API key. Send it only in the Authorization header over HTTPS; never in a query or path. Returns only the current published snapshot. GET is read-only, including no viewed tracking. Responses are private and never cached. This does not deliver a quote or prove customer identity. Screens and release validation are pending.



## OpenAPI

````yaml /openapi.json get /api/public/customer-quotes
openapi: 3.1.0
info:
  title: Marro API
  version: 1.0.0
  description: >-
    Server-to-server access to one organization’s data in Marro. Each key
    belongs to an organization and can use only the scopes it was given for
    modules the organization subscribes to. Keys go only in the Authorization
    header, over HTTPS, from a server: never in browser code or a URL. A key
    that was ever sent over plain HTTP or in a URL must be treated as leaked:
    revoke it and create a new one. The API sends no CORS headers.


    Every response carries `X-Request-Id`, to quote to support. Once the key is
    checked, responses also carry `RateLimit-Limit`, `RateLimit-Remaining` and
    `RateLimit-Reset` (seconds until the window resets) for whichever limit is
    closer to running out. An address that is not an endpoint answers 404
    `NOT_FOUND` in the same error shape.
servers:
  - url: https://app.marro.si
security: []
tags:
  - name: Leads
    description: >-
      Record-link custom fields accept numeric target ID arrays (one or up to 20
      according to recordLink.multiple). Reads resolve accessible targets to
      id/kind/name/href objects. Deleted, archived, disabled and inaccessible
      targets are omitted. Destinations require the corresponding leads.read or
      crm.records.read scope; user destinations have no public API scope. Object
      destinations use object:<id>, require objects.records.read and the key
      creator current object grants.
  - name: Customers
    description: >-
      Contacts, companies and enabled opportunities with record-type custom
      fields. Dedicated crm.records scopes are required.
  - name: Reference
    description: 'How this organization is set up: fields, stages, sources and people.'
  - name: Money
    description: >-
      Products, quotes, invoices and payments. Amounts are integers in the
      smallest currency unit (paise, cents); a new document is in the
      organization's own currency. Tax follows the organization's regional
      settings: under India GST an invoice carries CGST and SGST inside the
      organization's state, IGST outside it, and no GST without a supplier
      GSTIN; under a single-rate tax (Australia GST 10%, UK VAT) each taxed line
      carries that tax (singleTaxMinor), and none without the supplier's
      registration number. Each document keeps the tax it was issued under
      (tax.model).
  - name: Reports
    description: >-
      Custom reports shared with everyone in the organization, and their
      figures. Built in the app under Reports → Custom reports; a key reads them
      over every lead.
paths:
  /api/public/customer-quotes:
    get:
      tags:
        - Customer quote access
      summary: Read a published customer quote
      description: >-
        Requires the private 43-character quote bearer token, not an
        organization API key. Send it only in the Authorization header over
        HTTPS; never in a query or path. Returns only the current published
        snapshot. GET is read-only, including no viewed tracking. Responses are
        private and never cached. This does not deliver a quote or prove
        customer identity. Screens and release validation are pending.
      operationId: read-published-customer-quote
      responses:
        '200':
          description: Current published revision, including effective expired status
          content:
            application/json:
              schema:
                type: object
                properties:
                  quoteId:
                    type: string
                    format: uuid
                    pattern: >-
                      ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                  organizationId:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  revision:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  fingerprint:
                    type: string
                  status:
                    type: string
                    enum:
                      - sent
                      - accepted
                      - declined
                      - expired
                  validUntil:
                    type: string
                  snapshot:
                    type: object
                    properties:
                      title:
                        type: string
                        minLength: 1
                        maxLength: 200
                      currency:
                        type: string
                        pattern: ^[A-Z]{3}$
                      currencyExponent:
                        type: integer
                        minimum: 0
                        maximum: 4
                      supplier:
                        type: object
                        properties:
                          name:
                            type: string
                            minLength: 1
                            maxLength: 200
                          address:
                            type: string
                            maxLength: 2000
                          taxIdentity:
                            anyOf:
                              - type: string
                                maxLength: 100
                              - type: 'null'
                        required:
                          - name
                          - address
                          - taxIdentity
                        additionalProperties: false
                      customerLabel:
                        type: string
                        minLength: 1
                        maxLength: 200
                      terms:
                        type: string
                        maxLength: 10000
                      taxConfiguration:
                        type: string
                        enum:
                          - explicit
                          - unconfigured
                      lines:
                        type: array
                        items:
                          type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - product
                                - service
                            description:
                              type: string
                              minLength: 1
                              maxLength: 200
                            quantity:
                              type: string
                              pattern: ^(0|[1-9][0-9]{0,6})(\.[0-9]{1,4})?$
                            unitMinor:
                              type: string
                              pattern: ^(0|[1-9][0-9]{0,14})$
                            discountMinor:
                              type: string
                              pattern: ^(0|[1-9][0-9]{0,14})$
                            taxes:
                              maxItems: 10
                              type: array
                              items:
                                type: object
                                properties:
                                  label:
                                    type: string
                                    minLength: 1
                                    maxLength: 200
                                  amountMinor:
                                    type: string
                                    pattern: ^(0|[1-9][0-9]{0,14})$
                                required:
                                  - label
                                  - amountMinor
                                additionalProperties: false
                            extendedMinor:
                              type: string
                              pattern: ^(0|[1-9][0-9]{0,14})$
                            totalMinor:
                              type: string
                              pattern: ^(0|[1-9][0-9]{0,14})$
                          required:
                            - kind
                            - description
                            - quantity
                            - unitMinor
                            - discountMinor
                            - taxes
                            - extendedMinor
                            - totalMinor
                          additionalProperties: false
                      validUntil:
                        type: string
                        format: date-time
                        pattern: >-
                          ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
                      subtotalMinor:
                        type: string
                        pattern: ^(0|[1-9][0-9]{0,14})$
                      discountMinor:
                        type: string
                        pattern: ^(0|[1-9][0-9]{0,14})$
                      taxMinor:
                        type: string
                        pattern: ^(0|[1-9][0-9]{0,14})$
                      totalMinor:
                        type: string
                        pattern: ^(0|[1-9][0-9]{0,14})$
                      acceptanceNotice:
                        type: string
                    required:
                      - title
                      - currency
                      - currencyExponent
                      - supplier
                      - customerLabel
                      - terms
                      - taxConfiguration
                      - lines
                      - validUntil
                      - subtotalMinor
                      - discountMinor
                      - taxMinor
                      - totalMinor
                      - acceptanceNotice
                    additionalProperties: false
                required:
                  - quoteId
                  - organizationId
                  - revision
                  - fingerprint
                  - status
                  - validUntil
                  - snapshot
                additionalProperties: false
        '404':
          description: Quote unavailable
      security:
        - CustomerQuoteBearer: []
components:
  securitySchemes:
    CustomerQuoteBearer:
      type: http
      scheme: bearer
      description: >-
        One private customer quote bearer token. Not a staff JWT or organization
        API key. Never log it or put it in a URL query/path.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.