---
title: "List pool items"
method: GET
path: "/participant-pools/{participantPoolId}/items"
tags: ["Items"]
---

# List pool items

`GET /participant-pools/{participantPoolId}/items`

Returns a paginated list of items in the participant pool

## Query parameters

- `limit` integer
- `skip` integer
- `status` 'DRAFT' | 'AWAITING_TAGGING' | 'AWAITING_PARTICIPANT_PREFERENCE' | 'REQUEST_SENT_TO_ENROLLEES' | 'MATCHED' | 'STALE' | 'CANCELLED' | 'COMPLETED' — Current status of a participant pool item
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

A directory with a `data` property that contains an array of up to `limit` items, starting after `skip`. Each entry in the array is a separate item object. If no more items are available, the resulting array will be empty. This request should never return an error.

- object
  - `data` ParticipantPoolItem[]
    - `id` string — Unique identifier for the participant pool item
    - `participantPoolId` string, required — ID of the participant pool this item belongs to
    - `status` 'DRAFT' | 'AWAITING_TAGGING' | 'AWAITING_PARTICIPANT_PREFERENCE' | 'REQUEST_SENT_TO_ENROLLEES' | 'MATCHED' | 'STALE' | 'CANCELLED' | 'COMPLETED', required — Current status of a participant pool item
    - `linkedObject` ParticipantPoolItemLinkedObject — Object linked to a participant pool item
      - `objectId` string, required — Identifier of the linked object
      - `kind` 'E_SIGNATURE_PACKAGE', required — Type of object linked to the participant pool item
      - `linkedParticipantId` string — ID of the linked participant in the object (e.g. signer id)
    - `scheduling` ParticipantPoolItemScheduling — Scheduling configuration for a participant pool item
      - `dateType` 'FIXED' | 'DATE_RANGE', required — Type time preference for the participant pool item
      - `schedulingMode` 'PRE_SCHEDULED' | 'ON_DEMAND', required — Matching mechanism for scheduling participants
      - `startDate` string, date-time — Earliest date of availability
      - `endDate` string, date-time — Latest possible date for the item
      - `timezone` string — Timezone for scheduling (e.g. 'America/New_York')
      - `duration` integer — Duration of the meeting in minutes
      - `scheduleSetterParticipantId` string — ID of the participant who sets the schedule
      - `queueForTagging` boolean — Whether the item should be queued for tagging
      - `bid` ParticipantPoolItemSchedulingBid — Bidding configuration for participant pool item scheduling
        - `maxPrice` number — Maximum price willing to pay for the scheduling slot
        - `currency` string — Currency code for the price (e.g., USD, EUR)
      - `counterBids` ParticipantPoolItemSchedulingCounterBid[] — Counter bids for this scheduling item
        - `id` string — Unique identifier for the counter bid
        - `counter` ParticipantPoolItemSchedulingBid, required — Bidding configuration for participant pool item scheduling
          - `maxPrice` number — Maximum price willing to pay for the scheduling slot
          - `currency` string — Currency code for the price (e.g., USD, EUR)
        - `status` 'PENDING' | 'ACCEPTED' | 'REJECTED', required — Status of a counter bid for participant pool item scheduling
        - `publicId` string — Public identifier of the counter bidder
        - `name` string — Name of the counter bidder
        - `email` string — Email of the counter bidder
        - `createdAt` string, date-time — Timestamp when the counter bid was created
        - `updatedAt` string, date-time — Timestamp when the counter bid was last updated
        - `respondedAt` string, date-time — Timestamp when the counter bid was accepted or rejected
    - `ownershipRegistry` ParticipantPoolItemOwnershipRegistryItem[] — Registry of owners for this item
      - `role` 'OWNER' | 'ADMIN' | 'ENROLLEE' | 'ASSIGNER' | 'TAGGER', required — Role of a member within the participant pool
      - `publicId` string, required — Public identifier of the owner
      - `timestamp` string, date-time — When this ownership change occurred
      - `reason` string — Optional reason for the ownership change
    - `assignmentRules` ParticipantPoolItemAssignmentRule[]
      - `ruleId` string
      - `metadata` unknown
  - `hasMore` boolean — Indicates if there are more items to fetch
  - `total` integer — Total number of items matching the filter criteria

---

[API](https://skmtc.net/pactima/apis/esignature-packages-api.md) · [All operations](https://skmtc.net/pactima/apis/esignature-packages-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pactima/esignature-packages-api/revisions/1570128383ef/schema)