In addition to the use of seals in a transaction, we offer a standalone seal service.
Before you can request a document to be sealed, make sure the feature is activated on your account and that the seal has already been added to your account.
Note that when you use the standalone seal service, sealed documents are not stored. Documents are only stored when you seal a document within the transaction process.
To request a seal, send a multipart/form-data request to POST /v1/seals and pass the document in the file argument as well as the seal id.
Note that we accept only PDF input format in a maximum size limit of 25MB.
curl
https://api.universign.com/v1/seals \
-F file=@MyDocument.pdf \
-d seal_id=scd_wa7ZVZGxz0q1
You can pass optional parameters:
field_page: The page number on which you want to position the seal. Default value is1.field_x: The seal horizontal coordinate on the document page (in pixels). Default value is0.field_y: The seal vertical coordinate on the document page (in pixels). Default value is0.language: The language of the text in the seal cartridge (“Sealed by [sealname], on [sealdate]”). Expected input format is ISO 639-1. We currently support 11 languages: Bulgarian (bg), Catalan (ca), Dutch (nl), English (en), French (fr), German (de), Italian (it), Polish (pl), Portuguese (pt), Romanian (ro) and Spanish (es). French (fr) is the default language.custom_logo: The seal logo that will display on the document. We accept only JPEG and PNG formats in a maximum size limit of 2 MB.
If you set only required parameters or if you do not set field_page, field_x and field_y parameters, the request returns a 200 response that contains a PAdES document seal with an invisible seal.
