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

# List a TAM Preview's members

> One page of a Preview's members as IDs: by default the companies Import would write (entity=company, disposition=eligible). existing narrows eligible to members already in the workspace; excluded lists the rest with their reason. Members are listed once the Preview is READY.



## OpenAPI

````yaml https://api.monaco.com/openapi.json get /v1/tam/preview/{preview_id}/members
openapi: 3.1.0
info:
  title: Monaco Public API
  description: Public API for Monaco
  version: 1.0.0
servers:
  - url: https://api.monaco.com
security: []
paths:
  /v1/tam/preview/{preview_id}/members:
    get:
      tags:
        - TAM
      summary: List a TAM Preview's members
      description: >-
        One page of a Preview's members as IDs: by default the companies Import
        would write (entity=company, disposition=eligible). existing narrows
        eligible to members already in the workspace; excluded lists the rest
        with their reason. Members are listed once the Preview is READY.
      operationId: list_tam_preview_members
      parameters:
        - name: preview_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Preview Id
        - name: entity
          in: query
          required: false
          schema:
            enum:
              - company
              - person
            type: string
            default: company
            title: Entity
        - name: disposition
          in: query
          required: false
          schema:
            enum:
              - eligible
              - excluded
              - existing
            type: string
            default: eligible
            title: Disposition
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
            title: Page
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            default: 500
            title: Page Size
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PublicItemResponse_TamPreviewMembersResponse_
        4XX:
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
components:
  schemas:
    PublicItemResponse_TamPreviewMembersResponse_:
      properties:
        data:
          $ref: '#/components/schemas/TamPreviewMembersResponse'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      type: object
      required:
        - data
      title: PublicItemResponse[TamPreviewMembersResponse]
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: PublicErrorResponse
    TamPreviewMembersResponse:
      properties:
        preview_id:
          type: string
          format: uuid
          title: Preview Id
        entity:
          type: string
          enum:
            - company
            - person
          title: Entity
        disposition:
          type: string
          enum:
            - eligible
            - excluded
            - existing
          title: Disposition
        page:
          type: integer
          minimum: 1
          title: Page
        page_size:
          type: integer
          minimum: 1
          title: Page Size
        total:
          type: integer
          minimum: 0
          title: Total
        items:
          items:
            $ref: '#/components/schemas/TamPreviewMemberRecord'
          type: array
          title: Items
      type: object
      required:
        - preview_id
        - entity
        - disposition
        - page
        - page_size
        - total
        - items
      title: TamPreviewMembersResponse
    ResponseMeta:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: Server timestamp of the response
      type: object
      title: ResponseMeta
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - not_found
        message:
          type: string
          title: Message
          description: Human-readable error message
          examples:
            - Resource not found
      type: object
      required:
        - code
        - message
      title: ErrorDetail
    TamPreviewMemberRecord:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: 'member_id: pass it to exclude_tam_preview_members.'
        source_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Id
        company_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Company Id
          description: The company source_id of a person.
        disposition:
          type: string
          enum:
            - eligible
            - excluded
          title: Disposition
        existing:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Existing
          description: Already in the workspace.
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
          description: Why an excluded member is excluded.
        qualification:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Qualification
        data:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Data
          description: >-
            Retained display fields, excluding top-level email fields and raw
            source records.
      type: object
      required:
        - id
        - source_id
        - disposition
      title: TamPreviewMemberRecord

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.