Documents

The deal's latest documents

GET/deals/{dealId}/latest-documents
documents:readget_deal_latest_documentsRead-onlyDeprecatedSunset 2027-06-30

Cursor-paginated documents in the deal's folder tree, newest first. Unreadable documents and, as before, documents in hidden folders are left out (the successor lists them). An unknown or invisible deal returns 404. Deprecated: use GET /documents?filter[deal_id]={dealId}&sort=-created_at instead. Withdrawn on 2027-06-30. Responses carry Deprecation, Sunset and a successor Link.

Path parameters

  • dealIdstring (uuid)Required#

    The deal uuid.

Query parameters

  • limitinteger#

    Page size (1–100). Defaults to 25; values are clamped to the range.

    Default: 25
  • cursorstring#

    Opaque pagination cursor taken from a prior response's meta.next_cursor.

Responses

200

OK

{
  "data": [
    {
      "id": "5e6f7081-92a3-4b4c-9d6e-7f8091a2b3c4",
      "name": "term-sheet.pdf",
      "folder_id": "071829a3-4b5c-4d6e-8f90-1a2b3c4d5e6f",
      "size": 482113,
      "mime_type": "application/pdf",
      "created_at": "2026-06-15T10:30:00+00:00"
    }
  ],
  "links": {
    "first": null,
    "last": null,
    "prev": null,
    "next": "https://your-org-domain/kong/core/api/v2/users?cursor=eyJpZCI6MjUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0"
  },
  "meta": {
    "path": "https://your-org-domain/kong/core/api/v2/users",
    "per_page": 25,
    "next_cursor": "eyJpZCI6MjUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
    "prev_cursor": null
  }
}
401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
404

Resource not found (error.code = not_found).

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl https://your-org-domain/kong/core/api/v2/deals/{dealId}/latest-documents\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"