Samsara Developer Portal

Integrate your data with the Samsara API, customize the Samsara experience, and join a community of developers building with Samsara.

Get Started

Document PDFs

Download PDF versions of driver documents

Creating a PDF version of a driver document is an asynchronous process. There are two steps:

  1. Trigger PDF creation job
  2. Check job status and download PDF

Step 1: Trigger PDF creation job

The following triggers the creation of a PDF version of the document with documentId 1654973_1593713510968:

curl --request POST 'https://api.samsara.com/fleet/documents/pdfs' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <<token>>' \
--data-raw '{
    "documentId": "1654973_1593713510968"
}'

The response will contain the id of the PDF job as well as the original documentId:

{
    "data": {
        "id": "4407d645-93a2-4a4d-8702-468cb5f9bf34",
        "documentId": "1654973_1593713510968"
    }
}

Step 2: Check job status and download PDF

Once you've triggered the PDF job, you can check its status and (if completed) download the PDF.

You supply the id of the PDF job from step 1 as a URL parameter to the GET request:

curl --request GET 'https://api.samsara.com/fleet/documents/pdfs/4407d645-93a2-4a4d-8702-468cb5f9bf34' \
--header 'Authorization: Bearer <<token>>'
{
    "data": {
        "id": "4407d645-93a2-4a4d-8702-468cb5f9bf34",
        "documentId": "1654973_1593713510968",
        "jobStatus": "completed",
        "requestedAtTime": "2020-07-02T18:34:06.456Z",
        "completedAtTime": "2020-07-02T18:34:10.176Z",
        "downloadDocumentPdfUrl": "https://samsara-driver-document-pdfs.s3.us-west-2.amazonaws.com/org/53729/4407d645-93a2-4a4d-8702-468cb5f9bf34/Stop_Tasks-Tyler_Freckmann-20200702.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA3LY3RNWSCKZRLY5Q%2F20200702%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Date=20200702T184155Z&X-Amz-Expires=604800&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEMr%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLXdlc3QtMiJHMEUCIQCuA%2B496MTQeVCf7qvb0yrhFzjp44TM2s%2BJof2h80VfLgIgQsfLaurrheam%2BbMnNc4L3%2B5c0x6f3voTaRLetnwieykq2gMIYxACGgw3ODEyMDQ5NDIyNDQiDPGvTuUOUB4obbMMjiq3A1fmsYVG52PI379ctIJeh2AFEVqdzvYQsmeb2y1iAHVJK%2FW0O%2BSDNgc5VqjMFHVVCWAlY4XyncspYZ8YwjQZV3b8VOvmkf6m7YTvIairfu%2BJ1FwgrfjPHpYpJ7p5BBLvBP7j3jFhhP%2FfVMetRof%2Fsge5HpQnaPcp%2FHQ1CvLZ2y7veUIGXQ%2FsZc%2BA09aeBCmkVSkKqmf%2BHXSdzB9H8utlCfV0e86F8k3lJOf%2Bv0YwKv5WzwYt9uepgQ%2FhD30ooLEv2dZoyMrISU8berDEg%2F3suKhJUyUwLmA5v9E7LQp15CMkgFjRgEhtszXBqugDiB71sS7U0TRyxv533VZMEDXT%2BYpPfZmb8dm2FMYcLZtITo57Yyy1%2FQ%2BmTNB8z8RdEqYIGbkUM5FK1tWV0jX%2FeW3%2FXaxGdPOacfjDnnHDcQFgCnMvYUSLiAzIXvPwPghycVKRV7nHyQXG8FE%2FwMSh%2BqEiBeaRQL5s0vM%2B2nschm0jlwprug5xDQGsxD%2F%2B5TxfErgyS6Z%2FuhJlD%2BPJ5syfTtdNAUKiGSs4Sb6z4VNmODrBH%2FLCKUdGl0%2Fvcj9KYyGO8XvXwd6Ky6xk9Lgw2rX49wU67wGqVh0HxxnoKBZTG2zUy%2BmWPWrzXTJDkwQxpOVNzN%2BACHGu%2Bc1uFEsiysEGK9VBImEr4XHoIkc2V9xunlQlu%2BZ04Ve0UeZXIM090%2BW0bcvJ4raQO19P0angUzYlSL%2FXsjBxXfkFIDKS2iCSwAhmQF%2Bs3sCSUJNY1cM7WzA8n5NiN929Dzy56%2Bj%2BC%2FHQaDBJEwh2CnNBiOpAJLWtQcQHlMJnSQAzylG6U1BnTRbGPtfnkZMX9RAHA%2F2Y%2F6vp0U%2FUZI40Ko0rzgkqmVbpiBlj5ejj5QwZTVaVZAqn7pkAsX4m%2BUzE2%2FYhOKSIC6WeCtNwew%3D%3D&X-Amz-SignedHeaders=host&response-expires=2020-07-09T18%3A41%3A55Z&X-Amz-Signature=9d4a39844cbdb46a05631fa9d589da9f58d59903bc1471e4307c519e87ee6031"
    }
}

The response will contain the jobStatus of the PDF job. This can be completed, requested, or processing. If the job is not completed, it is recommended that you wait 5 seconds and try again.

Once the job has been completed, the downloadDocumentPdfUrl will provide a URL to the PDF document that expires after 7 days. If the URL has expired, you may request creation of the PDF again as described in step 1.

Updated 4 months ago


Document PDFs


Download PDF versions of driver documents

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.