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

# List chips

> Returns a cursor-paginated list of chips in your organization, each with a reference to the unit it is paired to. Use `is_test` to filter to test or encoded chips.



## OpenAPI

````yaml /openapi.json get /v1/chips
openapi: 3.1.0
info:
  title: Endstate API
  version: v1
  description: Endstate developer API for chip verification and ownership workflows.
servers:
  - url: https://api2.endstate.io
    description: Production
security: []
paths:
  /v1/chips:
    get:
      tags:
        - Chips
      summary: List chips
      description: >-
        Returns a cursor-paginated list of chips in your organization, each with
        a reference to the unit it is paired to. Use `is_test` to filter to test
        or encoded chips.
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
            description: Maximum number of records to return. Defaults to 50; maximum 100.
          required: false
          name: limit
          in: query
        - schema:
            type: string
            minLength: 1
            description: Opaque cursor from the previous page.
          required: false
          name: cursor
          in: query
        - schema:
            type: string
            enum:
              - 'true'
              - 'false'
            description: >-
              Filter by test-chip flag. Omit to return both test and encoded
              chips.
          required: false
          name: is_test
          in: query
      responses:
        '200':
          description: A page of chips.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListChipsResponse'
              example:
                chips:
                  - chip_id: ABCDEF0123
                    is_test: true
                    scan_count: 0
                    created_at: '2026-05-16T12:00:00.000Z'
                    unit:
                      id: 22222222-2222-2222-2222-222222222222
                      external_id: unit-001
                pagination:
                  limit: 50
                  has_more: false
                  next_cursor: null
      security:
        - ApiKeyBearer: []
components:
  schemas:
    ListChipsResponse:
      type: object
      properties:
        chips:
          type: array
          items:
            $ref: '#/components/schemas/ChipListItem'
        pagination:
          $ref: '#/components/schemas/CursorPagination'
      required:
        - chips
        - pagination
      example:
        chips:
          - chip_id: ABCDEF0123
            is_test: false
            scan_count: 0
            created_at: '2026-05-16T12:00:00.000Z'
            unit:
              id: 22222222-2222-2222-2222-222222222222
              external_id: unit-001
        pagination:
          limit: 50
          has_more: false
          next_cursor: null
    ChipListItem:
      type: object
      properties:
        chip_id:
          type: string
          pattern: ^[0-9A-F]{10}$
          description: Chip identifier from the tap URL.
          example: ABCDEF0123
        is_test:
          type: boolean
        scan_count:
          type: integer
          minimum: 0
        created_at:
          type: string
          format: date-time
        unit:
          $ref: '#/components/schemas/ChipUnitRef'
      required:
        - chip_id
        - is_test
        - scan_count
        - created_at
        - unit
    CursorPagination:
      type: object
      properties:
        limit:
          type: integer
          exclusiveMinimum: 0
          description: Maximum number of records returned.
          example: 50
        has_more:
          type: boolean
          description: Whether another page is available. Pass `next_cursor` to fetch it.
          example: false
        next_cursor:
          type:
            - string
            - 'null'
          description: Opaque cursor for the next page. Null when there is no next page.
          example: >-
            eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0xNlQxMjowMDowMC4wMDBaIiwiaWQiOiIzMzMzMzMzMy0zMzMzLTMzMzMtMzMzMy0zMzMzMzMzMzMzMzMifQ
      required:
        - limit
        - has_more
        - next_cursor
    ChipUnitRef:
      type:
        - object
        - 'null'
      properties:
        id:
          type: string
          format: uuid
        external_id:
          type:
            - string
            - 'null'
      required:
        - id
        - external_id
      description: >-
        The unit this chip is paired to. Null when the chip is not paired to a
        unit.
  securitySchemes:
    ApiKeyBearer:
      type: http
      scheme: bearer
      bearerFormat: end_sk
      description: >-
        Use `Authorization: Bearer end_sk_*` for partner API keys (e.g.
        `end_sk_AbCd_example_api_key`).

````