openapi: 3.0.3
info:
  title: Deliveroo Catalogue API
  description: >-
    Part of the Deliveroo Retail Platform Suite. The Catalogue API lets grocery
    and non-food retailers manage a master catalogue of up to 30,000 items per
    brand, publish product data and availability across retail sites, and
    override item prices at the site level. Authentication uses an OAuth 2.0
    client credentials bearer token.
  version: v1
  x-generated-from: documentation
  x-last-validated: '2026-06-02'
  contact:
    name: Kin Lane
    email: kin@apievangelist.com
servers:
- url: https://api.developers.deliveroo.com
  description: Production
- url: https://api-sandbox.developers.deliveroo.com
  description: Sandbox
tags:
- name: Catalogue
- name: Pricing
security:
- bearerAuth: []
paths:
  /brands/{brand_id}/catalogue/{catalogue_id}:
    get:
      operationId: getCatalogue
      summary: Deliveroo Get Catalogue
      description: >-
        Retrieve the latest uploaded catalogue for a brand by catalogue ID. Rate
        limited to 95 requests per catalogue per minute.
      tags:
      - Catalogue
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      parameters:
      - name: brand_id
        in: path
        required: true
        description: The brand identifier.
        schema:
          type: string
        example: gb-12345
      - name: catalogue_id
        in: path
        required: true
        description: The catalogue identifier.
        schema:
          type: string
        example: gb-12345
      responses:
        '200':
          description: The requested catalogue.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalogue'
              examples:
                GetCatalogue200Example:
                  summary: Default getCatalogue 200 response
                  x-microcks-default: true
                  value:
                    catalogue_id: gb-12345
                    name: Example
                    items:
                    - id: gb-12345
                      name: Example
                      price: 0
        '404':
          description: Catalogue not found.
        '429':
          description: Too many requests.
        '500':
          description: Server error.
  /brands/{brand_id}/catalogue/{catalogue_id}/sites/{site_id}/prices:
    put:
      operationId: updatePricesPerSite
      summary: Deliveroo Update Prices Per Site
      description: >-
        Override item prices at the site level, enabling site-specific pricing
        without creating multiple master catalogues.
      tags:
      - Pricing
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
      parameters:
      - name: brand_id
        in: path
        required: true
        description: The brand identifier.
        schema:
          type: string
        example: gb-12345
      - name: catalogue_id
        in: path
        required: true
        description: The catalogue identifier.
        schema:
          type: string
        example: gb-12345
      - name: site_id
        in: path
        required: true
        description: The site identifier whose prices are being overridden.
        schema:
          type: string
        example: gb-12345
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SitePriceOverrides'
            examples:
              UpdatePricesPerSiteRequestExample:
                summary: Default updatePricesPerSite request
                x-microcks-default: true
                value:
                  prices:
                  - item_id: gb-12345
                    price: 499
      responses:
        '200':
          description: Prices updated.
        '400':
          description: Bad request.
        '404':
          description: Catalogue or site not found.
        '500':
          description: Server error.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        OAuth 2.0 client credentials access token obtained from
        https://auth.developers.deliveroo.com/oauth2/token. Tokens expire after
        5 minutes; no refresh tokens are issued.
  schemas:
    Catalogue:
      title: Catalogue
      description: >-
        A master catalogue of retail items for a brand.
        x-schema-source: documentation
        x-source-url: https://api-docs.deliveroo.com/reference/getcatalogue
      type: object
      properties:
        catalogue_id:
          type: string
          description: The catalogue identifier.
          example: gb-12345
        name:
          type: string
          description: The catalogue name.
          example: Example
        items:
          type: array
          description: The products in the catalogue (up to 30,000 per brand).
          items:
            type: object
            properties:
              id:
                type: string
                description: The item identifier.
              name:
                type: string
                description: The product name.
              price:
                type: integer
                description: The price in minor currency units.
    SitePriceOverrides:
      title: Site Price Overrides
      description: >-
        Site-level price overrides for catalogue items.
        x-schema-source: documentation
        x-source-url: https://api-docs.deliveroo.com/reference/updateprices
      type: object
      properties:
        prices:
          type: array
          description: The per-item price overrides for the site.
          items:
            type: object
            properties:
              item_id:
                type: string
                description: The catalogue item identifier.
              price:
                type: integer
                description: The overridden price in minor currency units.
                example: 499