Attachments

List attachments across inspections

Every additional report and additional document in your organization. Use updated_since to sync only new files.

get/v1/attachments

Request

  • Base URL: https://api.hiveinspect.com
  • URL: https://api.hiveinspect.com/v1/attachments
  • Auth: HTTP bearer

Query parameters

inspection_idstring uuid

Only this inspection's attachments

kindstring

report or document

visible_to_clientboolean

true: only what the client can see. false: only inspector-only documents

updated_sincestring

ISO 8601 date or timestamp; added or changed at/after this time

sortstring

updated_at or created_at; prefix '-' for descending (default: -updated_at)

cursorstring

next_cursor from the previous page

limitinteger

Page size, 1-200 (default 50)

Response

OK

next_cursorstring nullable
totalinteger

Every record matching the filters, across all pages

Example response

{
  "data": [
    {
      "id": "8f7e6d5c-4b3a-4291-8e0f-1a2b3c4d5e6f",
      "inspection_id": "3f2a9c1e-6b4d-4e7a-8c15-9d0e1f2a3b4c",
      "kind": "report",
      "name": "Sewer Scope Report",
      "description": "Video: https://example.com/sewer-scope",
      "filename": null,
      "content_type": "application/pdf",
      "size_bytes": 482133,
      "url": "https://files.example.com/signed-link-valid-for-1-hour",
      "visible_to_client": true,
      "created_at": "2026-09-24T21:03:18Z",
      "updated_at": "2026-09-24T21:03:18Z"
    }
  ],
  "next_cursor": null,
  "total": 1
}

Changes

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