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.

Required string length: 32
Pattern: ^org_[A-Za-z0-9]+$
Example:

"org_EkzhrUc3U6C0UbxNBlK7WLz51ofT"

Path Parameters

id
string
required

ID of the distribution

Required string length: 32
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

Required string length: 32
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

Required string length: 32
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
ZonedDateTime

The date this distribution pays out, in distribution_timezone.

Type: ZonedDateTime ISO 8601 Date and time in the record's TimeZone

Example:

"2026-09-09T09:00:00-07:00"

distribution_timezone
string
default:UTC
required
TimeZone

The timezone distribution_date and every payments[].distribution_date_override are interpreted in, and rendered with in responses.

Type: TimeZone IANA timezone name

Example:

"America/Los_Angeles"

short_id
string
required
status
enum<string>
required
DistributionStatus

Type: DistributionStatus Where the distribution is in its lifecycle

Available options:
draft,
published,
approved,
executed,
cancelled
Example:

"published"

published_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"

approved_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"

executed_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"

cancelled_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"

created_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09:00:00.000Z"

updated_at
string<date-time>
required
UtcDateTime

Type: UtcDateTime Date and time in UTC

Example:

"2026-01-01T09: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
List

Type: List A page of results