Skip to main content
GET
Retrieve a distribution

Authorizations

Authorization
string
header
required

OAuth2 client_credentials grant for server-to-server access. Onboard via your Nova admin to receive a client_id and client_secret, then POST /oauth/token to exchange them for a short-lived access token. Send the token as Authorization: Bearer <access_token> on every authenticated request. Tokens expire after 3600 seconds — refresh by re-exchanging credentials.

Headers

X-Organization-Id
string

ID of the organization the request acts on. Optional when the access token is bound to a specific organization, or when the integration has access to exactly one organization.

Pattern: ^org_[A-Za-z0-9]+$
Example:

"org_EkzhrUc3U6C0UbxNBlK7WLz51ofT"

Path Parameters

id
string
required

ID of the distribution

Pattern: ^dst_[A-Za-z0-9]+$
Example:

"dst_tQaOR74NP2DZ9mg3votpOnCqAuGs"

Response

Distribution details

object
enum<string>
required

Object type identifier.

Available options:
distribution
Example:

"distribution"

livemode
boolean
required

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

id
string
required

ID of the distribution

Pattern: ^dst_[A-Za-z0-9]+$
Example:

"dst_tQaOR74NP2DZ9mg3votpOnCqAuGs"

name
string
required
Minimum string length: 1
Example:

"November 9th Distribution from XYZ Sale"

vehicle
string
required

ID of the vehicle this distribution pays from

Pattern: ^veh_[A-Za-z0-9]+$
Example:

"veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w"

external_reference
string | null
required

Your own identifier for this distribution

Example:

"distribution-123"

distribution_date
string<date-time>
required

Date this distribution pays out, rendered as wall-clock time in distribution_timezone, carrying that zone's UTC offset at this date.

Example:

"2026-09-09T16:00:00.000Z"

distribution_timezone
string
required

IANA timezone the distribution date is interpreted and displayed in. UTC when no timezone was supplied at creation.

Example:

"America/Los_Angeles"

short_id
string
required
status
enum<string>
required
Available options:
draft,
published,
approved,
executed,
cancelled
published_at
string<date-time> | null
required
Example:

"2024-04-20T01:00:00.000Z"

approved_at
string<date-time> | null
required
Example:

"2024-04-20T01:00:00.000Z"

executed_at
string<date-time> | null
required
Example:

"2024-04-20T01:00:00.000Z"

cancelled_at
string<date-time> | null
required
Example:

"2024-04-20T01:00:00.000Z"

created_at
string<date-time>
required
Example:

"2024-04-20T01:00:00.000Z"

updated_at
string<date-time>
required
Example:

"2024-04-20T01:00:00.000Z"

sender_url
string<uri>
required

A link for the sender to manage this distribution in the Nova dashboard.

Example:

"https://nova.angellist.com/path_to_sender_distribution"

recipient_url
string<uri>
required

A link for any recipient to view this distribution in the Nova dashboard.

Example:

"https://nova.angellist.com/path_to_recipient_distribution"

payments
object
required