Skip to main content
GET
Get Signature
Retrieve signature information or download the signature file.

Path Parameters

string
required
Signature UUID

Headers

string
Response format:
  • application/json - Get signature metadata (default)
  • application/octet-stream - Download signature file

Response Structure (JSON)

When Accept: application/json is used:

Response Fields (JSON)

string
Signature UUID
string
Creation timestamp
string
Last update timestamp
string
Signature name
string
Signature identifier key
string
Signature status (e.g., “pending”, “completed”, “declined”)
number
Number of items/pages to be signed
string
Signature method (e.g., “electronic”, “qualified”)
boolean
Whether to merge signatures into a single document
number
Signature cost (if applicable)
string
Language/locale code

Response (Binary)

When Accept: application/octet-stream is used, returns the signature file (typically PDF format).

Response Codes

Signatures are typically generated when a form response includes signature fields. The signature file contains the legally binding signed documents.

Authorizations

Authorization
string
header
required

API token (starts with pnbx_). Create at https://app.penbox.io/workspace/settings/api. Include as: Authorization: Bearer {token}

Headers

Accept
enum<string>
default:application/json

Response format: application/json for metadata or application/octet-stream for file download

Available options:
application/json,
application/octet-stream

Path Parameters

id
string<uuid>
required

Signature UUID

Response

Successful response

id
string<uuid>
required

Signature UUID

name
string
required

Signature name

status
string
required

Signature status (e.g., pending, completed, declined)

created_at
string<date-time>

Creation timestamp

updated_at
string<date-time>

Last update timestamp

key
string

Signature identifier key

items
integer

Number of items/pages to be signed

method
string

Signature method (e.g., electronic, qualified)

merge
boolean

Whether to merge signatures into a single document

cost
number | null

Signature cost (if applicable)

locale
string

Language/locale code