Skip to main content

Retrieve eSignature transaction details by ID

This endpoint retrieves a specific eSignature transaction by its ID. Authorization (HTTP bearer token) is required.

Path Parameters
id string REQUIRED

The unique identifier of the eSignature transaction.

Responses
200

eSignature transaction details successfully retrieved.

Schema OPTIONAL
id uuid

The unique identifier of the transaction.

status string

The current status of the transaction.

taggingOrganizationId string OPTIONAL

The ID of the organization assigned to tag this document.

documents object[]

List of documents in the transaction.

id string OPTIONAL

id of the document from response from POST /document/upload

title string

document title

description string OPTIONAL

document description

xfdf string OPTIONAL

document xfdf string

StoragePath string

StoragePath of document from response POST /document/upload

order number OPTIONAL

order the document is shown to participant

pages number OPTIONAL

number of pages in the document

readOnly boolean OPTIONAL

will this document be read only

visible boolean OPTIONAL

will this document be visible to the participants

tags object[]

List of tags to convert to xfdf

type string

Possible values: [DATETEMPLATE, FULLNAMETEMPLATE, DOCUMENTIDTEMPLATE, NOTARYSESSIONIDTEMPLATE, COMMISSIONIDTEMPLATE, COMMISSIONEXPIRATIONTEMPLATE, DISCLAIMERTEMPLATE, COMMISSIONSTAMPTEMPLATE, SEALTAGTEMPLATEANNOTATION, NOTARYTITLETEMPLATE, NOTARYCOUNTYTEMPLATE, NOTARYSTATETEMPLATE, SIGNATURETEMPLATE, SIGNHERETAGTEMPLATEANNOTATION, INITIALSTEMPLATE, INITIALHERETAGTEMPLATEANNOTATION, FREEFORMTEXTTAGTEMPLATEANNOTATION, TEXTANNOT]

x number

bottom-left x-coordinate of the tag annotation

y number

bottom-left y-coordinate of the tag annotation

width number

width of the tag annotation

height number

height of the tag annotation

signerId string

id of the signer this tag is assigned to

customData object
page number

page number of the tag annotation

required boolean OPTIONAL

tag is required to be applied

stateFormat string OPTIONAL

tag is required to be applied

dateFormat string OPTIONAL

Possible values: [MM/DD/YYYY, DD/MM/YYYY, MM/DD/YY, DD/MM/YY, MMMM do, yyyy, full, MMMM, do, yyyy, YYYY]

tag is required to be applied

fontSize number OPTIONAL

tag font size

participants object[]

List of participants in the transaction.

id string

id of the signer this tag is assigned to

order number OPTIONAL

order of participant

email string

email of the signer

firstName string

first name of signer

middleName string OPTIONAL

middle name of signer

lastName string

last name of signer

address1 string OPTIONAL

address of signer

address2 string OPTIONAL

address 2 of signer

country string OPTIONAL

country of signer

city string OPTIONAL

address 2 of signer

state string OPTIONAL

state of signer

zip string OPTIONAL

postal code of signer

phone string OPTIONAL

phone number of signer

kbaRequired boolean OPTIONAL

is KBA required for this signer

credAnalysisRequired boolean OPTIONAL

is credential-analysis required for this signer

externalId string OPTIONAL

consumer-provided external id

authenticationType string

Possible values: [personal-password, two-factor-authentication, none]

twoFactorContact string

Possible values: [sms, email]

personalPasswordQuestion string OPTIONAL
personalPassword string OPTIONAL
inviteEmailSubject string OPTIONAL
emailSubject string OPTIONAL

Custom email subject line used for signer notification emails. Present only if a custom subject was set at envelope creation.