v1

latestOpenAPI 3.0.02026-07-22243670.8 KB
DocumentSubmissions

Create a document signing submission for the authenticated partner and user

Creates a signing submission for the given document type (e.g. a W-8BEN tax certification) for the current entity. The signing link is emailed to the user. Re-posting acts as a resend/re-sign where the document state allows it. The submitted PII pre-fills the form and is forwarded to Passport, never persisted by Frontline.

post/v1/documents/{document_type}/submission

Path parameters

document_typestring required

The type of document to submit for signing. Valid values: tax_certification

Request body

object required

Example request

{
  "City": "Warsaw",
  "Country": "PL",
  "Country Of Citizenship": "Poland",
  "DOB": "01/15/1985",
  "Date": "06/16/2026",
  "Foreign Tax Number": "123-45-6789",
  "Full Name": "Aleksander Nowak",
  "Permanent Address": "ul. Nowy Świat 12",
  "Signature": "Aleksander Nowak"
}

Response

Successful response.

form_type'w8_ben' | 'w8_ben_e' required

The tax form derived from the entity kind

object'document_submission' required

String representing the object's type. Objects of the same type share the same value.

status'INITIALIZED' | 'SENT' | 'VIEWED' | 'COMPLETED' | 'DECLINED' | 'EXPIRED' required

The status of the document signing submission

Example response

{
  "form_type": "w8_ben",
  "status": "SENT"
}
All 24 operations