Newstore cart API

Operations on carts

Operations 7

POST /checkout/carts createCart #
GET /checkout/carts/{cartId} showCart #
PATCH /checkout/carts/{cartId} updateCart #
POST /checkout/carts/{cartId}/items createLineItem #
DELETE /checkout/carts/{cartId}/items/{lineItemId} destroyLineItem #
PATCH /checkout/carts/{cartId}/items/{lineItemId} updateLineItem #
POST /checkout/carts/{cartId}/items/{lineItemId}/add-ons createAddOnLineItem #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/newstore-cart-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

newstore-cart-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: '1.0'
  title: NewStore Cart API
  description: NewStore public APIs
  contact:
    email: support@newstore.com
    name: NewStore API Support
    url: https://developer.newstore.com
servers:
- url: https://dodici-demo.p.newstore.net/
security: []
tags:
- name: cart
  description: Operations on carts
paths:
  /checkout/carts:
    post:
      description: Creates a new empty cart.
      summary: createCart
      tags:
      - cart
      operationId: createCart
      deprecated: false
      parameters:
      - name: Content-Type
        in: header
        required: false
        description: ''
        schema:
          type: string
          enum:
          - application/json
      responses:
        default:
          description: Unexpected error not otherwise documented
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '201':
          description: Created
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Methods:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
            Access-Control-Expose-Headers:
              schema:
                type: string
            Location:
              schema:
                type: string
        '400':
          description: Bad Request
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable Entity
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal Server Error
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Bad Gateway
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Service Unavailable
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - oauth:
        - checkout:carts:write
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCartRequestBody'
        required: true
  /checkout/carts/{cartId}:
    get:
      description: Returns a cart by its ID.
      summary: showCart
      tags:
      - cart
      operationId: showCart
      deprecated: false
      parameters:
      - name: cartId
        in: path
        required: true
        description: Cart ID
        schema:
          type: string
      responses:
        default:
          description: Unexpected error not otherwise documented
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '200':
          description: OK
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/CartResource'
            application/json:
              schema:
                $ref: '#/components/schemas/CartResource'
        '400':
          description: Bad Request
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Not Found
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable Entity
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal Server Error
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Bad Gateway
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Service Unavailable
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - oauth:
        - checkout:carts:read
    patch:
      description: Changes a cart.
      summary: updateCart
      tags:
      - cart
      operationId: updateCart
      deprecated: false
      parameters:
      - name: cartId
        in: path
        required: true
        description: Cart ID
        schema:
          type: string
      - name: Content-Type
        in: header
        required: false
        description: ''
        schema:
          type: string
          enum:
          - application/json
      responses:
        default:
          description: Unexpected error not otherwise documented
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '200':
          description: OK
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Methods:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
            Access-Control-Expose-Headers:
              schema:
                type: string
        '400':
          description: Bad Request
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Not Found
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Conflict
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable Entity
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal Server Error
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Bad Gateway
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Service Unavailable
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - oauth:
        - checkout:carts:write
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeCartRequestBody'
        required: true
  /checkout/carts/{cartId}/items:
    post:
      description: Add a line item to a cart
      summary: createLineItem
      tags:
      - cart
      operationId: createLineItem
      deprecated: false
      parameters:
      - name: cartId
        in: path
        required: true
        description: Cart ID
        schema:
          type: string
      - name: Content-Type
        in: header
        required: false
        description: ''
        schema:
          type: string
          enum:
          - application/json
      responses:
        default:
          description: Unexpected error not otherwise documented
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '201':
          description: Created
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Methods:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
            Access-Control-Expose-Headers:
              schema:
                type: string
            Location:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/AddItemResponseBody'
            application/json:
              schema:
                $ref: '#/components/schemas/AddItemResponseBody'
        '400':
          description: Bad Request
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Not Found
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Conflict
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable Entity
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal Server Error
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Bad Gateway
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Service Unavailable
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - oauth:
        - checkout:carts:write
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddItemRequestBody'
        required: true
  /checkout/carts/{cartId}/items/{lineItemId}:
    delete:
      description: Removes a line item and all its add-ons from the cart.
      summary: destroyLineItem
      tags:
      - cart
      operationId: destroyLineItem
      deprecated: false
      parameters:
      - name: cartId
        in: path
        required: true
        description: Cart ID
        schema:
          type: string
      - name: lineItemId
        in: path
        required: true
        description: Line Item ID
        schema:
          type: string
      responses:
        default:
          description: Unexpected error not otherwise documented
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '200':
          description: OK
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/RemoveItemResponseBody'
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveItemResponseBody'
        '400':
          description: Bad Request
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Not Found
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Conflict
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable Entity
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal Server Error
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Bad Gateway
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Service Unavailable
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - oauth:
        - checkout:carts:write
    patch:
      description: Updates cart line item details
      summary: updateLineItem
      tags:
      - cart
      operationId: updateLineItem
      deprecated: false
      parameters:
      - name: cartId
        in: path
        required: true
        description: Cart ID
        schema:
          type: string
      - name: lineItemId
        in: path
        required: true
        description: Line Item ID
        schema:
          type: string
      - name: Content-Type
        in: header
        required: false
        description: ''
        schema:
          type: string
          enum:
          - application/json
      responses:
        default:
          description: Unexpected error not otherwise documented
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '200':
          description: OK
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Methods:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
            Access-Control-Expose-Headers:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ChangeItemResponseBody'
            application/json:
              schema:
                $ref: '#/components/schemas/ChangeItemResponseBody'
        '400':
          description: Bad Request
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Not Found
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Conflict
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable Entity
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal Server Error
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Bad Gateway
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Service Unavailable
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - oauth:
        - checkout:carts:write
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeItemRequestBody'
        required: true
  /checkout/carts/{cartId}/items/{lineItemId}/add-ons:
    post:
      description: Create an add-on for a line item on a cart
      summary: createAddOnLineItem
      tags:
      - cart
      operationId: createAddOnLineItem
      deprecated: false
      parameters:
      - name: cartId
        in: path
        required: true
        description: Cart ID
        schema:
          type: string
      - name: lineItemId
        in: path
        required: true
        description: Parent Line Item ID
        schema:
          type: string
      - name: Content-Type
        in: header
        required: false
        description: ''
        schema:
          type: string
          enum:
          - application/json
      responses:
        default:
          description: Unexpected error not otherwise documented
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '201':
          description: Created
          headers:
            Access-Control-Allow-Headers:
              schema:
                type: string
            Access-Control-Allow-Methods:
              schema:
                type: string
            Access-Control-Allow-Origin:
              schema:
                type: string
            Access-Control-Expose-Headers:
              schema:
                type: string
            Location:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/AddItemResponseBody'
            application/json:
              schema:
                $ref: '#/components/schemas/AddItemResponseBody'
        '400':
          description: Bad Request
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '404':
          description: Not Found
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Conflict
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '422':
          description: Unprocessable Entity
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal Server Error
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Bad Gateway
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Service Unavailable
          headers: {}
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - oauth:
        - checkout:carts:write
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddItemRequestBody'
        required: true
components:
  schemas:
    AddOnLinks:
      title: AddOnLinks
      type: object
      properties:
        change_add_on:
          $ref: '#/components/schemas/Link'
        remove_add_on:
          $ref: '#/components/schemas/Link'
        self:
          $ref: '#/components/schemas/Link'
      required:
      - self
    AddItemItemPrice:
      title: AddItemItemPrice
      type: object
      properties:
        source:
          type: object
          allOf:
          - $ref: '#/components/schemas/Source'
          - description: Price source
            example: INTERNAL
        source_id:
          description: Price source ID, e.g. name of pricebook
          example: default
          type: string
    ExtendedAttribute:
      title: ExtendedAttribute
      type: object
      properties:
        name:
          description: Extended attribute name
          type: string
        value:
          description: Extended attribute value
          type: string
      required:
      - name
      - value
    AddItemExtendedAttribute:
      title: AddItemExtendedAttribute
      type: object
      properties:
        name:
          example: engraving
          type: string
        value:
          example: For you.
          type: string
      required:
      - name
      - value
    Fulfillment:
      title: Fulfillment
      description: Fulfillment type
      type: string
      enum:
      - SHIPPING
      - IN_STORE_HANDOVER
    ChangeItemResponseBody:
      title: ChangeItemResponseBody
      type: object
      properties:
        messages:
          type: array
          items:
            type: string
        warnings:
          type: array
          items:
            type: string
      required:
      - messages
      - warnings
    RemoveItemResponseBody:
      title: RemoveItemResponseBody
      type: object
      properties:
        messages:
          description: Informational messages
          type: array
          items:
            type: string
        warnings:
          description: Warning messages
          type: array
          items:
            type: string
      required:
      - messages
      - warnings
    AddItemRequestBody:
      title: AddItemRequestBody
      type: object
      properties:
        epc:
          example: 30A12BCDEF0123456789A1BCDEF01234
          type: string
        extended_attributes:
          type: array
          items:
            $ref: '#/components/schemas/AddItemExtendedAttribute'
          maxItems: 100
        fulfillment:
          type: object
          allOf:
          - $ref: '#/components/schemas/Fulfillment'
          - description: Fulfillment type
        price:
          $ref: '#/components/schemas/AddItemItemPrice'
        product_id:
          description: Product ID
          example: '1000761'
          type: string
        serial_number:
          example: ABC123
          type: string
        source_id:
          description: Source identifier
          example: gid://newstore/reservations/523/items/345
          type: string
      required:
      - product_id
    ChangeCartRequestBody:
      title: ChangeCartRequestBody
      type: object
      properties:
        customer_id:
          description: Customer ID
          example: 0196f384-9d57-7190-9e3e-89d5816f5805
          type: string
    ChangeItemExtendedAttribute:
      title: ChangeItemExtendedAttribute
      type: object
      properties:
        name:
          example: engraving
          type: string
        value:
          example: For you.
          type: string
      required:
      - name
      - value
    ItemLinks:
      title: ItemLinks
      type: object
      properties:
        add_add_on:
          $ref: '#/components/schemas/Link'
        add_ons:
          $ref: '#/components/schemas/Link'
        change_item:
          $ref: '#/components/schemas/Link'
        remove_item:
          $ref: '#/components/schemas/Link'
        self:
          $ref: '#/components/schemas/Link'
      required:
      - add_ons
      - self
    AddOnResource:
      title: AddOnResource
      type: object
      properties:
        _links:
          $ref: '#/components/schemas/AddOnLinks'
        extended_attributes:
          description: Extended attributes
          type: array
          items:
            $ref: '#/components/schemas/ExtendedAttribute'
        fulfillment:
          description: Fulfillment method, can be SHIPPING,IN_STORE_HANDOVER
          type: string
        id:
          description: Line ID
          type: string
        price:
          $ref: '#/components/schemas/ItemPrice'
        product_id:
          description: Item ID
          type: string
        quantity:
          description: Number of items in the line
          type: integer
          format: int32
        source_id:
          description: Source identifier
          type: string
      required:
      - _links
      - extended_attributes
      - id
      - price
      - product_id
      - quantity
    Problem:
      title: Problem
      type: object
      properties:
        detail:
          description: A human readable explanation specific to this occurrence of the problem that is helpful to locate the problem and give advice on how to proceed. Written in English and readable for engineers, usually not suited for non technical stakeholders and not localized.
          example: some description for the error situation
          type: string
        error_code:
          type: string
        instance:
          description: A URI reference that identifies the specific occurrence of the problem, e.g. by adding a fragment identifier or sub-path to the problem type. May be used to locate the root of this problem in the source code.
          example: /some/uri-reference#specific-

# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/newstore/refs/heads/main/openapi/newstore-cart-api-openapi.yml