ANangellist
subscriptions

Get a subscription

Returns a single subscription by ID. Access is authorized against the vehicle the subscription belongs to, which is resolved from the subscription ID — the caller must have access to that vehicle.

get/v1/subscriptions/{subscription_id}

Request

  • Base URL
    https://api.angellist.com
  • Auth
    OAuth 2
    Authorization code: https://gateway.angellist.com/oauth/authorize
    Client credentials
    Token URL: https://gateway.angellist.com/oauth/token scopes: subscriptions:read

Path parameters

subscription_idstring required
Example:sub_5tV7xK2mN4pR8qS1

Unique identifier for the subscription.

Response

The subscription.

createdinteger required

Time at which the subscription was created. Measured in seconds since the Unix epoch.

idstring required

Unique identifier for this subscription. The underlying record id is encoded through a salted Sqid alphabet so the internal database identifier is never on the wire.

livemodeboolean required

Whether this object exists in live mode (true) or test mode (false).

object'subscription' required

Object type identifier.

side_letterboolean required

Whether the subscription is governed by a side letter. Always false for rolling-fund quarters (no per-segment side-letter flag exists).

signatory_namestring nullable

The name of the individual who signed the subscription agreement, when available.

signed_atinteger nullable

Time at which the subscription was signed. Measured in seconds since the Unix epoch. Null before the subscription is signed.

status'signed' | 'funded' | 'rescinded' | 'defaulted' | 'partially_defaulted' required

Current lifecycle status of the subscription, tracking it from signature through funding. Rolling-fund quarters emit only signed (the partner has committed for the quarter), funded, and rescinded — never defaulted or partially_defaulted.

Example response

{
  "capital_call_group": {
    "id": "ccgrp_1wR4tYb8xQ2mK5nP",
    "name": "Q1 2026 Close"
  },
  "close_ids": [
    {
      "id": "cls_3nP1wR4tYb8xQ2mK"
    }
  ],
  "commitment": {
    "currency": "USD",
    "formatted": "$1,000,000.00"
  },
  "id": "sub_5tV7xK2mN4pR8qS1",
  "partner": {
    "id": "partner_8xQ2mK5nP1wR4tYb"
  },
  "vehicle": {
    "id": "vhcl_k9Rm3nQp8wL1YxTa"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.