Investor Preferences

List the implementations of an investor preference

GET/investor-preferences/{investor_preference_id}/implementations
investor-preferences:readlist_investor_preference_implementationsRead-only

Lists the investors' own copies of the preference's form, newest first, and returns one page. Only copies assigned to one investor are listed. An unknown preference returns 404. Use GET /investor-preferences/{investor_preference_id}/implementations/{id} for one. Changes nothing.

Path parameters

  • investor_preference_idstring (uuid)Required#

    The investor preference's id, a uuid. An unknown, malformed or deleted preference returns 404.

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.

  • fieldsstring#

    Comma-separated top-level fields to return. id is always returned.

  • sortstring#

    Comma-separated fields to sort by: created_at. Prefix a field with - for descending. Defaults to -created_at.

Responses

200

One page of implementations.

InvestorPreferenceImplementation[]
{
  "data": [
    {
      "id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
      "investor_id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
      "completed": true,
      "started_at": "2026-06-12T10:00:00+00:00",
      "completed_at": "2026-06-12T10:00:00+00:00",
      "created_at": "2026-06-12T10:00:00+00:00",
      "updated_at": "2026-06-12T10:00:00+00:00"
    }
  ],
  "meta": {
    "limit": 1,
    "next_cursor": "string",
    "prev_cursor": "string"
  }
}
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

The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per problem, or a code documented on the operation.

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl https://your-org-domain/kong/core/api/v2/investor-preferences/{investor_preference_id}/implementations\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"