How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Samsara Documents API

The Documents API from Samsara — 5 operation(s) for documents.

Samsara Documents API is one of 90 APIs that Samsara publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Documents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a GitHub repository.

This API exposes 7 operations across 5 paths, and defines 90 schemas. It is described by OpenAPI 3.0.1, at version 2024-11-18.

Requests are made against 2 base URLs: https://api.samsara.com/, https://api.eu.samsara.com/.

7 operations 5 paths 90 schemas 1 DELETE4 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2024-11-18
Base URL
https://api.samsara.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Samsara Documents API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessTokenHeader). By default, every request must be authenticated.

Paths & Operations 7

Across 5 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Documents 7
GET
/fleet/document-types
Fetch Document Types
getDocumentTypes 1 param → 200401404405429500501502
GET
/fleet/documents
Fetch All Documents
getDocuments 5 params → 200401404405429500501502
POST
/fleet/documents
Create Document
postDocument body → 200401404405429500501502
POST
/fleet/documents/pdfs
Create a Document PDF
generateDocumentPdf body → 200default
GET
/fleet/documents/pdfs/{id}
Query a Document PDF
getDocumentPdf 1 param → 200default
DELETE
/fleet/documents/{id}
Delete Document
deleteDocument 1 param → 204401404405429500501502
GET
/fleet/documents/{id}
Fetch Document
getDocument 1 param → 200401404405429500501502

Schemas 90

The contract defines 90 schemas that model the data the API accepts and returns. The most detailed are documentResponseObjectResponseBody (13 properties), DocumentsPostDocumentRequestBody (8 properties), fieldObjectValueResponseBody (8 properties), fieldObjectValueRequestBody (8 properties). Each schema is shown below with its type and property counts.

DocumentsDeleteDocumentServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
multipleChoiceFieldTypeMetaDataObjectResponseBody
object
1 property
DocumentsGetDocumentsNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
DocumentTypesGetDocumentTypesBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
standardErrorResponse
object
Error response
2 properties
scannedDocumentValueObjectRequestBody
object
2 properties
scannedDocumentValueObjectResponseBody
object
2 properties
DocumentTypesGetDocumentTypesBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
DocumentPdfGenerationResponse_data
object
2 properties
GoaVehicleTinyResponseResponseBody
object
A minified vehicle object. This object is only returned if the route is assigned to the vehicle.
3 properties
DocumentsDeleteDocumentBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
dateTimeValueObjectRequestBody
object
The value of a date time field. Only present for date time fields.
1 property
DocumentsPostDocumentNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
DocumentsGetDocumentsInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
GoaDriverTinyResponseResponseBody
object
A minified driver object. This object is only returned if the route is assigned to the driver.
3 properties 1 required
DocumentsGetDocumentUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
multipleChoiceValueObjectResponseBody
object
2 properties
DocumentsDeleteDocumentMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
signatureValueObjectRequestBody
object
The value of a signature field. Only present for signature fields.
4 properties
DocumentsGetDocumentBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
DocumentsGetDocumentMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
GoaRouteStopTinyResponseResponseBody
object
A minified route stop object
3 properties
DocumentsGetDocumentsTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
DocumentsDeleteDocumentGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
DocumentsGetDocumentsResponseBody
object
2 properties 2 required
GoaPaginationResponseResponseBody
object
Pagination parameters.
2 properties 2 required
DocumentsDeleteDocumentNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
DocumentPdfGenerationResponse
object
Identifies a PDF generation job.
1 property
DocumentsGetDocumentGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
DocumentsDeleteDocumentInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
documentResponseObjectResponseBody
object
A single document.
13 properties 6 required
dateTimeValueObjectResponseBody
object
The value of a date time field. Only present for date time fields.
1 property
DocumentsGetDocumentResponseBody
object
1 property
DocumentsGetDocumentsBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
GoaRouteTinyResponseResponseBody
object
A minified representation of a single route.
3 properties 1 required
DocumentsGetDocumentNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
DocumentsPostDocumentBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
DocumentsPostDocumentMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
GoaDocumentTypeTinyResponseResponseBody
object
A minified document type object
2 properties
DocumentsGetDocumentNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
DocumentsDeleteDocumentNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
DocumentsPostDocumentBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
DocumentTypesGetDocumentTypesUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
DocumentsPostDocumentRequestBody
object
8 properties 2 required
DocumentPdfQueryResponse_data
object
6 properties
signatureFieldTypeMetaDataObjectResponseBody
object
The signature field metadata.
1 property
DocumentsPostDocumentInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
DocumentsPostDocumentUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
barcodeValueObjectRequestBody
object
2 properties
fieldObjectValueRequestBody
object
The value of the document field. The shape of value depends on the type.
8 properties
DocumentsPostDocumentServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
DocumentsPostDocumentTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
DocumentsGetDocumentsNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
DocumentsPostDocumentNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
multipleChoiceValueObjectRequestBody
object
2 properties
DocumentTypesGetDocumentTypesResponseBody
object
2 properties 2 required
DocumentsGetDocumentsGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
fieldObjectValueResponseBody
object
The value of the document field. The shape of value depends on the type.
8 properties
DocumentPdfQueryResponse
object
A PDF of a document
1 property
DocumentTypesGetDocumentTypesNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
photoValueObjectResponseBody
object
2 properties
DocumentsPostDocumentResponseBody
object
1 property
DocumentTypesGetDocumentTypesGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
DocumentsGetDocumentsBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
DocumentTypesGetDocumentTypesServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
DocumentsPostDocumentGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
numberFieldTypeMetaDataObjectResponseBody
object
The number field metadata.
1 property
DocumentTypesGetDocumentTypesInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
DocumentsDeleteDocumentBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
DocumentsGetDocumentsMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
DocumentTypesGetDocumentTypesMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
DocumentsGetDocumentBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
barcodeValueObjectResponseBody
object
2 properties
DocumentsGetDocumentsServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
fieldObjectPostRequestBody
object
3 properties 2 required
DocumentTypesGetDocumentTypesTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
fieldObjectResponseBody
object
3 properties 3 required
DocumentsGetDocumentsUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
DocumentsGetDocumentInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
signatureValueObjectResponseBody
object
The value of a signature field. Only present for signature fields.
4 properties
getDocumentTypeResponseObjectResponseBody
object
5 properties
DocumentsGetDocumentTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
DocumentsDeleteDocumentUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
fieldTypesObjectResponseBody
object
6 properties 3 required
DocumentTypesGetDocumentTypesNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
DocumentsDeleteDocumentTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
DocumentPdfGenerationRequest
object
Identifies a document for PDF generation.
1 property 1 required
photoValueObjectRequestBody
object
2 properties
conditionalFieldSectionObjectResponseBody
object
4 properties
DocumentsGetDocumentServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samsara-documents-api-openapi.yml Raw ↑

Other APIs Samsara publishes across the network.

Samsara Activity API
Samsara Addresses API
Samsara Aemp API
Samsara Applications API
Samsara Assets API
Samsara Assignments API
Samsara Attributes API
Samsara Audit API
Samsara Beta A P Is API
Samsara Camera API
Samsara Cameras API
Samsara Cargo API
Where this information came from

This is an independent, third-party profile of Samsara Documents API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.