---
title: "Read unresolved invitations and their commitments"
method: GET
path: "/api/v2/lp/invitations"
tags: ["LPs"]
---

# Read unresolved invitations and their commitments

`GET /api/v2/lp/invitations`

## Request

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

Active invitations with commitments that cannot resolve to one LP account. missing-user-account means no account exists; ambiguous-email means ownership is not uniquely resolved. These records are not synthetic LP accounts. Join by commitmentId to avoid double-counting once an invitation resolves and appears in /lp/list. Sorted by invitation ID and commitment 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`

Invitation, entity and fund identities, subscription amount/currency, reason, stage, KYC/agreement status and configured fee terms.

- LpInvitationsResponse
  - `success` true, required
  - `data` object, required
    - `totalCount` integer, required
    - `invitations` object[], required
      - `id` string, required
      - `email` string, nullable, required
      - `commitmentId` string, required
      - `fundId` string, required
      - `entityId` string, required
      - `fundLegalName` string, required
      - `entityLegalName` string, required
      - `subscriptionAmount` number, required
      - `currencyCode` string, required: Currency code for monetary amounts; amounts are major units, not cents.
      - `reason` 'ambiguous-email' | 'missing-user-account', 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/invitations/items/feeTerms/items/collectionMethod` response property for the response status `200`
  - added the new `initial-investment` enum value to the `data/invitations/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/invitations/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)