Download the signed document

GET

/participant/{participantId}/signedDocument

curl --request GET \
  --url https://api-sandbox.trustink.io/participant/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/signedDocument \
  --header 'Authorization: Bearer <token>'

• Sandbox
• Production

A redirect to a presigned link of the signed PDF (15 minutes), or the link as JSON for Accept: application/json, which suits a page that cannot follow a redirect with its Authorization header.

Authorizations

• participantToken

Parameters

Path Parameters

participantId

required

The participant id: the path of the signing link, or participants[].id of the case.

string format: uuid

Header Parameters

Trustink-Otp-Session

The otpSession of POST .../otp/verify. Needed for a case with multiFactorType: the document links, the signature and the signed document.

string

Trustink-Pin

Deprecated: the case PIN, for a case created with pin and without multiFactorType.

string

Responses

200

The link, for Accept: application/json.

Media typeapplication/json

object

url

required

string

Example^generated

{
  "url": "example"
}

302

Redirect to the signed PDF, downloaded as <title>-signed.pdf.

Headers

Location

string

The presigned link.

401

The case has a multiFactorType and the request has no valid Trustink-Otp-Session, or the signing link is not valid. code: OTP_REQUIRED.

Media typeapplication/json

object

code

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}

404

No such participant or case.

Media typetext/plain

string

Example

Case not found

409

The case is not DONE yet; status says where it is. code: NOT_COMPLETED.

Media typeapplication/json

object

code

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}

410

Nobody can sign the case any more (status says why), or a DONE case’s link has passed validUntil; senderName names who sent the request when the tenant gave a sender name. code: CASE_NOT_ACTIVE, LINK_EXPIRED.

Media typeapplication/json

object

code

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}

default

Something failed on the platform, or the request timed out (code TIMEOUT, 503); try again.

Media typeapplication/json

object

code

string

message

required

string

Example^generated

{
  "code": "example",
  "message": "example"
}