---
title: "List capital calls for a vehicle — status tracks the due date only, never collection"
method: GET
path: "/v1/capital_calls"
tags: ["capital_calls"]
---

# List capital calls for a vehicle — status tracks the due date only, never collection

`GET /v1/capital_calls`

## Request

- Base URL: `https://api.angellist.com`
- URL: `https://api.angellist.com/v1/capital_calls`
- Auth: OAuth 2
  - Authorization code: `https://gateway.angellist.com/oauth/authorize`
  - Client credentials
  - Token URL: `https://gateway.angellist.com/oauth/token` scopes: `capital_calls:read`

Returns capital calls for a single investment vehicle, newest first by initiation date. `vehicle` is required. A capital call is the schedule of an ask: each row carries the requested percentage of commitment, the total `amount` asked, the per-partner breakdown of that ask in `partner_breakdown`, and the LP `group` the call was issued to (when the fund uses groups). It reports what was called, never what arrived — collection standing lives on capital accounts.

Supported vehicle types: `spv`, `ruv`, `venture_fund`, and `institutional_fund`. An SPV or RUV returns its single implicit 100% call. Institutional-fund rows are scheduled requests; they report the ask and its requested dates, never collection. Calls with a `vehicle` belonging to a `rolling_fund_quarter` return 404.

## Query parameters

- `vehicle` string, required
- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

A list of capital calls for the vehicle.

- CapitalCallList
  - `data` CapitalCall[], required
    - `amount` CurrencyAmount, required: A monetary amount in a single currency. `amount` is an integer in the currency's smallest unit (cents for USD; 100 = $1.00) — never whole dollars. `formatted` is the same value rendered in whole units for display.
      - `amount` integer, required: Signed amount in the smallest unit of the currency (cents for USD; 100 = $1.00).
      - `currency` string, required: Uppercase ISO 4217 currency code, optionally suffixed with a digit `n` for AngelList high-precision currencies, which have `n - 1` fraction digits: `9906000` in `CAD8` is CA$0.9906.
      - `formatted` string, nullable, required: The amount rendered as a human-readable string in whole currency units (e.g. `$1,000,000.00` for `amount: 100000000, currency: USD`). Authoritative for magnitude; use `amount` for arithmetic. `null` when the currency has no rendering data — the value is never guessed.
    - `created` integer, required: Time at which the capital call record was created. Measured in seconds since the Unix epoch.
    - `due_at` integer, nullable: The call's stated funding deadline — UTC midnight of the due date, and the sole input to `status`. Null when no deadline exists yet — auto-created calls (the SPV/RUV implicit 100% call, a fund's initial drawdown) get their deadline backfilled at the first close. Individual partners' effective deadlines can be later than this date.
    - `group` CapitalCallGroup: The LP group a capital call was issued to. Groups are a per-fund calling-policy feature; a group carries no public id yet, so it is identified by name within its vehicle.
      - `is_default` boolean, required: Whether this is the vehicle's default group — the one new partners join automatically when the fund uses groups.
      - `name` string, required: The group's display name, unique within its vehicle.
    - `id` string, required: Unique opaque identifier for this capital call.
    - `initiated_at` integer, required: The date the call was initiated — notices go out and the funding clock starts. Measured in seconds since the Unix epoch (UTC midnight of the initiation date).
    - `livemode` boolean, required: Whether this object exists in live mode (`true`) or test mode (`false`).
    - `object` 'capital_call', required: Object type identifier.
    - `partner_breakdown` CapitalCallPartner[], required: Per-partner breakdown of the ask — one entry per partner the call reaches, ordered by partner identity, deduped across a partner's closings. Always inline, on lists and single reads; may be empty (an SPV's implicit call before any LP signs). The `called` amounts sum to `amount`. Partners awaiting their close are omitted — the fund has not called capital from them yet.
      - `called` CurrencyAmount, required: A monetary amount in a single currency. `amount` is an integer in the currency's smallest unit (cents for USD; 100 = $1.00) — never whole dollars. `formatted` is the same value rendered in whole units for display.
        - `amount` integer, required: Signed amount in the smallest unit of the currency (cents for USD; 100 = $1.00).
        - `currency` string, required: Uppercase ISO 4217 currency code, optionally suffixed with a digit `n` for AngelList high-precision currencies, which have `n - 1` fraction digits: `9906000` in `CAD8` is CA$0.9906.
        - `formatted` string, nullable, required: The amount rendered as a human-readable string in whole currency units (e.g. `$1,000,000.00` for `amount: 100000000, currency: USD`). Authoritative for magnitude; use `amount` for arithmetic. `null` when the currency has no rendering data — the value is never guessed.
      - `partner` PartnerRef, required: A reference to a partner by id. The `partner_` prefix encodes the type, so no `object` field is needed. The id is the same one `/v1/partners` and capital accounts use, stable across all of the organization's vehicles. Not expandable.
        - `id` string, required: Identifier of the referenced partner.
    - `percentage_bps` integer, required: Fraction of commitment called, in integer basis points (2500 = 25%; 10000 = 100%). The GP's canonical input — dollar amounts derive from it. Rounded half-even from venture's stored 12-decimal fraction; the money fields are computed from the full-precision value, so the rounding never moves money.
    - `purpose` string, nullable: The GP-authored purpose of the call, as printed on the formal Capital Call Notice. Null when the GP left it blank (the notice then falls back to LPA boilerplate).
    - `status` 'in_progress' | 'completed', required: Due-date lifecycle, computed at read time from `due_at` alone: `completed` means the call is past its due date; it does not indicate whether the money arrived. `in_progress` means the due date has not fully passed — or no deadline exists yet (`due_at` is null). A call flips to `completed` 24 hours after `due_at` (midnight UTC after the due date), so it stays `in_progress` through the whole due day.
    - `vehicle` object, required: The vehicle that issued this capital call.
      - `id` string, required: Encoded vehicle identifier.
  - `has_more` boolean, required: Whether there are more items available after this page.
  - `object` 'list', required
  - `url` string, required: The URL for this list endpoint.

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication required or token invalid.
- `403`: The authenticated user does not have permission to access this resource, or the vehicle's data is not available through the API. Vehicle-scoped financial-data endpoints return code `not_available` when a vehicle's data isn't served through the API yet — the API returns verified data or none, never partial data. One account can hold a mix of covered and uncovered vehicles; support for uncovered vehicles is on the roadmap and will be added in the coming months.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: An unexpected error occurred.

---

[API](https://skmtc.dev/angellist/apis/angellist-funds-api.md) - [All operations](https://skmtc.dev/angellist/apis/angellist-funds-api/llms.txt) - [OpenAPI document](https://skmtc.dev/angellist/apis/angellist-funds-api/revisions/b339e0e06c02?raw)