Retrieving Order Video
Once a document has been notarized, a video recording of the session between the notary and the signer(s) will be available for download.
Below is an example of how to download the video:
response=$(curl -X GET "https://notarylive.com/api/v2/order/video" \
-H 'Content-Type: application/json' \
-u 'your_api_id:your_api_key' \
-d $'{"order_id":"your_identifier_here"}' \
--write-out "%{http_code}" \
--silent --output ~/Downloads/video_filename.mp4)
http_code=$(tail -n1 <<< "$response")
if [ "$http_code" -eq 200 ]; then
echo "Download initiated and saved"
else
response=$(cat ~/Downloads/video_filename.mp4)
echo "Failed to download. Server response: $response"
rm ~/Downloads/video_filename.mp4
fi
Please note:
There is some downtime between the end of the session and when the video is made available for download.
Please make use of the video_ready_for_download
webhook event to check the status of the order.
Otherwise, please wait a few minutes after a notarization has been completed to attempt to download the video.
Validation Failures
Invalid credentials will return a 401 response with the message: HTTP/1.0 401 Unauthorized
Invalid or missing payload data will return a 403 HTTP response with a JSON body containing success =
0
as well as an array of errors
containing both a standardized error code, as well as a
human-readable description of what caused the error:
If you continue having issues, please take a look at our troubleshooting guide.
response=$(curl -X GET "https://notarylive.com/api/v2/order/video" \
-H 'Content-Type: application/json' \
-u 'your_api_id:your_api_key' \
-d $'{"order_id":"your_identifier_here"}' \
--write-out "%{http_code}" \
--silent --output ~/Downloads/video_filename.mp4)
http_code=$(tail -n1 <<< "$response")
if [ "$http_code" -eq 200 ]; then
echo "Download initiated and saved"
else
response=$(cat ~/Downloads/video_filename.mp4)
echo "Failed to download. Server response: $response"
rm ~/Downloads/video_filename.mp4
fi
{
"success": 0,
"errors": [
{
"code": "no_identifier_submitted",
"message": "This endpoint requires either a nl_order_id, a order_id or a whitelabel_token parameter to identify the order"
}
]
}
Copyright © 2025, NotaryLive.com