NotaryLive API - Order IDs

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