Amazon Business Cart API

openapi: 3.2.0
info:
  title: Amazon Business Cart API
  version: '2026-10-13'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-13: 19 operation(s) read from 8 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Amazon Business has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 19
    pages-with-code: 0
    pages-read: 8
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-13'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.business.amazon.com/docs/document-api
  - https://docs.business.amazon.com/docs/ordering-api
  - https://docs.business.amazon.com/docs/e-invoicing-for-ordering-api
  - https://docs.business.amazon.com/docs/sample-endpoints
  - https://docs.business.amazon.com/docs/cart-api-v1-reference
  - https://docs.business.amazon.com/docs/invoices-api-reference
  - https://docs.business.amazon.com/docs/ordering-api-v1-reference
  - https://docs.business.amazon.com/docs/document-api-v1-reference-1
servers:
- url: https://na.business-api.amazon.com
tags:
- name: Cart
paths:
  /cart/2025-04-30/carts:
    get:
      operationId: get_cart_2025_04_30_carts
      tags:
      - Cart
      summary: Retrieves a paginated list of cart summaries for a customer in the specified…
      x-source: https://docs.business.amazon.com/docs/cart-api-v1-reference
      parameters:
      - name: x-amz-user-email
        in: header
        required: true
        schema:
          type: string
        description: Email address of the Amazon Business customer making the request.
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: The region where the customer wants to retrieve the carts.
      - name: pageToken
        in: query
        required: false
        schema:
          type: string
        description: A page token returned in the response to your previous request when the number of results exceed the page size.
      - name: pageSize
        in: query
        required: false
        schema:
          type: string
        description: Number of cart summaries to return per page.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCart20250430CartsResponse'
      x-evidence:
        kind: documentation
  /cart/2025-04-30/carts/{cartid}:
    get:
      operationId: get_cart_2025_04_30_carts_cartid
      tags:
      - Cart
      summary: Retrieves a summary of the cart's overall information, providing…
      x-source: https://docs.business.amazon.com/docs/cart-api-v1-reference
      parameters:
      - name: cartid
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: The region where the customer wants to retrieve the cart.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCart20250430CartsCartidResponse'
      x-evidence:
        kind: documentation
  /cart/2025-04-30/carts/{cartid}/items:
    delete:
      operationId: delete_cart_2025_04_30_carts_cartid_items
      tags:
      - Cart
      summary: Deletes all items in the cart
      x-source: https://docs.business.amazon.com/docs/cart-api-v1-reference
      parameters:
      - name: cartid
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: The region where the customer wants to delete items from the cart.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteCart20250430CartsCartidItemsResponse'
      x-evidence:
        kind: documentation
    get:
      operationId: get_cart_2025_04_30_carts_cartid_items
      tags:
      - Cart
      summary: Retrieves the items in the cart
      x-source: https://docs.business.amazon.com/docs/cart-api-v1-reference
      parameters:
      - name: cartid
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: The region where the customer wants to retrieve the cart items.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCart20250430CartsCartidItemsResponse'
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_cart_2025_04_30_carts_cartid_items
      tags:
      - Cart
      summary: Modifies items in the cart
      x-source: https://docs.business.amazon.com/docs/cart-api-v1-reference
      parameters:
      - name: cartid
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: The region where the customer wants to modify items in the cart.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchCart20250430CartsCartidItemsRequest'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchCart20250430CartsCartidItemsResponse'
      x-evidence:
        kind: documentation
  /cart/2025-04-30/carts/{cartid}/{id}:
    post:
      operationId: post_cart_2025_04_30_carts_cartid_id
      tags:
      - Cart
      summary: Adds items to the cart
      x-source: https://docs.business.amazon.com/docs/cart-api-v1-reference
      parameters:
      - name: cartid
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: The region where the customer wants to add items to the cart.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCart20250430CartsCartidIdRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostCart20250430CartsCartidIdResponse'
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at id
components:
  schemas:
    GetCart20250430CartsCartidResponse:
      type: object
      properties:
        Cart:
          type: string
          description: The cart details were successfully retrieved.
        x-amzn-RateLimit-Limit:
          type: string
          description: Your rate limit (requests per second) for this operation.
        x-amzn-RequestId:
          type: string
          description: Unique request reference identifier.
    PostCart20250430CartsCartidIdRequest:
      type: object
      properties:
        addItemRequest:
          type: string
          description: Request to add items to the cart.
      required:
      - addItemRequest
    PostCart20250430CartsCartidIdResponse:
      type: object
      properties:
        AddItemsResult:
          type: string
          description: The items were successfully added to the cart.
        x-amzn-RateLimit-Limit:
          type: string
          description: Your rate limit (requests per second) for this operation.
        x-amzn-RequestId:
          type: string
          description: Unique request reference identifier.
    GetCart20250430CartsResponse:
      type: object
      properties:
        CartDetailsResult:
          type: string
          description: The cart details list was successfully retrieved.
        x-amzn-RateLimit-Limit:
          type: string
          description: Your rate limit (requests per second) for this operation.
        x-amzn-RequestId:
          type: string
          description: Unique request reference identifier.
    PatchCart20250430CartsCartidItemsRequest:
      type: object
      properties:
        modifyItemsRequest:
          type: string
          description: Request to modify items in the cart.
      required:
      - modifyItemsRequest
    GetCart20250430CartsCartidItemsResponse:
      type: object
      properties:
        CartItems:
          type: string
          description: The Cart items were successfully retrieved.
        x-amzn-RateLimit-Limit:
          type: string
          description: Your rate limit (requests per second) for this operation.
        x-amzn-RequestId:
          type: string
          description: Unique request reference identifier.
    PatchCart20250430CartsCartidItemsResponse:
      type: object
      properties:
        ModifyItemsResult:
          type: string
          description: The Cart items were successfully modified.
        x-amzn-RateLimit-Limit:
          type: string
          description: Your rate limit (requests per second) for this operation.
        x-amzn-RequestId:
          type: string
          description: Unique request reference identifier.
    DeleteCart20250430CartsCartidItemsResponse:
      type: object
      properties:
        204 No Content:
          type: string
          description: Items were successfully deleted from the cart.
        x-amzn-RateLimit-Limit:
          type: string
          description: Your rate limit (requests per second) for this operation.
        x-amzn-RequestId:
          type: string
          description: Unique request reference identifier.