---
title: "Signatory data model"
url: "https://docs.unified.to/signing/signatory/model"
description: "API reference for Signatory data model. Launch multiple pre-built Signatory integrations today with zero maintenance — all through a single API."
generated_at: "2026-05-29T17:54:14.397Z"
---
# Signatory data model

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/signing/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

Unique identifier for this signatory

**created\_at**date 

The date that this signatory was created (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

The last date that this signatory was updated (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**document\_id**string 

Parent signing document; points to SigningDocument

**name**string 

Full name of the signatory

**email**string 

Email address of the signatory

**role** enum

Valid values:

 "SIGNER" 

 "CC" 

 "APPROVER" 

 "IN\_PERSON\_SIGNER" 

 "VIEWER" 

Role of the signatory

**status** enum

Valid values:

 "PENDING" 

 "SENT" 

 "DELIVERED" 

 "SIGNED" 

 "DECLINED" 

Current status of this signatory

**order**number 

Signing order (1, 2, 3...)

**signed\_at**date 

When this signatory signed (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**decline\_reason**string 

Reason for declining (if status is DECLINED)

**raw**any 

The raw data returned by the integration