Amazon Business API

openapi: 3.1.0
info:
  title: Amazon Business 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
paths:
  /ab-invoice/2026-02-01/invoices:
    get:
      operationId: get_ab_invoice_2026_02_01_invoices
      tags:
      - Ab Invoice
      summary: Returns a paginated list of invoices within the specified date range.
      x-source: https://docs.business.amazon.com/docs/invoices-api-reference
      parameters:
      - name: invoiceIssueStartDate
        in: query
        required: true
        schema:
          type: string
        description: The start of the invoice issue date range to search for invoices, in ISO 8601 format. Must not be more than 366 days before
          invoiceIssueEndDate .
      - name: invoiceIssueEndDate
        in: query
        required: true
        schema:
          type: string
        description: The end of the invoice issue date range to search for invoices, in ISO 8601 format. Must not be in the future and must not
          be more than 366 days after invoiceIssueStartDate .
      - name: region
        in: query
        required: false
        schema:
          type: string
        description: 'Marketplace region (currently: JP).'
      - name: nextPageToken
        in: query
        required: false
        schema:
          type: string
        description: A page token returned in response to your previous request when the number of results exceed the page size. Must be used
          with the same query parameters as the original request.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAbInvoice20260201InvoicesResponse'
      x-evidence:
        kind: documentation
  /ab-invoice/2026-02-01/invoices/{invoicenumber}:
    get:
      operationId: get_ab_invoice_2026_02_01_invoices_invoicenumber
      tags:
      - Ab Invoice
      summary: Returns detailed information for a specific invoice identified by its invoice number.
      x-source: https://docs.business.amazon.com/docs/invoices-api-reference
      parameters:
      - name: invoicenumber
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: 'Marketplace region (currently: JP).'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAbInvoice20260201InvoicesInvoicenumberResponse'
      x-evidence:
        kind: documentation
  /ab-invoice/2026-02-01/invoices/{invoicenumber}/lineItems:
    get:
      operationId: get_ab_invoice_2026_02_01_invoices_invoicenumber_lineItems
      tags:
      - Ab Invoice
      summary: Returns paginated line items for a given invoice. Returns CHARGE items first, then REFUND items, maintaining order across pages.
      x-source: https://docs.business.amazon.com/docs/invoices-api-reference
      parameters:
      - name: invoicenumber
        in: path
        required: true
        schema:
          type: string
      - name: region
        in: query
        required: true
        schema:
          type: string
        description: 'Marketplace region (currently: JP).'
      - name: nextPageToken
        in: query
        required: false
        schema:
          type: string
        description: A page token returned in response to your previous request. Tokens expire after 15 minutes.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAbInvoice20260201InvoicesInvoicenumberLineitemsResponse'
      x-evidence:
        kind: documentation
  /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 region.
      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 aggregate-level data for the entire cart without including individual
        item details.
      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
  /ordering/2022-10-30/orders:
    post:
      operationId: post_ordering_2022_10_30_orders
      tags:
      - Ordering
      summary: 'Ordering API provides two operations:'
      x-source: https://docs.business.amazon.com/docs/ordering-api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /ordering/2022-10-30/orders/{externalid}:
    get:
      operationId: get_ordering_2022_10_30_orders_externalid
      tags:
      - Ordering
      summary: 'Ordering API provides two operations:'
      x-source: https://docs.business.amazon.com/docs/ordering-api
      parameters:
      - name: externalid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /products/2020-08-26/products:
    get:
      operationId: get_products_2020_08_26_products
      tags:
      - Products
      summary: searchProductsRequest
      description: Sample endpoint for searching products.
      x-source: https://docs.business.amazon.com/docs/sample-endpoints
      parameters:
      - name: productRegion
        in: query
        required: true
        schema:
          type: string
        description: Region of the product (e.g., US).
      - name: locale
        in: query
        required: true
        schema:
          type: string
        description: Locale for the response (e.g., en_US).
      - name: facets
        in: query
        required: false
        schema:
          type: string
        description: Facets to include, such as OFFERS.
      - name: keywords
        in: query
        required: false
        schema:
          type: string
        description: Search keywords, e.g., laptop.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /products/2020-08-26/products/B091WR26F4/offers:
    get:
      operationId: get_products_2020_08_26_products_B091WR26F4_offers
      tags:
      - Products
      summary: searchOffersRequest
      description: Sample endpoint for retrieving offers for a specific product.
      x-source: https://docs.business.amazon.com/docs/sample-endpoints
      parameters:
      - name: productRegion
        in: query
        required: true
        schema:
          type: string
        description: Region of the product (e.g., US).
      - name: locale
        in: query
        required: true
        schema:
          type: string
        description: Locale for the response (e.g., en_US).
      - name: facets
        in: query
        required: false
        schema:
          type: string
        description: Facets to include, such as OFFERS.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /products/2020-08-26/products/getProductsByAsins:
    post:
      operationId: post_products_2020_08_26_products_getProductsByAsins
      tags:
      - Products
      summary: getProductsByAsins
      description: Sample endpoint for retrieving product details by ASINs.
      x-source: https://docs.business.amazon.com/docs/sample-endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostProducts20200826ProductsGetproductsbyasinsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /reports/2021-09-30/documents/{reportdocumentid}:
    get:
      operationId: get_reports_2021_09_30_documents_reportdocumentid
      tags:
      - Reports
      summary: 'Document API provides the following operations:'
      x-source: https://docs.business.amazon.com/docs/document-api
      parameters:
      - name: reportdocumentid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /reports/2021-09-30/reports:
    get:
      operationId: get_reports_2021_09_30_reports
      tags:
      - Reports
      summary: 'Document API provides the following operations:'
      x-source: https://docs.business.amazon.com/docs/document-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_reports_2021_09_30_reports
      tags:
      - Reports
      summary: 'Document API provides the following operations:'
      x-source: https://docs.business.amazon.com/docs/document-api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /reports/2021-09-30/reports/{reportid}:
    delete:
      operationId: delete_reports_2021_09_30_reports_reportid
      tags:
      - Reports
      summary: 'Document API provides the following operations:'
      x-source: https://docs.business.amazon.com/docs/document-api
      parameters:
      - name: reportid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_reports_2021_09_30_reports_reportid
      tags:
      - Reports
      summary: 'Document API provides the following operations:'
      x-source: https://docs.business.amazon.com/docs/document-api
      parameters:
      - name: reportid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetAbInvoice20260201InvoicesResponse:
      type: object
      properties:
        '200':
          type: string
          description: Success.
        '400':
          type: string
          description: Request has missing or invalid parameters and cannot be parsed.
        '401':
          type: string
          description: The request's Authorization header is not formatted correctly or does not contain a valid token.
        '403':
          type: string
          description: Indicates that access to the resource is forbidden.
        '404':
          type: string
          description: The resource specified does not exist.
        '429':
          type: string
          description: The frequency of requests was greater than allowed.
        '500':
          type: string
          description: An unexpected condition occurred that prevented the server from fulfilling the request.
        '504':
          type: string
          description: A gateway timeout occurred.
    GetAbInvoice20260201InvoicesInvoicenumberResponse:
      type: object
      properties:
        '200':
          type: string
          description: Success.
        '400':
          type: string
          description: Request has missing or invalid parameters and cannot be parsed.
        '401':
          type: string
          description: The request's Authorization header is not formatted correctly or does not contain a valid token.
        '403':
          type: string
          description: Indicates that access to the resource is forbidden.
        '404':
          type: string
          description: The resource specified does not exist.
        '429':
          type: string
          description: The frequency of requests was greater than allowed.
        '500':
          type: string
          description: An unexpected condition occurred that prevented the server from fulfilling the request.
        '504':
          type: string
          description: A gateway timeout occurred.
    GetAbInvoice20260201InvoicesInvoicenumberLineitemsResponse:
      type: object
      properties:
        '200':
          type: string
          description: Success.
        '400':
          type: string
          description: Request has missing or invalid parameters and cannot be parsed.
        '401':
          type: string
          description: The request's Authorization header is not formatted correctly or does not contain a valid token.
        '403':
          type: string
          description: Indicates that access to the resource is forbidden.
        '404':
          type: string
          description: The resource specified does not exist.
        '429':
          type: string
          description: The frequency of requests was greater than allowed.
        '500':
          type: string
          description: An unexpected condition occurred that prevented the server from fulfilling the request.
        '504':
          type: string
          description: A gateway timeout occurred.
    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.
    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.
    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.
    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.
    PatchCart20250430CartsCartidItemsRequest:
      type: object
      properties:
        modifyItemsRequest:
          type: string
          description: Request to modify items in the cart.
      required:
      - modifyItemsRequest
    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.
    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.
    PostProducts20200826ProductsGetproductsbyasinsRequest:
      type: object
      properties:
        productIds:
          type: array
          description: List of product ASINs.
        productRegion:
          type: string
          description: Region of the products (e.g., US).
        locale:
          type: string
          description: Locale for the response (e.g., en_US).
        facets:
          type: array
          description: Facets to include, such as OFFERS.
      required:
      - productIds
      - productRegion
      - locale
tags:
- name: Ab Invoice
- name: Cart
- name: Ordering
- name: Products
- name: Reports