---
title: "Fetch document"
method: GET
path: "/fleet/documents/{id}"
tags: ["Documents"]
---

# Fetch document

`GET /fleet/documents/{id}`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/fleet/documents/{id}`
- Auth: HTTP bearer

Returns a single document. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getDriverDocumentByIdAndDriverId).

 <b>Rate limit:</b> 25 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select **Read Documents** under the Driver Workflow category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

## Path parameters

- `id` string, required

## Response `200`

OK response.

- DocumentsGetDocumentResponseBody
  - `data` DocumentResponseObjectResponseBody: A single document.
    - `conditionalFieldSections` ConditionalFieldSectionObjectResponseBody[]: List of the document conditional field sections.
      - `conditionalFieldFirstIndex` integer: The index of the first conditional field associated with the triggeringFieldValue in the fieldTypes list.
      - `conditionalFieldLastIndex` integer: The index of the last conditional field associated with the triggeringFieldValue in the fieldTypes list.
      - `triggeringFieldIndex` integer: The index of the multiple choice field in the fieldTypes list that triggers one or more conditional fields.
      - `triggeringFieldValue` string: The multiple choice option value that triggers the conditional fields.
    - `createdAtTime` string, date-time, required: Time the document was created in RFC 3339 format.
    - `documentType` GoaDocumentTypeTinyResponseResponseBody, required: A minified document type object
      - `id` string: ID of the document type.
      - `name` string: Name of the document type.
    - `driver` GoaDriverTinyResponseResponseBody, required: A minified driver object. This object is only returned if the route is assigned to the driver.
      - `externalIds` object: A map of external ids
      - `id` string, required: ID of the driver
      - `name` string: Name of the driver
    - `fields` FieldObjectResponseBody[], required: The fields associated with this document.
      - `label` string, required: The name of the field.
      - `type` 'photo' | 'string' | 'number' | 'multipleChoice' | 'signature' | 'dateTime' | 'scannedDocument' | 'barcode', required: The type of field. Valid values: `photo`, `string`, `number`, `multipleChoice`, `signature`, `dateTime`, `scannedDocument`, `barcode`
      - `value` FieldObjectValueResponseBody, required: The value of the document field. The shape of value depends on the type.
        - `barcodeValue` BarcodeValueObjectResponseBody[]: The value of a barcode scanning field. Only present for barcode scanning fields.
          - `barcodeType` string: The barcode type that was scanned.
          - `barcodeValue` string: The captured barcode value.
        - `dateTimeValue` DateTimeValueObjectResponseBody: The value of a date time field. Only present for date time fields.
          - `dateTime` string, date-time: Date time value inin RFC 3339 format.
        - `multipleChoiceValue` MultipleChoiceValueObjectResponseBody[]: The value of a multiple choice field. Only present for multiple choice fields.
          - `selected` boolean: Boolean representing if the choice has been selected.
          - `value` string: Description of the choice.
        - `numberValue` number, double: The value of a number field. Only present for number fields.
        - `photoValue` PhotoValueObjectResponseBody[]: The value of a photo field. Only present for photo fields.
          - `id` string: Id of the photo.
          - `url` string: Url of the photo.
        - `scannedDocumentValue` ScannedDocumentValueObjectResponseBody[]: The value of a scanned document field. Only present for scanned document fields.
          - `id` string: Id of the scanned document.
          - `url` string: Url of the scanned document.
        - `signatureValue` SignatureValueObjectResponseBody: The value of a signature field. Only present for signature fields.
          - `id` string: Id of the signature field.
          - `name` string: Name of the signee for a signature field.
          - `signedAtTime` string, date-time: Time the signature was captured in RFC 3339 format.
          - `url` string: Url of a signature field's PNG signature image.
        - `stringValue` string: The value of a string field. Only present for string fields.
    - `id` string, required: Universally unique identifier for the document.
    - `name` string: Name of the document.
    - `notes` string: Notes on the document.
    - `route` GoaRouteTinyResponseResponseBody: A minified representation of a single route.
      - `externalIds` object: A map of external ids
      - `id` string, required: Unique identifier for the route.
      - `name` string: Name of the route.
    - `routeStop` GoaRouteStopTinyResponseResponseBody: A minified route stop object
      - `externalIds` object: A map of external ids
      - `id` string: Id of the route stop
      - `name` string: Name of the route stop
    - `state` 'submitted' | 'required' | 'archived', required: The condition of the document created for the driver. Can be either Required or Submitted. Required documents are pre-populated documents for the Driver to fill out in the Driver App and have not yet been submitted. Submitted documents have been submitted by the driver in the Driver App. Archived documents have been archived by the admin in the cloud dashboard. Valid values: `submitted`, `required`, `archived`
    - `updatedAtTime` string, date-time: Time the document was updated in RFC 3339 format.
    - `vehicle` GoaVehicleTinyResponseResponseBody: A minified vehicle object. This object is only returned if the route is assigned to the vehicle.
      - `externalIds` object: A map of external ids
      - `id` string: ID of the vehicle
      - `name` string: Name of the vehicle

## Other responses

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)