List documents

The documents of a trip that the caller may see: all of them for the trip owner, otherwise the caller's own and the shared ones. Newest first. can is what the caller may do with each; size_bytes is null when the stored file cannot be measured.

get/api/v1/trips/{tripExternalId}/documents

Request

Base URL: https://www.endlesstravelplans.com
URL: https://www.endlesstravelplans.com/api/v1/trips/{tripExternalId}/documents
Auth: HTTP bearer

Response

Example response

{
  "documents": [
    {
      "external_id": "3f1c2b7a-5d4e-4c3b-9a8f-7e6d5c4b3a21",
      "trip_id": 42,
      "document_type": "passport",
      "name": "Passport (Ana)",
      "file_url": "https://www.endlesstravelplans.com/api/v1/trips/550e8400-e29b-41d4-a716-446655440000/documents/3f1c2b7a-5d4e-4c3b-9a8f-7e6d5c4b3a21/download",
      "mime_type": "application/pdf",
      "notes": "Expires March 2030",
      "shared_with_trip": false,
      "uploaded_by": {
        "id": 7,
        "first_name": "Ana"
      },
      "can_delete": true,
      "can": {
        "update": true,
        "delete": true,
        "share": true
      },
      "size_bytes": 184320,
      "created_at": "2026-10-14T09:00:00.000000Z",
      "updated_at": "2026-10-14T09:05:00.000000Z"
    }
  ]
}

Changes

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