--- title: "Get a distribution" method: GET path: "/v1/distributions/{distribution_id}" tags: ["distributions"] --- # Get a distribution `GET /v1/distributions/{distribution_id}` ## Request - Base URL: `https://api.angellist.com` - URL: `https://api.angellist.com/v1/distributions/{distribution_id}` - Auth: OAuth 2 - Authorization code: `https://gateway.angellist.com/oauth/authorize` - Client credentials - Token URL: `https://gateway.angellist.com/oauth/token` scopes: `distributions:read` Returns a single distribution by ID. The `vehicle` query parameter is required for authorization — the caller must have access to the vehicle the distribution belongs to. ## Path parameters - `distribution_id` string, required ## Query parameters - `vehicle` string, required ## Response `200` The distribution. - Distribution: A distribution of capital from a vehicle to its partners. Distributions are workflow entities — their status tracks the lifecycle from pending through approval to execution. - `cash` CurrencyAmount: 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. - `category` string, nullable: Economic category selected for the distribution. Null when the source workflow does not classify the distribution. - `created` integer, required: Time at which the distribution record was created. Measured in seconds since the Unix epoch. - `effective_at` integer, nullable: Requested effective date, measured in seconds since the Unix epoch at UTC midnight. This is not proof that the distribution executed on that date. Null when no requested effective date is available. - `executed_at` integer, nullable: Time at which the distribution was executed. Measured in seconds since the Unix epoch. Null when the distribution has not yet been executed. - `id` string, required: Unique identifier for this distribution. The underlying record id is encoded through a salted Sqid alphabet so the internal database identifier is never on the wire. - `livemode` boolean, required: Whether this object exists in live mode (`true`) or test mode (`false`). - `object` 'distribution', required: Object type identifier. - `status` 'pending' | 'approved' | 'completed', required: Current lifecycle status of the distribution. - `stock_quantity` integer, nullable: Number of shares distributed in-kind. Null when the distribution is entirely cash or no executed in-kind quantity is available. - `tax_withholding` CurrencyAmount: 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. - `total` 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. - `vehicle` object, required: The vehicle this distribution belongs to. - `id` string, required: Encoded vehicle identifier. ## 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)