logologo
Docs
API
Reference
Live API
About
Blog
Docs
Reference
Live API
About
Blog
logologo
Introduction

Transactions

Create Transaction
Start a transaction
Get a transaction by ID
Delete / Cancel a Transaction

Files

Download receipt for a transaction
Download a file from a transaction
Upload PDF file or file metadata

Models

CreateTransactionRequest
Transaction
CreateSignerRequest
Signer
CreateReceiverRequest
Receiver
SignerAuthentication
SignerVerification
SignerScribbleVerification
SignerEmailVerification
SignerPhoneNumberIdentification
SignerDigidIdentification
SignerIDealVerification
SignerSurfnetVerification
SignerIDINVerification
SignerIPAddressVerification
SignerEHerkenningVerification
SignerEidasLoginVerification
SignerItsmeIdentificationVerification
SignerConsentVerification
SignerSigningCertificateVerification
SignerCscVerification
SignerOidcIdentification
SignerOnfidoIdentification
FileEntry
Link
Activity
FileMetadata
FileSignerData
FileField
FileFieldType
FileFieldLocation
TransactionDeleteOptions
ErrorResponse

#Entrust Signhost REST API

A comprehensive REST API for creating, managing, and processing digital document signing transactions. This API enables developers to integrate secure electronic signature workflows into their applications, supporting multiple authentication methods, verification types, and document management features.

Key Features

  • Create and configure signing transactions with multiple signers and receivers
  • Support for various authentication methods (DigiD, SMS, eIDAS, itsme, etc.)
  • Multiple verification options including digital certificates and biometric verification
  • File upload and download with metadata support
  • Real-time transaction status tracking and webhook notifications
  • Multi-language support for international use cases
  • Comprehensive audit trails and receipt generation

Important Notes

  • All input strings should be UTF-8 encoded
  • Optional JSON properties should be omitted when not used
  • Do not provide null values
  • Do not perform active polling for transactions status updates. Use the postback service instead. For detailed integration guides and examples, visit the Signhost Developer Documentation.

#Contact

NameEmailURL
Signhost Supportsupport@signhost.comhttps://intercom.help/signhost/en/

#Servers

URL
https://api.signhost.com

#Authentication

HTTP Header NameDescription
AuthorizationThe User Token. Header value must be prefixed with APIKey.
ApplicationThe Application Key. Header value must be prefixed with APPKey.

#API Operations

OperationMethodPathDescription
createTransactionPOST/api/transactionCreate Transaction
startTransactionPUT/api/transaction/{transactionId}/startStart a transaction
getTransactionGET/api/transaction/{transactionId}Get a transaction by ID
deleteTransactionDELETE/api/transaction/{transactionId}Delete / Cancel a Transaction
getReceiptGET/api/file/receipt/{transactionId}Download receipt for a transaction
downloadFileGET/api/transaction/{transactionId}/file/{fileId}Download a file from a transaction
uploadFilePUT/api/transaction/{transactionId}/file/{fileId}Upload PDF file or file metadata

#API Models

ModelDescription
CreateTransactionRequestTransaction creation data including signers, receivers, files, and configuration. This is the request body for creating a new transaction.
TransactionComplete transaction data returned when retrieving or creating a transaction. Includes all configuration, current status, and file information.
CreateSignerRequestRequest object for creating a new signer in a transaction. Defines the signer's identity, authentication/verification requirements, notification preferences, and signing behavior. Key Requirements: - Email address is mandatory - Either Authentications or Verifications must be provided (or both) - Signers with AllowDelegation enabled cannot have Authentications - SendSignRequest determines if sign request emails are sent automatically
SignerSigner information with current status (based on SignerGetDto which extends SignerBaseDto)
CreateReceiverRequestReceiver configuration for getting copies of signed documents
ReceiverReceiver information (based on ReceiverGetDto which extends ReceiverBaseDto)
SignerAuthenticationAuthentication methods used to verify signer identity before document access. These methods must be completed before the signer can view documents. Important: The "Type" property is case-sensitive and must be capitalized.
SignerVerificationVerification methods used to confirm signer identity before document signing. These methods must be completed before the signer can sign documents. Important: The "Type" property is case-sensitive and must be capitalized. Critical Requirement: You must use one of the following verification methods as the last verification in your verifications list: - Consent - PhoneNumber - Scribble - SigningCertificate* - CSC Qualified* Special Rules for SigningCertificate and CSC Qualified: - These two methods must always be the absolute final verification - nothing can come after them - SigningCertificate and CSC Qualified cannot be used together in the same signer's verification list - If you use SigningCertificate or CSC Qualified, it must be the only item in the verifications array OR the last item after other verifications Rules for Consent, PhoneNumber, and Scribble: - These three can be used as the final verification method - They can be preceded by other verification methods (e.g., iDIN, Digid, etc.) - They are commonly used when you want additional verification steps before the final consent/signature Common Mistakes: - Using only authentication methods (e.g., iDIN) without a final verification method - Placing verifications after SigningCertificate or CSC Qualified - Using both SigningCertificate and CSC Qualified together Valid Examples: - [Consent] ✓ - [iDIN, Consent] ✓ - [iDIN, PhoneNumber] ✓ - [SigningCertificate] ✓ - [iDIN, SigningCertificate] ✓ - [SigningCertificate, Consent] ✗ (Nothing can come after SigningCertificate) - [SigningCertificate, CSC Qualified] ✗ (Cannot use both together) - [iDIN] ✗ (Missing required final verification)
SignerScribbleVerificationHandwritten signature verification
SignerEmailVerificationEmail address verification
SignerPhoneNumberIdentificationSMS phone number verification
SignerDigidIdentificationDutch DigiD verification
SignerIDealVerificationiDEAL bank verification
SignerSurfnetVerificationSURFnet academic verification
SignerIDINVerificationiDIN bank identification verification
SignerIPAddressVerificationIP address verification
SignerEHerkenningVerificationeHerkenning business identity verification
SignerEidasLoginVerificationeIDAS electronic identification verification
SignerItsmeIdentificationVerificationitsme identification verification
SignerConsentVerificationConsent-based verification
SignerSigningCertificateVerificationDigital signing certificate verification
SignerCscVerificationCloud Signature Consortium (CSC) verification
SignerOidcIdentificationOpenID Connect identification
SignerOnfidoIdentificationOnfido identity verification
FileEntryFile information and metadata associated with a transaction. Contains details about uploaded documents including display properties, download links, and current processing status. Files are referenced by their unique identifier within the transaction and can include PDFs, receipts, and other document types.
LinkURI link with relationship and type information
ActivityActivity/event information for a signer (based on ActivityGetDto)
FileMetadataComprehensive metadata information for a file in a transaction. This metadata defines how the file should be displayed, processed, and what form fields and signing areas it contains. The metadata can be uploaded before or after the actual PDF file.
FileSignerDataConfiguration data specific to a signer for a particular file. This determines which form sets the signer needs to complete when signing the document.
FileFieldRepresents an individual form field or signing area within a document. Fields define where and how users interact with the document during the signing process.
FileFieldTypeSpecifies the type of interaction or data entry required for this field. Different types have different behaviors and validation rules in the signing interface.
FileFieldLocationDefines the precise positioning and sizing of a field within the PDF document. Fields can be positioned using absolute coordinates or by searching for specific text anchors within the document.
TransactionDeleteOptionsOptions for cancelling a transaction
ErrorResponseError response object containing error details