SAsamsara
Beta APIs

[beta] List maintenance estimates

Read estimates by IDs or work orders, including historical decisions. One primary selector is required. Up to 100 estimate IDs, 10 WO IDs and 10 vendor IDs bound query and authorization work. Filters use OR within each set and AND across sets.

<b>Rate limit:</b> 5 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 Work Orders under the Work Orders 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.

get/maintenance/estimates

Request

  • Base URL
    https://api.samsara.com
  • Auth
    HTTP bearer

Query parameters

idsstring[]

Up to 100 comma-separated estimate identifiers.

workOrderIdsstring[]

Up to 10 comma-separated numeric WO IDs. Bounds indexed-query fanout and authorization work.

vendorIdsstring[]

Up to 10 comma-separated vendor-location identifiers; narrows the primary selection. Resolve locations via GET /fleet/maintenance/vendor-locations.

afterstring

Cursor returned by the preceding response; retain the same filters.

includeExternalIdsboolean

Include estimate external identifiers. Defaults to false.

Response

OK response.

Example response

{
  "data": [
    {
      "approvalSource": "none",
      "approvalStatus": "unapproved",
      "attachments": [
        {
          "createdAtTime": "2026-10-07T15:00:00Z",
          "id": "a81e26e6-50cd-4ae2-85b9-132c493c0871",
          "name": "repair-quote.pdf",
          "processingStatus": "finished",
          "updatedAtTime": "2026-10-07T15:00:00Z",
          "url": "https://example.com/file",
          "urlExpiresAt": "2026-10-07T15:00:00Z"
        }
      ],
      "createdAtTime": "2026-10-07T15:00:00Z",
      "estimateType": "vendorQuote",
      "externalIds": {
        "repairSystem": "quote-123"
      },
      "externalRequest": {
        "actionUrl": "https://example.com/requests/AI-563-1",
        "externalRequestId": "AI-563-1",
        "externalSystem": "Auto Integrate",
        "message": "Review quote in Auto Integrate"
      },
      "id": "a81e26e6-50cd-4ae2-85b9-132c493c0871",
      "lineItems": [
        {
          "amount": {
            "amount": "640.2",
            "currency": "usd"
          },
          "costType": "labor",
          "description": "Replace turbocharger",
          "id": "a81e26e6-50cd-4ae2-85b9-132c493c0871",
          "quantity": 2,
          "serviceTaskId": "a81e26e6-50cd-4ae2-85b9-132c493c0871",
          "unitRate": {
            "amount": "95.005",
            "currency": "usd"
          }
        }
      ],
      "notes": "Contact shop before starting work.",
      "quotedAtTime": "2026-10-07T15:00:00Z",
      "subtotal": {
        "amount": "640.2",
        "currency": "usd"
      },
      "supersededByEstimateId": "a81e26e6-50cd-4ae2-85b9-132c493c0871",
      "supersedesEstimateId": "a81e26e6-50cd-4ae2-85b9-132c493c0871",
      "tax": {
        "amount": "640.2",
        "currency": "usd"
      },
      "total": {
        "amount": "640.2",
        "currency": "usd"
      },
      "updatedAtTime": "2026-10-07T15:00:00Z",
      "vendorId": "a81e26e6-50cd-4ae2-85b9-132c493c0871",
      "version": 1,
      "workOrderId": "464"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.