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

# List Sample Rounds



## OpenAPI

````yaml https://app.amber.ai/api/public/v1/openapi.json get /brands/{brand}/sample-rounds
openapi: 3.1.0
info:
  title: Amber Public API
  version: 1.3.0
  description: >-
    Read-only access to brand business data. Products are Parent Products;
    Product Options and SKUs are distinct resources. Follow reference IDs and
    collection cursors for complete graphs. API keys never impersonate their
    creator. New source monetary values are decimal strings; deployed summary
    numbers remain unchanged. JSON specifications retain all nested fields.
    Archived rows remain visible unless soft-deleted; supplier-private quote
    drafts are excluded.
servers:
  - url: https://app.amber.ai/api/public/v1
security: []
tags:
  - name: Brand
  - name: Parent Products
  - name: Product Options
  - name: SKUs
  - name: Product Versions
  - name: Boms
  - name: Bom Components
  - name: Bom Skus
  - name: Measurement Tables
  - name: Measurement Table Skus
  - name: Product Relations
  - name: Product Option Values
  - name: Product Option Dimension Values
  - name: Product Option Prices
  - name: Product Option Collections
  - name: Sku Dimension Values
  - name: Product Collections
  - name: Product Tags
  - name: Product Launch Windows
  - name: Suppliers
  - name: Quotes
  - name: Quote Revisions
  - name: Quote Items
  - name: Quote Price Bands
  - name: Quote Notes
  - name: Samples
  - name: Sample Rounds
  - name: Sample Checklist Results
  - name: Orders
  - name: Order Items
  - name: Order Amendments
  - name: Production Runs
  - name: Production Run Items
  - name: Production Run Item Revisions
  - name: Shipments
  - name: Shipment Items
  - name: Shipment Cartons
  - name: Shipment Carton Items
  - name: Shipment Charges
  - name: Order Shipments
  - name: Legs
  - name: Leg Items
  - name: Bookings
  - name: Booking Items
  - name: Shipment Bookings
  - name: Shipment Item Lineages
  - name: Packing Lists
  - name: Packing List Lines
  - name: Goods Receipts
  - name: Goods Receipt Lines
  - name: Inventory
  - name: Invoices
  - name: Invoice Lines
  - name: Payment Agreements
  - name: Payment Milestones
  - name: Payments
  - name: Payment Settlements
  - name: Payment Receipts
  - name: Partners
  - name: Contacts
  - name: Locations
  - name: Brand Locations
  - name: Partner Locations
  - name: Documents
  - name: Document Types
  - name: Images
  - name: Notes
  - name: Materials
  - name: Material Variants
  - name: Bom Sections
  - name: Categories
  - name: Collections
  - name: Launch Windows
  - name: Tags
  - name: Colors
  - name: Options
  - name: Option Values
  - name: Dimensions
  - name: Dimension Values
  - name: Dimension Groups
  - name: Dimension Group Dimensions
  - name: Dimension Curves
  - name: Dimension Curve Axes
  - name: Dimension Curve Axis Values
  - name: Dimension Curve Cells
  - name: Checklists
  - name: Packing Templates
  - name: Carton Sizes
  - name: Couriers
  - name: Payment Terms
  - name: Units Of Measure
  - name: Countries
  - name: Custom Field Definitions
paths:
  /brands/{brand}/sample-rounds:
    get:
      tags:
        - Sample Rounds
      summary: List Sample Rounds
      operationId: listSampleRounds
      parameters:
        - name: brand
          in: path
          required: true
          description: Brand slug authorized by this API key.
          schema:
            type: string
            example: acme
        - name: cursor
          in: query
          required: false
          description: >-
            Opaque nextCursor from the same collection and filters. Omit on the
            first request.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: trackingNumber
          in: query
          required: false
          description: Exact, case-sensitive match. Spaces and punctuation are literal.
          schema:
            type: string
            minLength: 1
            maxLength: 255
            description: Exact, case-sensitive match. Spaces and punctuation are literal.
        - name: status
          in: query
          required: false
          description: Exact, case-sensitive match. Spaces and punctuation are literal.
          schema:
            type: string
            minLength: 1
            maxLength: 255
            description: Exact, case-sensitive match. Spaces and punctuation are literal.
        - name: sampleStage
          in: query
          required: false
          description: Exact, case-sensitive match. Spaces and punctuation are literal.
          schema:
            type: string
            minLength: 1
            maxLength: 255
            description: Exact, case-sensitive match. Spaces and punctuation are literal.
        - name: referenceBomId
          in: query
          required: false
          description: Exact related entity ID.
          schema:
            type: string
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            description: Exact related entity ID.
        - name: protoId
          in: query
          required: false
          schema:
            type: string
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      responses:
        '200':
          description: >-
            One page. totalItems counts the full filtered set; nextCursor null
            means exhausted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SampleRoundsList'
          headers:
            Link:
              description: >-
                Origin-relative URL for the next page, with rel="next". Resolve
                against this response URL. Preserves filters and page size;
                omitted when nextCursor is null.
              schema:
                type: string
        '400':
          description: >-
            Invalid parameter, unsupported include, or cursor used with
            different filters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing, invalid, expired, or out-of-scope API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Entity or related subject is not visible in this brand.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Rate limit exceeded. Retry after the indicated delay.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            Retry-After:
              description: Seconds before retrying.
              schema:
                type: integer
                minimum: 0
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    SampleRoundsList:
      type: object
      properties:
        items:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
              protoId:
                type: string
                pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
              status:
                type: string
              trackingNumber:
                type:
                  - string
                  - 'null'
              comment:
                type:
                  - string
                  - 'null'
              sampleStage:
                type:
                  - string
                  - 'null'
              sampleMeasurements:
                anyOf:
                  - c8951fa4-afbb-4015-a2e9-be76da18f616
                  - type: 'null'
              annotations:
                anyOf:
                  - b87a0c83-bda4-4893-b2ad-0d286a0e05c8
                  - type: 'null'
              colors:
                anyOf:
                  - b3907d97-b1cb-4675-ade5-e33defa02366
                  - type: 'null'
              sizes:
                anyOf:
                  - 5d7629cd-a6f0-47ef-be58-b338082c5562
                  - type: 'null'
              quantities:
                anyOf:
                  - 4584c567-949e-456f-8a40-b06467bf0b78
                  - type: 'null'
              referenceBomId:
                anyOf:
                  - type: string
                    pattern: >-
                      ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
                  - type: 'null'
              dueDate:
                type:
                  - string
                  - 'null'
              eta:
                type:
                  - string
                  - 'null'
              shipToAddress:
                type:
                  - string
                  - 'null'
              roundNotes:
                type:
                  - string
                  - 'null'
              responsibleUserId:
                anyOf:
                  - type: string
                    pattern: >-
                      ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
                  - type: 'null'
              supplierRatings:
                anyOf:
                  - 67440fc3-86de-4200-ab7a-a72e16dddd37
                  - type: 'null'
              supplierRatingNotes:
                type:
                  - string
                  - 'null'
              specChangeRequests:
                anyOf:
                  - 1b83f21f-8e0b-4ae6-826f-329bf8ae99ce
                  - type: 'null'
              materializedSpecs:
                anyOf:
                  - 8c9fa1c2-78fa-4692-845c-f4c991701f9f
                  - type: 'null'
              checklist:
                anyOf:
                  - 8a30ce39-add5-4dd3-9561-c9d96023b44c
                  - type: 'null'
              createdAt:
                type:
                  - string
                  - 'null'
              updatedAt:
                type:
                  - string
                  - 'null'
            required:
              - id
              - protoId
              - status
              - trackingNumber
              - comment
              - sampleStage
              - sampleMeasurements
              - annotations
              - colors
              - sizes
              - quantities
              - referenceBomId
              - dueDate
              - eta
              - shipToAddress
              - roundNotes
              - responsibleUserId
              - supplierRatings
              - supplierRatingNotes
              - specChangeRequests
              - materializedSpecs
              - checklist
              - createdAt
              - updatedAt
            additionalProperties: false
        nextCursor:
          type:
            - string
            - 'null'
        totalItems:
          type: integer
          minimum: 0
          maximum: 9007199254740991
      required:
        - items
        - nextCursor
        - totalItems
      additionalProperties: false
      $defs:
        __schema0:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema0'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema0'
        __schema1:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema1'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema1'
        __schema2:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema2'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema2'
        __schema3:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema3'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema3'
        __schema4:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema4'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema4'
        __schema5:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema5'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema5'
        __schema6:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema6'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema6'
        __schema7:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema7'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema7'
        __schema8:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema8'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/SampleRoundsList/$defs/__schema8'
    Error:
      type: object
      properties:
        error:
          type: string
        errorCode:
          type: string
        details:
          $ref: e288252a-1a5c-4f61-a45d-43bb0ec01ab5
          description: Parameter validation issues, when available.
      required:
        - error
        - errorCode
      additionalProperties: false
      $defs:
        __schema0:
          anyOf:
            - type: string
            - type: number
            - type: boolean
            - type: 'null'
            - type: array
              items:
                $ref: '#/components/schemas/Error/$defs/__schema0'
            - type: object
              propertyNames:
                type: string
              additionalProperties:
                $ref: '#/components/schemas/Error/$defs/__schema0'
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      description: A brand-scoped or global amb_sk_... API key.

````