The Notarize Business API allows you to seamlessly send your signers documents for notarization and retrieve completed documents for use in your downstream business processes.
The API, organized around REST, is designed to have predictable, resource-oriented URLs, and uses HTTP response codes to indicate any API errors. Webhooks are available to enable you to be notified when a transaction changes state.
To get started, please contact our sales team to get a Notarize Business account here.
Once you create a Notarize account, you will be able to generate your API key right from within your account.
To generate your API key, log into your Notarize Business account and navigate to Resources >> API Keys
These parameters allow you to customize your transaction for internal necessities as well as for the signer experience. You can set things like
message_to_signer, etc. A full list of parameters can be found in the Create Transaction endpoint.
Once you have decided what your transaction parameters will be, make a POST request to the Create Transaction endpoint. You can optionally include your documents in this request and create the transaction instantly, or you can mark the transaction as a draft and add documents later.
If you marked the transaction as a draft, you must follow step 4 to add documents to the transaction.
If you marked the transaction as a draft in step 3, call the Add Document endpoint to add the documents to be signed. You can specify the signing requirement (i.e. Notarization, eSign, etc.) in this API call (read more about document requirements here). All document attributes are also supported in the Update Documents endpoint.
pdf_bookmarked attribute to
If you are passing a
pdf_bookmarked document, it will take the Notarize system time to split the document. We will respond with a
200 and a response indicating that document upload is in progress. Should you wish to set your document parameters on a
pdf_bookmarked document, you must first wait for this upload to complete (~5min), recall the document object on the transaction, and use the document
id returned to update the documents flags.
You can leverage Notarize webhooks to monitor the state of the transaction. There are several events fired - for example you will be able to see when your signer has
received and opened their transaction email as well as when they have
completed their signing.
If you have further questions about the Business API, you can find full technical specifications at the API Endpoint Reference.
Updated 2 months ago