---
title: "List LP accounts and commitment progress"
method: GET
path: "/api/v2/lp/list"
tags: ["LPs"]
---

# List LP accounts and commitment progress

`GET /api/v2/lp/list`

## Request

- Base URL: `https://capitalcompany.ai`
- URL: `https://capitalcompany.ai/api/v2/lp/list`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Includes unverified invitation emails that resolve to an account. Unresolved invitations are listed separately by /lp/invitations. Sorted by display name, email and account ID. An account can have multiple emails with different portfolios; do not deduplicate solely by LP ID. Required key scope: lp:read.

## Query parameters

- `limit` integer: Maximum rows per page (1–500). Omitted means 100.
- `offset` integer: Number of roster rows to skip; omitted means 0. Advance by the requested limit, not the number of changed portfolios.

## Response `200`

Paginated LP accounts, prefixed entity IDs, commitment stages, KYC/agreement status and configured fee terms.

- LpListResponse
  - `success` true, required
  - `data` object, required
    - `totalCount` integer, required
    - `lps` object[], required
      - `id` string, required: lp_<uuid> account ID; one account may occur for multiple invitation emails.
      - `email` string, required
      - `displayName` string, nullable, required
      - `commitmentCount` number, required
      - `fundCount` number, required
      - `entityIds` string[], required
      - `commitments` object[], required
        - `id` string, required
        - `fundId` string, required
        - `fundLegalName` string, required
        - `stage` 'Removed' | 'Inactive' | 'Revoked — Pending Refund' | 'Closed — Final Close Notice Issued' | 'Finalized — Awaiting Fund Close' | 'Awaiting Funds' | 'Awaiting Capital Call' | 'Missing lookthrough owners' | 'Awaiting Amendment Signature' | 'Awaiting Amendment Countersignature' | 'Awaiting Signatory' | 'Awaiting Countersignature' | 'Awaiting Fee Approval' | 'Awaiting Commit Details' | 'Awaiting KYC Approval' | 'Awaiting KYC', required: Current blocking stage, using the same member status as the web app.
        - `kycStatus` 'missing' | 'pending-approval' | 'approved', required
        - `subscriptionAgreementStatus` 'none' | 'pending' | 'completed' | 'not-applicable', required
        - `agreementPartiesSigned` boolean, required
        - `feeTerms` object[], required: Configured fees for this commitment, including negotiated terms. These are schedules, not cash paid or accrued totals.
          - `id` string, required: fee_<uuid> fee schedule identifier.
          - `type` 'admin-fee' | 'management-fee' | 'carried-interest' | 'escrow-fee' | 'fund-cost' | 'deferral-fee' | 'broker-fee', required
          - `earningCondition` 'occurrence-date' | 'fund-close' | 'initial-investment', required: Whether the provider earns the fee on its occurrence date or only when the fund closes.
          - `displayName` string, nullable, required
          - `percentage` number, nullable, required: Configured fraction, e.g. 0.02 means 2%; null for a fixed amount.
          - `amount` number, nullable, required
          - `basisAmountOverride` number, nullable, required
          - `quotedFrequency` 'one-time' | 'quarterly' | 'annually', required: Frequency of the quoted percentage or amount; does not itself determine ledger accrual timing.
          - `accrualType` 'upfront' | 'periodic' | 'at-exit', required
          - `accrualFrequency` 'quarterly' | 'annually', nullable, required
          - `isRefundable` boolean, required
          - `collectionMethod` 'from-invested-capital' | 'from-net-commitment' | 'from-gross-commitment' | 'from-proceeds' | 'from-fee-capital-call' | 'from-fee-capital-call-on-gross', required
          - `fromYear` integer, required
          - `toYear` integer, nullable, required
          - `note` string, nullable, required
          - `currencyCode` string, required: Currency code for monetary amounts; amounts are major units, not cents.
          - `hurdles` object[], required
            - `carryRate` number, required
            - `threshold` number, required: IRR as a fraction or MOIC as a multiple, according to metric.
            - `metric` 'net-moic' | 'net-irr' | 'gross-moic' | 'gross-irr', required
            - `withinWindowInMonths` integer, nullable, required
            - `catchUpRate` number, nullable, required
            - `prefCompounding` 'annual' | 'simple', nullable, required
        - `fundClassFeeTerms` object[], required: Applicable class pools after commitment exclusions; amounts must not be summed as individual LP charges.
          - `id` string, required
          - `feeType` 'admin-fee' | 'management-fee' | 'carried-interest' | 'escrow-fee' | 'fund-cost' | 'deferral-fee' | 'broker-fee', required
          - `poolAmount` number, required: Whole fund-class pool amount, not this investor’s allocated share.
          - `currencyCode` string, required: Currency code for monetary amounts; amounts are major units, not cents.
          - `allocation` 'pro-rata', required
          - `treatment` 'fee-pool' | 'standalone-expense', required
          - `recognitionModel` 'fixed-fee' | 'refundable-reserve', required
          - `isIncludedInSubscription` boolean, required
          - `note` string, nullable, required
    - `pagination` object, required
      - `limit` integer, required
      - `offset` integer, required
      - `hasMore` boolean, required

## Other responses

- `400`: INVALID_PARAMS: request validation failed.
- `401`: MISSING_API_KEY or INVALID_API_KEY: missing, invalid or revoked key.
- `403`: INSUFFICIENT_SCOPE: the key lacks the required scope.
- `429`: RATE_LIMIT_EXCEEDED: respect Retry-After before retrying.
- `500`: INTERNAL_ERROR: unexpected server error.

## Changes

- **2026-10-19** `b99bb24f107d`: 2 warning
  - added the new `from-invested-capital` enum value to the `data/lps/items/commitments/items/feeTerms/items/collectionMethod` response property for the response status `200`
  - added the new `initial-investment` enum value to the `data/lps/items/commitments/items/feeTerms/items/earningCondition` response property for the response status `200`

[Operation history](https://skmtc.dev/capitalcompany/apis/capital-company-external-api/changes/api/v2/lp/list/get.md)

---

[API](https://skmtc.dev/capitalcompany/apis/capital-company-external-api.md) · [All operations](https://skmtc.dev/capitalcompany/apis/capital-company-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/capitalcompany/apis/capital-company-external-api/revisions/b99bb24f107d?raw)