List an investor's tranche investments for a deal

GET/deals/{dealId}/tranches/investments

tranches:read list_tranche_investmentsRead-onlyDeprecatedSunset 2027-06-30

Cursor-paginated list of a single investor's investments across the deal's tranches. The investor is named explicitly via userId (a user guid), resolved within the token's organisation — a cross-org or unknown guid is a leak-safe 404. An investor with no participation rows yields an empty list. Deprecated: withdrawn on 2027-06-30. GET /investments?filter[deal_id]=…&filter[investor_id]=… replaces it; every answer carries a Link header with rel="successor-version" to the deal's investments.

Path parameters

dealIdstring (uuid)Required#
The deal's public uuid.

Query parameters

userIdstring (uuid)Required#
The investor's user guid.
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

{
  "data": [
    {
      "id": "5d9e6679-7425-40de-944b-e07fc1f90ae7",
      "tranche_id": "3c9e6679-7425-40de-944b-e07fc1f90ae7",
      "deal_id": "f6071829-3a4b-4c5d-9e6f-8091a2b3c4d5",
      "user_id": "6f1c2e8a-1b2c-4d5e-8f90-1a2b3c4d5e6f",
      "label": "Initial",
      "committed_amount": "50000",
      "confirmed_amount": "25000",
      "currency_code": "USD",
      "created_at": "2026-06-15T10:30:00+00:00",
      "updated_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

422

Request validation failed (HTTP 422). The body is either the Laravel validation envelope (message + field-keyed errors) or the API error envelope for domain rejections (e.g. form_type_not_supported, folder_locked, parent_not_found, folder_not_empty).

429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl https://your-org-domain/kong/core/api/v2/deals/{dealId}/tranches/investments?userId={userId}\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"