---
title: "Retrieve a signer"
method: GET
path: "/e-signature-packages/{eSignaturePackageId}/signers/{id}"
tags: ["Signers"]
---

# Retrieve a signer

`GET /e-signature-packages/{eSignaturePackageId}/signers/{id}`

## Response `200`

Returns the object if a valid identifier is provided, and returns an error otherwise.

- ESignatureSigner
  - `id` string
  - `name` string, required
  - `email` string, required
  - `phoneNumber` string
  - `participantPoolItem` ESignatureSignerParticipantPoolItem — An item in a participant pool representing a specific request or assignment
    - `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
    - `participantPoolName` string
  - `attachmentRequests` ESignatureSignerAttachmentRequest[]
    - `id` string
    - `name` string, required
    - `description` string
    - `isOptional` boolean — Set to true if the request is optional
    - `isConfidential` boolean — Set to true if the attachment should not be shared with other signers; only the owner
  - `specialRoles` ESignatureSignerSpecialRoleEnum[]
  - `viewRestrictions` ESignatureSignerViewRestrictionEnum[]

---

[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)