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

# Deliver Approved Prices

> Replayable scalar price delivery; saved evidence remains in history/details.



## OpenAPI

````yaml https://clientapi.retailgrid.io/openapi.json post /v1/approved_prices/deliveries
openapi: 3.1.0
info:
  title: Retailgrid Public API
  version: v1
servers: []
security: []
paths:
  /v1/approved_prices/deliveries:
    post:
      tags:
        - approved_prices
      summary: Deliver Approved Prices
      description: >-
        Replayable scalar price delivery; saved evidence remains in
        history/details.
      operationId: deliver_approved_prices_v1_approved_prices_deliveries_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeliveryRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApprovedPricesListResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    DeliveryRequest:
      properties:
        request_id:
          type: string
          format: uuid
          title: Request Id
        filters:
          $ref: '#/components/schemas/ApprovedPriceListFilters'
        pagination:
          $ref: '#/components/schemas/ApprovedPricePagination'
      additionalProperties: false
      type: object
      required:
        - request_id
      title: DeliveryRequest
    ApprovedPricesListResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/ApprovedPriceListItem'
          type: array
          title: Items
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
      type: object
      title: ApprovedPricesListResponse
      description: '``GET /v1/approved_prices`` response envelope.'
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ApprovedPriceListFilters:
      properties:
        history:
          type: boolean
          title: History
          default: false
        approved_after:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Approved After
        approved_before:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Approved Before
        effective_after:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Effective After
        effective_before:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Effective Before
        grid_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Grid Id
        store_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Store Id
        item_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Item Id
        sku:
          anyOf:
            - type: string
            - type: 'null'
          title: Sku
      type: object
      title: ApprovedPriceListFilters
      description: Filters accepted by ``GET /v1/approved_prices``.
    ApprovedPricePagination:
      properties:
        limit:
          type: integer
          maximum: 500
          minimum: 1
          title: Limit
          default: 100
        cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Cursor
      type: object
      title: ApprovedPricePagination
      description: Cursor pagination params for approved-price listing.
    ApprovedPriceListItem:
      properties:
        id:
          type: integer
          title: Id
        grid_id:
          type: string
          format: uuid
          title: Grid Id
        grid_item_id:
          type: integer
          title: Grid Item Id
        item_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Item Id
        sku:
          anyOf:
            - type: string
            - type: 'null'
          title: Sku
        store_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Store Id
        current_price:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Current Price
        proposed_price:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Proposed Price
        approved_price:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Approved Price
        effective_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Effective Date
        currency_code:
          type: string
          title: Currency Code
        proposal_source:
          anyOf:
            - type: string
              enum:
                - dp
                - po
                - po_dp
            - type: 'null'
          title: Proposal Source
        source:
          type: string
          enum:
            - dp
            - po
            - po_dp
            - user_defined
          title: Source
        trace:
          items:
            $ref: '#/components/schemas/ApprovedPriceTraceItem'
          type: array
          title: Trace
        approved_at:
          type: string
          format: date-time
          title: Approved At
        approval_details:
          anyOf:
            - $ref: '#/components/schemas/AutoApprovalAudit'
            - type: 'null'
        approved_by_user_id:
          type: string
          format: uuid
          title: Approved By User Id
        export_status:
          type: string
          enum:
            - pending
            - exported_api
            - cancelled
          title: Export Status
          default: pending
        exported_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Exported At
        cancelled_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Cancelled At
        predecessor_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Predecessor Id
        amendment_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Amendment Reason
        delivery_channel:
          anyOf:
            - type: string
              enum:
                - client_api
                - shopify_api
                - legacy_acknowledgement
            - type: 'null'
          title: Delivery Channel
      type: object
      required:
        - id
        - grid_id
        - grid_item_id
        - proposed_price
        - approved_price
        - currency_code
        - source
        - approved_at
        - approved_by_user_id
      title: ApprovedPriceListItem
      description: Public approved-price response row.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ApprovedPriceTraceItem:
      properties:
        source:
          type: string
          enum:
            - dp
            - po
          title: Source
        column_key:
          type: string
          title: Column Key
        source_job_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Job Id
        payload:
          anyOf:
            - {}
            - type: 'null'
          title: Payload
      type: object
      required:
        - source
        - column_key
      title: ApprovedPriceTraceItem
      description: One trace item attached to an approved price.
    AutoApprovalAudit:
      properties:
        method:
          type: string
          title: Method
          default: automatic
        run_id:
          type: string
          format: uuid
          title: Run Id
        policy_id:
          type: string
          format: uuid
          title: Policy Id
        policy_revision:
          type: integer
          title: Policy Revision
        user_id:
          type: string
          format: uuid
          title: User Id
        evaluated_at:
          type: string
          format: date-time
          title: Evaluated At
        minimum_margin_pct:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Minimum Margin Pct
        maximum_change_pct:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Maximum Change Pct
        margin_pct:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Margin Pct
        change_pct:
          type: string
          pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
          title: Change Pct
      type: object
      required:
        - run_id
        - policy_id
        - policy_revision
        - user_id
        - evaluated_at
        - minimum_margin_pct
        - maximum_change_pct
        - margin_pct
        - change_pct
      title: AutoApprovalAudit

````

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