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

# Get Offers

> Read owned candidate Offers, original term snapshots and current evaluation. Requires owner read permission. The default lists five recent Offers; optional limit is 1–20, with a truncation flag, next_cursor and fresh read time. Continue with paired before_created_at/before_id; each page is an independent read. Optional offer_id reads one exact owned Offer for this Request and cannot be combined with a cursor. Private draft/status capabilities receive no Offers. Reading never reaffirms or accepts.



## OpenAPI

````yaml /api-reference/openapi/offers.json get /api/purchases/{id}/offers
openapi: 3.1.0
info:
  title: 'Popular Demand Requests: Offers'
  version: 0.4.0
  x-api-version: '2026-11-20'
  description: >-
    Read a Request's Offers and record whether one fits. Index of all areas:
    https://populardemand.market/api/openapi. Versioning policy: [API
    versioning](https://docs.populardemand.market/api-reference/introduction).
    Every /api and MCP response carries an API-Version header (2026-11-20).
    API-Version identifies the contract served by this deployment; it is not
    version negotiation. The current version is 2026-11-20. Sending an
    API-Version request header does not select an older contract. We choose a
    new YYYY-MM-DD date for a breaking change. Adding optional fields, endpoints
    or tools is additive when existing valid requests and documented meanings
    stay unchanged; clients should tolerate unknown response fields. Removing or
    renaming fields, making optional input required, or changing existing field
    types, meanings or authorization requirements is breaking. During early
    access, breaking changes may ship without notice; each one is listed with
    its date in the version changes. Hourly quotas are per UTC hour; a refused
    request answers 429 with Retry-After, RateLimit and RateLimit-Policy headers
    (IETF draft-ietf-httpapi-ratelimit-headers-11, work in progress:
    https://datatracker.ietf.org/doc/html/draft-ietf-httpapi-ratelimit-headers-11)
    and error.retry_after_seconds; a successful REST request that counted
    against a per-caller quota carries RateLimit and RateLimit-Policy with the
    allowance left. Errors may carry error.hint, the next step to take. Popular
    Demand Request API. Lists contain Request summaries; individual detail reads
    retain evidence diagnostics and history; recorded observations are
    operator-only. Purchase conditions first. Confirmed explicit all-in ceilings
    and exploration require no individual-option upload. Agent research may
    remain private. Buyer agents compare market prices themselves. Product
    resolution may follow capture. US/USD and IL/ILS only. Integer minor units;
    one canonical intent is not a guaranteed buyer. Every new intent has
    execution_available=false. baseline_diagnostics explains read-time evidence
    eligibility. Mutation retries may return historical cached results; read the
    root again when current evidence/version matters. Verified same-origin
    browser sessions are also accepted on owner REST endpoints; cookie writes
    require Origin. OAuth client tokens require the exact MCP audience and an
    approved Popular Demand grant.
servers:
  - url: https://populardemand.market
security: []
tags:
  - name: Offers
    description: Read a Request's Offers and record whether one fits.
paths:
  /api/purchases/{id}/offers:
    get:
      tags:
        - Offers
      summary: Get Offers
      description: >-
        Read owned candidate Offers, original term snapshots and current
        evaluation. Requires owner read permission. The default lists five
        recent Offers; optional limit is 1–20, with a truncation flag,
        next_cursor and fresh read time. Continue with paired
        before_created_at/before_id; each page is an independent read. Optional
        offer_id reads one exact owned Offer for this Request and cannot be
        combined with a cursor. Private draft/status capabilities receive no
        Offers. Reading never reaffirms or accepts.
      operationId: getPurchaseOffers
      parameters:
        - name: id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/Shared38'
        - name: offer_id
          in: query
          schema:
            $ref: '#/components/schemas/Shared38'
        - name: limit
          in: query
          schema:
            default: 5
            type: integer
            minimum: 1
            maximum: 20
        - name: before_created_at
          in: query
          description: Use together with before_id from next_cursor.
          schema:
            $ref: '#/components/schemas/Shared23'
        - name: before_id
          in: query
          description: Use together with before_created_at.
          schema:
            $ref: '#/components/schemas/Shared38'
        - name: API-Version
          in: header
          required: false
          description: >-
            Current contract only; no version negotiation. See
            https://docs.populardemand.market/api-reference/introduction.
          schema:
            type: string
            default: '2026-11-20'
      responses:
        '200':
          description: Private buyer Offer projections.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseOfferPage'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '400':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '401':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '403':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '404':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '409':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '413':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '500':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
        '503':
          description: >-
            Typed private error. Read current versions after a conflict; retry
            lost writes with the same key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PurchaseError'
          headers:
            API-Version:
              description: >-
                The served contract version; request headers do not select a
                historical version.
              schema:
                type: string
                const: '2026-11-20'
      security:
        - OwnerBearer: []
components:
  schemas:
    Shared38:
      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)$
    Shared23:
      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)))$
    PurchaseOfferPage:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        offers:
          maxItems: 100
          type: array
          items:
            type: object
            properties:
              id:
                $ref: '#/components/schemas/Shared38'
              version:
                type: integer
                exclusiveMinimum: 0
                maximum: 9007199254740991
              status:
                type: string
                enum:
                  - prepared
                  - withdrawn
                  - simulated_accepted
                  - simulated_released
                  - simulated_ordered
              withdrawal:
                anyOf:
                  - type: object
                    properties:
                      reason:
                        type: string
                        enum:
                          - seller_quote_withdrawn
                          - superseded_quote
                          - operator_correction
                      explanation:
                        type: string
                        minLength: 10
                        maxLength: 1000
                      recorded_at:
                        $ref: '#/components/schemas/Shared23'
                    required:
                      - reason
                      - explanation
                      - recorded_at
                    additionalProperties: false
                  - type: 'null'
              demand_source:
                type: string
              snapshot:
                $ref: '#/components/schemas/Shared1'
              request_conditions:
                anyOf:
                  - type: object
                    properties:
                      schema_version:
                        type: number
                        const: 1
                      request_id:
                        $ref: '#/components/schemas/Shared38'
                      request_version:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      country:
                        type: string
                        pattern: ^[A-Z]{2}$
                        enum:
                          - US
                          - IL
                      currency:
                        type: string
                        pattern: ^[A-Z]{3}$
                        enum:
                          - USD
                          - ILS
                      destination:
                        type: object
                        properties:
                          city:
                            type: string
                            minLength: 1
                            maxLength: 100
                          region:
                            type: string
                            minLength: 1
                            maxLength: 100
                          zip:
                            type: string
                            pattern: ^[a-zA-Z0-9 -]{3,12}$
                          scope:
                            default: unknown
                            type: string
                            enum:
                              - national_parcel
                              - regional
                              - unknown
                        required:
                          - scope
                        additionalProperties: false
                      raw_request:
                        anyOf:
                          - type: string
                            minLength: 5
                            maxLength: 4000
                          - type: 'null'
                      time_horizon:
                        anyOf:
                          - type: string
                            maxLength: 200
                          - type: 'null'
                      need_by:
                        $ref: '#/components/schemas/Shared25'
                      expires_at:
                        $ref: '#/components/schemas/Shared23'
                      purchase_spec:
                        type: object
                        properties:
                          schema_version:
                            type: number
                            const: 1
                          needs:
                            minItems: 1
                            maxItems: 20
                            type: array
                            items:
                              type: object
                              properties:
                                need_id:
                                  type: string
                                  pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                                description:
                                  type: string
                                  minLength: 3
                                  maxLength: 1000
                                quantity:
                                  anyOf:
                                    - type: integer
                                      minimum: 1
                                      maximum: 10000
                                    - type: 'null'
                                unit:
                                  type: object
                                  properties:
                                    code:
                                      type: string
                                      const: C62
                                    scale:
                                      type: number
                                      const: 0
                                  required:
                                    - code
                                    - scale
                                  additionalProperties: false
                                required:
                                  type: boolean
                                conditions_confirmed:
                                  type: boolean
                                options:
                                  maxItems: 20
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      option_id:
                                        type: string
                                        pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                                      description:
                                        type: string
                                        minLength: 3
                                        maxLength: 500
                                      product:
                                        anyOf:
                                          - $ref: '#/components/schemas/Shared36'
                                          - type: 'null'
                                      attributes:
                                        maxItems: 20
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            name:
                                              type: string
                                              minLength: 1
                                              maxLength: 100
                                            value:
                                              type: string
                                              minLength: 1
                                              maxLength: 100
                                          required:
                                            - name
                                            - value
                                          additionalProperties: false
                                    required:
                                      - option_id
                                      - description
                                      - product
                                    additionalProperties: false
                                terms:
                                  type: object
                                  properties:
                                    warranty_months_min:
                                      anyOf:
                                        - type: integer
                                          minimum: 0
                                          maximum: 120
                                        - type: 'null'
                                    returns_days_min:
                                      anyOf:
                                        - type: integer
                                          minimum: 0
                                          maximum: 365
                                        - type: 'null'
                                    authorized_seller_required:
                                      type:
                                        - boolean
                                        - 'null'
                                  required:
                                    - warranty_months_min
                                    - returns_days_min
                                    - authorized_seller_required
                                  additionalProperties: false
                              required:
                                - need_id
                                - description
                                - quantity
                                - unit
                                - required
                                - conditions_confirmed
                                - options
                                - terms
                              additionalProperties: false
                          basket_acceptance:
                            type: string
                            enum:
                              - all_required
                              - partial_allowed
                              - unknown
                          ceilings:
                            maxItems: 40
                            type: array
                            items:
                              $ref: '#/components/schemas/Shared9'
                          delivery_methods:
                            maxItems: 2
                            type: array
                            items:
                              type: string
                              enum:
                                - shipping
                                - pickup
                        required:
                          - schema_version
                          - needs
                          - basket_acceptance
                          - ceilings
                          - delivery_methods
                        additionalProperties: false
                      pricing_mode:
                        type: string
                        enum:
                          - explore
                          - explicit
                      pricing_policy:
                        anyOf:
                          - oneOf:
                              - type: object
                                properties:
                                  mode:
                                    type: string
                                    const: explore
                                required:
                                  - mode
                                additionalProperties: false
                              - type: object
                                properties:
                                  mode:
                                    type: string
                                    const: explicit
                                  amount_minor:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 100000000
                                  currency:
                                    type: string
                                    pattern: ^[A-Z]{3}$
                                    enum:
                                      - USD
                                      - ILS
                                required:
                                  - mode
                                  - amount_minor
                                  - currency
                                additionalProperties: false
                          - type: 'null'
                      effective_pricing:
                        type: object
                        properties:
                          status:
                            type: string
                            minLength: 1
                            maxLength: 100
                          amount_minor:
                            anyOf:
                              - type: integer
                                minimum: 0
                                maximum: 100000000
                              - type: 'null'
                        required:
                          - status
                          - amount_minor
                        additionalProperties: false
                    required:
                      - schema_version
                      - request_id
                      - request_version
                      - country
                      - currency
                      - destination
                      - raw_request
                      - time_horizon
                      - need_by
                      - expires_at
                      - purchase_spec
                      - pricing_mode
                      - pricing_policy
                      - effective_pricing
                    additionalProperties: false
                  - type: 'null'
              current_evaluation:
                anyOf:
                  - $ref: '#/components/schemas/Shared1'
                  - type: 'null'
              current_context:
                type: boolean
                description: >-
                  The prepared Offer references the current Request and
                  available Quote versions. This does not establish unexpired
                  validity or price qualification; inspect current_evaluation.
              context_diagnostics:
                description: >-
                  Dated binding reasons and observed Request/Quote versions and
                  states. Empty codes mean current binding only. Inspect
                  current_evaluation for prices, costs and expiry. No current
                  draft seller terms or acceptance authority is included.
                type: object
                properties:
                  checked_at:
                    $ref: '#/components/schemas/Shared23'
                  codes:
                    maxItems: 6
                    type: array
                    items:
                      type: string
                      enum:
                        - plan_not_prepared
                        - request_unavailable
                        - request_version_changed
                        - proposal_unavailable
                        - proposal_not_available
                        - proposal_version_changed
                  request:
                    type: object
                    properties:
                      prepared_version:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      current_version:
                        anyOf:
                          - type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                          - type: 'null'
                      current_status:
                        anyOf:
                          - type: string
                            enum:
                              - draft
                              - active
                              - closed
                          - type: 'null'
                    required:
                      - prepared_version
                      - current_version
                      - current_status
                    additionalProperties: false
                  proposal:
                    type: object
                    properties:
                      prepared_version:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      current_version:
                        anyOf:
                          - type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                          - type: 'null'
                      current_status:
                        anyOf:
                          - type: string
                            enum:
                              - draft
                              - available
                              - withdrawn
                          - type: 'null'
                    required:
                      - prepared_version
                      - current_version
                      - current_status
                    additionalProperties: false
                required:
                  - checked_at
                  - codes
                  - request
                  - proposal
                additionalProperties: false
              delivery:
                type: object
                properties:
                  quote_id:
                    type: string
                    pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                  request_id:
                    $ref: '#/components/schemas/Shared38'
                  request_version:
                    type: integer
                    exclusiveMinimum: 0
                    maximum: 9007199254740991
                  proposal_id:
                    $ref: '#/components/schemas/Shared38'
                  proposal_version:
                    type: integer
                    exclusiveMinimum: 0
                    maximum: 9007199254740991
                  tier_id:
                    type: string
                    pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                  selections:
                    minItems: 1
                    maxItems: 20
                    type: array
                    items:
                      type: object
                      properties:
                        need_id:
                          type: string
                          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                        option_id:
                          type: string
                          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                        seller_item_id:
                          type: string
                          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                        quantity:
                          type: integer
                          minimum: 1
                          maximum: 10000
                      required:
                        - need_id
                        - option_id
                        - seller_item_id
                        - quantity
                      additionalProperties: false
                  currency:
                    type: string
                    pattern: ^[A-Z]{3}$
                    enum:
                      - USD
                      - ILS
                  method:
                    type: string
                    enum:
                      - shipping
                      - pickup
                  delivered_by:
                    $ref: '#/components/schemas/Shared25'
                  delivery_minor:
                    anyOf:
                      - type: integer
                        minimum: 0
                        maximum: 100000000
                      - type: 'null'
                  tax_minor:
                    anyOf:
                      - type: integer
                        minimum: 0
                        maximum: 100000000
                      - type: 'null'
                  duties_minor:
                    anyOf:
                      - type: integer
                        minimum: 0
                        maximum: 100000000
                      - type: 'null'
                  fees_minor:
                    anyOf:
                      - type: integer
                        minimum: 0
                        maximum: 100000000
                      - type: 'null'
                  need_costs:
                    anyOf:
                      - maxItems: 20
                        type: array
                        items:
                          type: object
                          properties:
                            need_id:
                              type: string
                              pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
                            delivery_minor:
                              type: integer
                              minimum: 0
                              maximum: 100000000
                            tax_minor:
                              type: integer
                              minimum: 0
                              maximum: 100000000
                            duties_minor:
                              type: integer
                              minimum: 0
                              maximum: 100000000
                            fees_minor:
                              type: integer
                              minimum: 0
                              maximum: 100000000
                          required:
                            - need_id
                            - delivery_minor
                            - tax_minor
                            - duties_minor
                            - fees_minor
                          additionalProperties: false
                      - type: 'null'
                  valid_until:
                    $ref: '#/components/schemas/Shared23'
                  source:
                    $ref: '#/components/schemas/Shared13'
                  reviewed:
                    type: boolean
                required:
                  - quote_id
                  - request_id
                  - request_version
                  - proposal_id
                  - proposal_version
                  - tier_id
                  - selections
                  - currency
                  - method
                  - delivered_by
                  - delivery_minor
                  - tax_minor
                  - duties_minor
                  - fees_minor
                  - need_costs
                  - valid_until
                  - source
                  - reviewed
                additionalProperties: false
              seller_id:
                type: string
              collective_terms:
                type: object
                properties:
                  minimum_units:
                    type: integer
                    exclusiveMinimum: 0
                    maximum: 9007199254740991
                  maximum_units:
                    type: integer
                    exclusiveMinimum: 0
                    maximum: 9007199254740991
                  qualifying_state:
                    type: string
                    const: accepted_simulated_plans
                  execution_policy:
                    type: string
                    const: rehearsal_only
                  price_basis:
                    type: string
                    const: items_excluding_delivery_tax
                  commitment_deadline:
                    $ref: '#/components/schemas/Shared23'
                  real_commitment_available:
                    type: boolean
                    const: false
                required:
                  - minimum_units
                  - maximum_units
                  - qualifying_state
                  - execution_policy
                  - price_basis
                  - commitment_deadline
                  - real_commitment_available
                additionalProperties: false
              execution:
                description: >-
                  How the buyer buys: mode seller_price_guarantee, at the
                  seller's own checkout through execution.deal, except
                  authorization_hold on an Offer made while Popular Demand
                  offered payment holds. buyer_commits says it in one sentence.
                type: object
                properties:
                  mode:
                    type: string
                    enum:
                      - authorization_hold
                      - seller_price_guarantee
                  money_backed:
                    $ref: '#/components/schemas/Shared37'
                  buyer_commits:
                    type: string
                  checkout:
                    type: string
                    enum:
                      - popular_demand
                      - seller
                  terms_version:
                    type: string
                    enum:
                      - c3_c5_v1
                      - spg_v1
                      - spg_v2
                  deal:
                    $ref: '#/components/schemas/Shared6'
                required:
                  - mode
                  - money_backed
                  - buyer_commits
                  - checkout
                  - terms_version
                additionalProperties: false
              purchase:
                type: object
                properties:
                  seller:
                    type: object
                    properties:
                      name:
                        type:
                          - string
                          - 'null'
                      domain:
                        type: string
                      platform:
                        anyOf:
                          - type: string
                            enum:
                              - shopify
                              - woocommerce
                              - bigcommerce
                          - type: 'null'
                    required:
                      - name
                      - domain
                      - platform
                    additionalProperties: false
                  product:
                    type: object
                    properties:
                      id:
                        description: >-
                          The store’s own product ID, when the Offer was quoted
                          from a connected store.
                        type:
                          - string
                          - 'null'
                      title:
                        type: string
                    required:
                      - id
                      - title
                    additionalProperties: false
                  currency:
                    type: string
                  quantity:
                    type: integer
                    exclusiveMinimum: 0
                    maximum: 9007199254740991
                  group_price:
                    type: integer
                    minimum: 0
                    maximum: 9007199254740991
                    description: >-
                      This Offer’s price for one item, in the currency’s
                      smallest unit (cents for USD), before delivery. It
                      includes tax where must_tell_user.price_includes_tax is
                      true.
                  variants:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        store_price:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                          description: >-
                            The store’s own price for this variant at
                            prices_read_at, in the currency’s smallest unit
                            (cents for USD).
                        group_price:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        base:
                          description: >-
                            Present on the variant the seller priced. Other
                            variants keep the store’s own price difference from
                            it.
                          type: boolean
                          const: true
                      required:
                        - id
                        - store_price
                        - group_price
                      additionalProperties: false
                    description: >-
                      The variants this Offer covers, by the store’s own variant
                      ID. Empty when the seller named only a page.
                  prices_read_at:
                    type:
                      - string
                      - 'null'
                  discount:
                    type: object
                    properties:
                      applied_by:
                        type: string
                        enum:
                          - link
                          - code
                          - page
                        description: >-
                          How the group price reaches the seller’s checkout.
                          code: with discount.code, entered at checkout or
                          applied by this buyer’s own link
                          (execution.deal.link); without it the store charges
                          its own price. page: the seller’s page behind the
                          buyer’s link carries the group price, with no code.
                          link: this buyer’s own link applies a code issued when
                          they follow it.
                      code:
                        description: >-
                          This buyer’s own code for the group price at the
                          seller’s checkout: one order, until
                          discount.expires_at. Null when the page needs none or
                          the code is not issued yet.
                        type:
                          - string
                          - 'null'
                      amount_each:
                        anyOf:
                          - type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          - type: 'null'
                        description: >-
                          What the code takes off each covered item at
                          prices_read_at, in the currency’s smallest unit (cents
                          for USD). Null when not known.
                      expires_at:
                        type:
                          - string
                          - 'null'
                    required:
                      - applied_by
                      - code
                      - amount_each
                      - expires_at
                    additionalProperties: false
                required:
                  - seller
                  - product
                  - currency
                  - quantity
                  - group_price
                  - variants
                  - prices_read_at
                  - discount
                additionalProperties: false
                description: >-
                  The exact item this Offer covers at the seller’s store.
                  Checkout happens at the seller’s store, and the seller is the
                  merchant.
              must_tell_user:
                anyOf:
                  - type: object
                    properties:
                      mode:
                        type: string
                        enum:
                          - authorization_hold
                          - seller_price_guarantee
                      merchant_of_record:
                        type: object
                        properties:
                          legal_name:
                            type:
                              - string
                              - 'null'
                          display_name:
                            type:
                              - string
                              - 'null'
                        required:
                          - legal_name
                          - display_name
                        additionalProperties: false
                        description: >-
                          The seller, who makes the sale and charges the buyer
                          at their own checkout. legal_name is null until it is
                          recorded.
                      amount:
                        anyOf:
                          - type: object
                            properties:
                              all_in_minor:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              currency:
                                type: string
                              formatted:
                                type: string
                            required:
                              - all_in_minor
                              - currency
                              - formatted
                            additionalProperties: false
                          - type: 'null'
                        description: >-
                          Null for seller_price_guarantee: the seller's checkout
                          states the final amount (it adds tax unless
                          price_includes_tax), so there is no all-in total;
                          before_tax states the price.
                      before_tax:
                        anyOf:
                          - type: object
                            properties:
                              items_minor:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              delivery_minor:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              duties_minor:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              fees_minor:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              total_minor:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                              currency:
                                type: string
                              formatted:
                                type: string
                            required:
                              - items_minor
                              - delivery_minor
                              - duties_minor
                              - fees_minor
                              - total_minor
                              - currency
                              - formatted
                            additionalProperties: false
                          - type: 'null'
                        description: >-
                          seller_price_guarantee: the price before tax, in
                          integer minor units: the items, plus delivery (the
                          seller’s estimate for the destination area; the store
                          calculates the exact amount at checkout), duties and
                          fees as the seller states them, and their total. Tax
                          is added at the seller’s checkout. When
                          price_includes_tax is true (a market whose prices
                          include VAT, such as Israel), these amounts already
                          include VAT and nothing is added for it; the field
                          keeps its name. Null for authorization_hold, and when
                          the store’s price for the size, colour or version the
                          person chose is not known (text then says so).
                      price_includes_tax:
                        type: boolean
                        description: >-
                          Whether the Offer’s market prices include tax (its
                          market policy): true where prices include VAT, such as
                          Israel; false where tax is added at the seller’s
                          checkout, such as the US.
                      cancellation:
                        anyOf:
                          - type: object
                            properties:
                              terms:
                                type: string
                                enum:
                                  - c3_v1
                                  - c3_locked_v1
                                  - charge_now_v1
                              terms_text:
                                type: string
                            required:
                              - terms
                              - terms_text
                            additionalProperties: false
                          - type: 'null'
                        description: >-
                          Null for seller_price_guarantee: the user pays the
                          seller directly, so the seller’s own policies apply.
                      text:
                        type: string
                        description: >-
                          One message to relay, in your words or these, before
                          the user decides to commit to this Offer.
                    required:
                      - mode
                      - merchant_of_record
                      - amount
                      - before_tax
                      - price_includes_tax
                      - cancellation
                      - text
                    additionalProperties: false
                    description: >-
                      Facts to tell the user before they buy this Offer at the
                      seller’s checkout. Null when the Offer is not current, its
                      facts are not loaded, or its price has ended.
                  - type: 'null'
              offer_page_url:
                description: >-
                  The signed-in Offer page for the person (they may need to sign
                  in), with the Offer’s frozen terms.
                type: string
                format: uri
              terms_source:
                $ref: '#/components/schemas/Shared13'
              policies:
                type: object
                properties:
                  warranty:
                    type: string
                  returns:
                    type: string
                  cancellation:
                    type: string
                required:
                  - warranty
                  - returns
                  - cancellation
                additionalProperties: false
              execution_available:
                $ref: '#/components/schemas/Shared42'
              simulated:
                type: boolean
              acceptance_available:
                $ref: '#/components/schemas/Shared42'
              demand:
                $ref: '#/components/schemas/Shared2'
              reference_comparison:
                description: >-
                  Legacy field. Current buyer reads always return null; the
                  buyer agent compares market prices itself.
                anyOf:
                  - type: object
                    properties:
                      reference_id:
                        $ref: '#/components/schemas/Shared38'
                      reference_version:
                        type: integer
                        exclusiveMinimum: 0
                        maximum: 9007199254740991
                      reference_observed_at:
                        $ref: '#/components/schemas/Shared23'
                      comparable:
                        type: boolean
                      reasons:
                        type: array
                        items:
                          type: string
                      reference_total_minor:
                        anyOf:
                          - type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          - type: 'null'
                      offer_all_in_minor:
                        anyOf:
                          - type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          - type: 'null'
                      savings_minor:
                        anyOf:
                          - type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          - type: 'null'
                      savings_bps:
                        anyOf:
                          - type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                          - type: 'null'
                      savings_claim_allowed:
                        type: boolean
                    required:
                      - reference_id
                      - reference_version
                      - reference_observed_at
                      - comparable
                      - reasons
                      - reference_total_minor
                      - offer_all_in_minor
                      - savings_minor
                      - savings_bps
                      - savings_claim_allowed
                    additionalProperties: false
                    description: >-
                      Historical internal comparison with a recorded reference.
                      Retained to read old records; never present it as a
                      buyer-facing market comparison or savings claim.
                  - type: 'null'
              delivery_area:
                description: >-
                  The destination area (state) the Offer was priced for, from
                  its Request postal code, else an unambiguous region the
                  Request names; null when no state is known or the country has
                  none.
                type:
                  - string
                  - 'null'
              supplier_text_is_untrusted:
                type: boolean
                const: true
              untrusted_text_fields:
                maxItems: 20
                type: array
                items:
                  type: string
              internal_fields:
                maxItems: 20
                type: array
                items:
                  type: string
            required:
              - id
              - version
              - status
              - demand_source
              - snapshot
              - current_evaluation
              - current_context
              - delivery
              - seller_id
              - terms_source
              - policies
              - execution_available
              - simulated
              - acceptance_available
            additionalProperties: false
        offers_truncated:
          type: boolean
        next_cursor:
          anyOf:
            - type: object
              properties:
                created_at:
                  $ref: '#/components/schemas/Shared23'
                id:
                  $ref: '#/components/schemas/Shared38'
              required:
                - created_at
                - id
              additionalProperties: false
            - type: 'null'
        as_of:
          $ref: '#/components/schemas/Shared23'
        execution_available:
          type: boolean
          const: false
        message:
          description: What to tell the person.
          type: string
        agent_line:
          description: What the agent does next.
          type: string
      required:
        - offers
        - execution_available
      additionalProperties: false
    PurchaseError:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            details: {}
            retryable:
              type: boolean
              const: true
            retry_after_seconds:
              type: integer
              exclusiveMinimum: 0
              maximum: 9007199254740991
            hint:
              type: string
            errors:
              maxItems: 20
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
                required:
                  - path
                  - message
                additionalProperties: false
          required:
            - code
            - message
          additionalProperties: false
      required:
        - error
      additionalProperties: false
    Shared1:
      type: object
      properties:
        schema_version:
          type: number
          const: 1
        rules_version:
          $ref: '#/components/schemas/Shared33'
        state:
          type: string
          enum:
            - incomplete
            - ready_for_review
        evaluated_at:
          $ref: '#/components/schemas/Shared23'
        mode:
          type: string
          enum:
            - rehearsal
            - reviewed_quote
        execution_available:
          type: boolean
          const: false
        request_id:
          $ref: '#/components/schemas/Shared38'
        request_version:
          type: integer
          exclusiveMinimum: 0
          maximum: 9007199254740991
        proposal_id:
          $ref: '#/components/schemas/Shared38'
        proposal_version:
          type: integer
          exclusiveMinimum: 0
          maximum: 9007199254740991
        tier_id:
          type: string
        currency:
          type: string
          pattern: ^[A-Z]{3}$
          enum:
            - USD
            - ILS
        lines:
          $ref: '#/components/schemas/Shared4'
        totals:
          $ref: '#/components/schemas/Shared8'
        price_qualified:
          type: boolean
        blockers:
          $ref: '#/components/schemas/Shared28'
        ceiling_snapshot:
          $ref: '#/components/schemas/Shared3'
        valid_until:
          $ref: '#/components/schemas/Shared23'
      required:
        - schema_version
        - state
        - evaluated_at
        - mode
        - execution_available
        - request_id
        - request_version
        - proposal_id
        - proposal_version
        - tier_id
        - currency
        - lines
        - totals
        - price_qualified
        - blockers
        - ceiling_snapshot
        - valid_until
      additionalProperties: false
    Shared25:
      anyOf:
        - $ref: '#/components/schemas/Shared27'
        - type: 'null'
    Shared36:
      type: object
      properties:
        namespace:
          type: string
          minLength: 1
          maxLength: 200
        item_id:
          type: string
          minLength: 1
          maxLength: 200
      required:
        - namespace
        - item_id
      additionalProperties: false
    Shared9:
      type: object
      properties:
        ceiling_id:
          type: string
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
        scope:
          $ref: '#/components/schemas/Shared15'
        basis:
          type: string
          enum:
            - items
            - all_in
        currency:
          type: string
          pattern: ^[A-Z]{3}$
          enum:
            - USD
            - ILS
        amount_minor:
          type: integer
          exclusiveMinimum: 0
          maximum: 100000000
      required:
        - ceiling_id
        - scope
        - basis
        - currency
        - amount_minor
      additionalProperties: false
    Shared13:
      type: object
      properties:
        url:
          type: string
          maxLength: 2000
          format: uri
        observed_at:
          $ref: '#/components/schemas/Shared23'
        note:
          type: string
          minLength: 3
          maxLength: 2000
      required:
        - url
        - observed_at
        - note
      additionalProperties: false
    Shared37:
      type: boolean
      description: >-
        True only for authorization_hold, on an Offer made while Popular Demand
        offered payment holds; false for a group-price Offer, where no buyer
        money passes through Popular Demand.
    Shared6:
      type: object
      properties:
        status:
          type: string
          enum:
            - open
            - ended
        ended_reason:
          anyOf:
            - type: string
              enum:
                - sold_out
                - date_passed
            - type: 'null'
        available_until:
          type:
            - string
            - 'null'
        link:
          $ref: '#/components/schemas/Shared41'
        code:
          description: >-
            What the buyer enters in the discount field at the seller’s
            checkout, if anything.
          type:
            - string
            - 'null'
        link_shows_code:
          description: >-
            Present when the link shows the buyer their own code to enter at the
            seller’s checkout, instead of opening the seller’s page.
          type: boolean
          const: true
        units_left:
          description: >-
            Present only when the price has a unit limit: the units still free
            now.
          type: integer
          minimum: 0
          maximum: 9007199254740991
      required:
        - status
        - ended_reason
        - available_until
        - link
        - code
      additionalProperties: false
    Shared42:
      type: boolean
      const: false
      description: >-
        Always false: Popular Demand never executes or accepts a purchase on the
        person's behalf; the person buys at the seller's own checkout (see
        execution).
    Shared2:
      type: object
      properties:
        state:
          type: string
          enum:
            - not_counted
            - potential
            - validated
            - needs_user
            - committed
        reasons:
          type: array
          items:
            type: string
        price_qualified:
          type: boolean
          description: >-
            Label only: the stated price policy qualifies this price. Not
            authorization.
        price_position:
          $ref: '#/components/schemas/Shared24'
        above_limit_by_minor:
          anyOf:
            - type: integer
              exclusiveMinimum: 0
              maximum: 9007199254740991
            - type: 'null'
        price_position_reason:
          $ref: '#/components/schemas/Shared17'
        request_committed_total_minor:
          description: >-
            Applies only to an Offer made while Popular Demand offered payment
            holds; otherwise 0.
          type: integer
          minimum: 0
          maximum: 9007199254740991
        request_limit_minor:
          $ref: '#/components/schemas/Shared29'
        above_request_limit_by_minor:
          $ref: '#/components/schemas/Shared35'
        request_total_with_offer_minor:
          $ref: '#/components/schemas/Shared32'
        above_request_limit_with_offer_by_minor:
          $ref: '#/components/schemas/Shared26'
        agent_reason_code:
          anyOf:
            - type: string
              enum:
                - price
                - quantity
                - product
                - terms
                - delivery
                - timing
                - seller
                - other
            - type: 'null'
        validated_at:
          $ref: '#/components/schemas/Shared21'
        hold:
          $ref: '#/components/schemas/Shared16'
        payment_hold_available:
          type: boolean
          description: >-
            Applies only to an Offer made while Popular Demand offered payment
            holds; otherwise false.
        payment_hold_resumable:
          type: boolean
          description: >-
            Applies only to an Offer made while Popular Demand offered payment
            holds; otherwise false.
        payment_hold_opens_at:
          $ref: '#/components/schemas/Shared19'
        payment_hold_reauthorization:
          $ref: '#/components/schemas/Shared10'
      required:
        - state
        - reasons
        - price_qualified
        - price_position
        - above_limit_by_minor
        - agent_reason_code
        - validated_at
        - hold
        - payment_hold_available
        - payment_hold_resumable
        - payment_hold_opens_at
        - payment_hold_reauthorization
      additionalProperties: false
      description: >-
        Derived demand state: potential (fits the outcome), validated (the buyer
        agent's latest pre-check of this exact Offer version said fits),
        needs_user (the agent must ask the user), committed (an authorized card
        payment, only on an Offer made while Popular Demand offered payment
        holds). not_counted means no current claim, never a refusal unless
        reasons say the agent declined. Price position is a label, never a gate.
    Shared33:
      description: >-
        Evaluation-rule identity, distinct from schema_version. Missing
        historical identities are unknown; they are never defaulted to current
        rules.
      type: string
      pattern: ^plan_evaluation_v[1-9][0-9]{0,5}$
    Shared4:
      type: array
      items:
        $ref: '#/components/schemas/Shared5'
    Shared8:
      type: object
      properties:
        items_minor:
          type: integer
          minimum: 0
          maximum: 100000000
        delivery_minor:
          anyOf:
            - type: integer
              minimum: 0
              maximum: 100000000
            - type: 'null'
        tax_minor:
          $ref: '#/components/schemas/Shared31'
        duties_minor:
          anyOf:
            - type: integer
              minimum: 0
              maximum: 100000000
            - type: 'null'
        fees_minor:
          anyOf:
            - type: integer
              minimum: 0
              maximum: 100000000
            - type: 'null'
        all_in_minor:
          $ref: '#/components/schemas/Shared34'
      required:
        - items_minor
        - delivery_minor
        - tax_minor
        - duties_minor
        - fees_minor
        - all_in_minor
      additionalProperties: false
    Shared28:
      type: array
      items:
        $ref: '#/components/schemas/Shared30'
    Shared3:
      type: object
      properties:
        root_all_in_minor:
          anyOf:
            - type: integer
              minimum: 0
              maximum: 100000000
            - type: 'null'
        pricing_mode:
          type: string
          enum:
            - explore
            - explicit
        scoped:
          $ref: '#/components/schemas/Shared7'
        baseline:
          $ref: '#/components/schemas/Shared12'
      required:
        - root_all_in_minor
        - pricing_mode
        - scoped
        - baseline
      additionalProperties: false
    Shared27:
      type: string
      format: date
      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])))$
    Shared15:
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              const: basket
          required:
            - kind
          additionalProperties: false
        - $ref: '#/components/schemas/Shared39'
        - $ref: '#/components/schemas/Shared40'
    Shared41:
      description: >-
        This buyer’s own link to the seller’s deal page; give it only to the
        user. Popular Demand counts visits and, for a linked store, paid orders
        that used its codes.
      type:
        - string
        - 'null'
    Shared24:
      anyOf:
        - type: string
          enum:
            - no_limit
            - within_limit
            - above_limit
            - unknown
        - type: 'null'
      description: >-
        Label only: the current all-in price against the Request’s ceilings.
        Null without a current evaluation. unknown means a limit exists but
        cannot be compared yet (see price_position_reason). above_limit Offers
        are still delivered.
    Shared17:
      anyOf:
        - $ref: '#/components/schemas/Shared20'
        - type: 'null'
    Shared29:
      description: >-
        Label only: the tightest whole-Request all-in limit (the root price or a
        basket all-in ceiling). Null when the person has not set one.
      anyOf:
        - type: integer
          exclusiveMinimum: 0
          maximum: 9007199254740991
        - type: 'null'
    Shared35:
      description: >-
        Label only: how far the committed total exceeds the limit (0 when within
        it, null without a limit). Never a gate.
      anyOf:
        - type: integer
          minimum: 0
          maximum: 9007199254740991
        - type: 'null'
    Shared32:
      description: >-
        Label only: request_committed_total_minor plus this Offer's current
        all-in amount. Null when the all-in amount is unknown.
      anyOf:
        - type: integer
          minimum: 0
          maximum: 9007199254740991
        - type: 'null'
    Shared26:
      description: >-
        Label only: how far request_total_with_offer_minor would exceed the
        whole-Request limit (0 when within it, null without a limit or a known
        total). Never a gate.
      anyOf:
        - type: integer
          minimum: 0
          maximum: 9007199254740991
        - type: 'null'
    Shared21:
      anyOf:
        - $ref: '#/components/schemas/Shared23'
        - type: 'null'
    Shared16:
      anyOf:
        - $ref: '#/components/schemas/Shared18'
        - type: 'null'
    Shared19:
      anyOf:
        - $ref: '#/components/schemas/Shared23'
        - type: 'null'
      description: >-
        Applies only to an Offer made while Popular Demand offered payment
        holds; otherwise null.
    Shared10:
      anyOf:
        - $ref: '#/components/schemas/Shared11'
        - type: 'null'
      description: >-
        Applies only to an Offer made while Popular Demand offered payment
        holds; otherwise null.
    Shared5:
      type: object
      properties:
        line_id:
          type: string
        need_id:
          type: string
        option_id:
          type: string
        seller_item_id:
          type: string
        description:
          type: string
        product:
          $ref: '#/components/schemas/Shared36'
        quantity:
          type: integer
          exclusiveMinimum: 0
          maximum: 9007199254740991
        unit:
          type: object
          properties:
            code:
              type: string
              const: C62
            scale:
              type: number
              const: 0
          required:
            - code
            - scale
          additionalProperties: false
        unit_price_minor:
          type: integer
          minimum: 0
          maximum: 100000000
        items_minor:
          type: integer
          minimum: 0
          maximum: 100000000
        buyer_unit_price_minor:
          description: The unit price of the buyer’s chosen variant, when it differs.
          type: integer
          minimum: 0
          maximum: 100000000
        seller_terms:
          $ref: '#/components/schemas/Shared22'
      required:
        - line_id
        - need_id
        - option_id
        - seller_item_id
        - description
        - product
        - quantity
        - unit
        - unit_price_minor
        - items_minor
      additionalProperties: false
    Shared31:
      anyOf:
        - type: integer
          minimum: 0
          maximum: 100000000
        - type: 'null'
      description: >-
        Tax as the seller states it; Popular Demand never computes tax. Null
        while the seller has not stated it: the all-in total is then unknown.
    Shared34:
      anyOf:
        - type: integer
          minimum: 0
          maximum: 100000000
        - type: 'null'
      description: >-
        What the buyer pays. Popular Demand's platform fee is paid by the seller
        and never added. Null while any cost is unknown.
    Shared30:
      type: object
      properties:
        code:
          type: string
        need_id:
          type: string
        ceiling_id:
          type: string
        above_by_minor:
          type: integer
          minimum: 0
          maximum: 100000000
      required:
        - code
      additionalProperties: false
    Shared7:
      type: array
      items:
        $ref: '#/components/schemas/Shared9'
    Shared12:
      anyOf:
        - $ref: '#/components/schemas/Shared14'
        - type: 'null'
    Shared39:
      type: object
      properties:
        kind:
          type: string
          const: need
        need_id:
          type: string
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
      required:
        - kind
        - need_id
      additionalProperties: false
    Shared40:
      type: object
      properties:
        kind:
          type: string
          const: unit
        need_id:
          type: string
          pattern: ^[a-zA-Z0-9][a-zA-Z0-9._:-]{0,79}$
      required:
        - kind
        - need_id
      additionalProperties: false
    Shared20:
      type: string
      enum:
        - all_in_cost_unknown
        - cost_scope_unknown
        - currency_mismatch
        - variant_price_unknown
      description: >-
        Why a limit cannot be compared yet: all_in_cost_unknown (some delivery,
        tax, duty or fee amount is missing), cost_scope_unknown (the seller did
        not split costs per item for a per-item all-in limit), currency_mismatch
        (a limit uses another currency) or variant_price_unknown (the store’s
        price for the size, colour or version the person chose is not known).
    Shared18:
      type: object
      properties:
        placed_at:
          $ref: '#/components/schemas/Shared23'
        simulated:
          type: boolean
      required:
        - placed_at
        - simulated
      additionalProperties: false
    Shared11:
      type: object
      properties:
        offer_version:
          type: integer
          exclusiveMinimum: 0
          maximum: 9007199254740991
        kind:
          type: string
          enum:
            - lapse
            - capture_refused
        reauthorize_by:
          $ref: '#/components/schemas/Shared23'
      required:
        - offer_version
        - kind
        - reauthorize_by
      additionalProperties: false
    Shared22:
      type: object
      properties:
        warranty_months:
          anyOf:
            - type: integer
              minimum: 0
              maximum: 9007199254740991
            - type: 'null'
        returns_days:
          anyOf:
            - type: integer
              minimum: 0
              maximum: 9007199254740991
            - type: 'null'
        authorized_seller:
          type:
            - boolean
            - 'null'
      required:
        - warranty_months
        - returns_days
        - authorized_seller
      additionalProperties: false
    Shared14:
      type: object
      properties:
        id:
          type: string
        total_minor:
          type: integer
          minimum: 0
          maximum: 100000000
        valid_until:
          $ref: '#/components/schemas/Shared23'
      required:
        - id
        - total_minor
        - valid_until
      additionalProperties: false
  securitySchemes:
    OwnerBearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        An OAuth access token for the buyer resource (audience, issuer and
        signature checked). Its scopes and the active grant the person approved
        are both enforced.

````

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