Create distributions

curl --request POST \
  --url https://api.nova.net/v1/distributions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "name": "November 9th Distribution from XYZ Sale",
    "vehicle": "veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w",
    "distribution_date": "2026-09-09T09:00",
    "payments": [
      {
        "amount": 1000,
        "currency": "USD",
        "entity": "ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p",
        "notifications": [
          {
            "contact": "cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI"
          }
        ],
        "distribution_date_override": "2026-09-16T09:00"
      }
    ],
    "external_reference": "distribution-123",
    "distribution_timezone": "America/Los_Angeles"
  }
]
'

import requests

url = "https://api.nova.net/v1/distributions"

payload = [
    {
        "name": "November 9th Distribution from XYZ Sale",
        "vehicle": "veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w",
        "distribution_date": "2026-09-09T09:00",
        "payments": [
            {
                "amount": 1000,
                "currency": "USD",
                "entity": "ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p",
                "notifications": [{ "contact": "cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI" }],
                "distribution_date_override": "2026-09-16T09:00"
            }
        ],
        "external_reference": "distribution-123",
        "distribution_timezone": "America/Los_Angeles"
    }
]
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      name: 'November 9th Distribution from XYZ Sale',
      vehicle: 'veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w',
      distribution_date: '2026-09-09T09:00',
      payments: [
        {
          amount: 1000,
          currency: 'USD',
          entity: 'ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p',
          notifications: [{contact: 'cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI'}],
          distribution_date_override: '2026-09-16T09:00'
        }
      ],
      external_reference: 'distribution-123',
      distribution_timezone: 'America/Los_Angeles'
    }
  ])
};

fetch('https://api.nova.net/v1/distributions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nova.net/v1/distributions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'name' => 'November 9th Distribution from XYZ Sale',
        'vehicle' => 'veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w',
        'distribution_date' => '2026-09-09T09:00',
        'payments' => [
                [
                                'amount' => 1000,
                                'currency' => 'USD',
                                'entity' => 'ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p',
                                'notifications' => [
                                                                [
                                                                                                                                'contact' => 'cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI'
                                                                ]
                                ],
                                'distribution_date_override' => '2026-09-16T09:00'
                ]
        ],
        'external_reference' => 'distribution-123',
        'distribution_timezone' => 'America/Los_Angeles'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nova.net/v1/distributions"

	payload := strings.NewReader("[\n  {\n    \"name\": \"November 9th Distribution from XYZ Sale\",\n    \"vehicle\": \"veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w\",\n    \"distribution_date\": \"2026-09-09T09:00\",\n    \"payments\": [\n      {\n        \"amount\": 1000,\n        \"currency\": \"USD\",\n        \"entity\": \"ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p\",\n        \"notifications\": [\n          {\n            \"contact\": \"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI\"\n          }\n        ],\n        \"distribution_date_override\": \"2026-09-16T09:00\"\n      }\n    ],\n    \"external_reference\": \"distribution-123\",\n    \"distribution_timezone\": \"America/Los_Angeles\"\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.nova.net/v1/distributions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"name\": \"November 9th Distribution from XYZ Sale\",\n    \"vehicle\": \"veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w\",\n    \"distribution_date\": \"2026-09-09T09:00\",\n    \"payments\": [\n      {\n        \"amount\": 1000,\n        \"currency\": \"USD\",\n        \"entity\": \"ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p\",\n        \"notifications\": [\n          {\n            \"contact\": \"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI\"\n          }\n        ],\n        \"distribution_date_override\": \"2026-09-16T09:00\"\n      }\n    ],\n    \"external_reference\": \"distribution-123\",\n    \"distribution_timezone\": \"America/Los_Angeles\"\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.nova.net/v1/distributions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"name\": \"November 9th Distribution from XYZ Sale\",\n    \"vehicle\": \"veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w\",\n    \"distribution_date\": \"2026-09-09T09:00\",\n    \"payments\": [\n      {\n        \"amount\": 1000,\n        \"currency\": \"USD\",\n        \"entity\": \"ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p\",\n        \"notifications\": [\n          {\n            \"contact\": \"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI\"\n          }\n        ],\n        \"distribution_date_override\": \"2026-09-16T09:00\"\n      }\n    ],\n    \"external_reference\": \"distribution-123\",\n    \"distribution_timezone\": \"America/Los_Angeles\"\n  }\n]"

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "distribution",
      "livemode": true,
      "id": "dst_tQaOR74NP2DZ9mg3votpOnCqAuGs",
      "name": "November 9th Distribution from XYZ Sale",
      "vehicle": "veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w",
      "external_reference": "distribution-123",
      "distribution_date": "2026-09-09T09:00:00-07:00",
      "distribution_timezone": "America/Los_Angeles",
      "short_id": "<string>",
      "status": "published",
      "published_at": "2026-01-01T09:00:00.000Z",
      "approved_at": "2026-01-01T09:00:00.000Z",
      "executed_at": "2026-01-01T09:00:00.000Z",
      "cancelled_at": "2026-01-01T09:00:00.000Z",
      "created_at": "2026-01-01T09:00:00.000Z",
      "updated_at": "2026-01-01T09:00:00.000Z",
      "sender_url": "https://nova.angellist.com/path_to_sender_distribution",
      "recipient_url": "https://nova.angellist.com/path_to_recipient_distribution",
      "payments": {
        "object": "list",
        "data": [
          {
            "object": "distribution_payment",
            "livemode": true,
            "id": "dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4",
            "amount": 1000,
            "currency": "USD",
            "distribution_date_override": "2026-09-16T09:00:00-07:00",
            "status": "staged",
            "recipient_confirmed_at": "2026-01-01T09:00:00.000Z",
            "verified_at": "2026-01-01T09:00:00.000Z",
            "entity": "ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p",
            "payment_instructions": "pmi_021wlGURMlk80cYuKBjENXqwC3OV",
            "notifications": {
              "object": "list",
              "data": [
                {
                  "object": "distribution_notification",
                  "livemode": true,
                  "id": "dntf_bXlZNOmqHkAM8gS4h12vtwlI9sJx",
                  "contact": "cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI"
                }
              ],
              "next_page_url": "/v1/distribution_payments/dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4/notifications?page=page_5dr8SFDbv7rZ2aj4&limit=10",
              "previous_page_url": "/v1/distribution_payments/dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4/notifications?page_before=page_8VtqLBv3xJpY7mk2&limit=10",
              "has_more": true,
              "url": "/v1/distribution_payments/dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4/notifications"
            }
          }
        ],
        "next_page_url": "/v1/distributions/dst_tQaOR74NP2DZ9mg3votpOnCqAuGs/payments?page=page_5dr8SFDbv7rZ2aj4&limit=10",
        "previous_page_url": "/v1/distributions/dst_tQaOR74NP2DZ9mg3votpOnCqAuGs/payments?page_before=page_8VtqLBv3xJpY7mk2&limit=10",
        "has_more": true,
        "url": "/v1/distributions/dst_tQaOR74NP2DZ9mg3votpOnCqAuGs/payments"
      }
    }
  ],
  "next_page_url": "/v1/distributions?page=page_5dr8SFDbv7rZ2aj4&limit=10",
  "previous_page_url": "/v1/distributions?page_before=page_8VtqLBv3xJpY7mk2&limit=10",
  "has_more": true,
  "url": "/v1/distributions"
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

Distributions

Create distributions

Create and publish one fund distribution. The request body is an array that must contain exactly one distribution. The created distribution is published, and its payments start as staged. Each distribution has one or more payments; each payment references an existing entity by ID (entity) and an optional list of contacts to notify (notifications[].contact). Create entities and contacts first via POST /v1/entities and POST /v1/contacts.

Creating a distribution also associates the records it references:

Each contact in notifications[].contact is associated with the entity on the same payment.
Each payment entity is associated with the distribution vehicle.

POST

distributions

Create distributions

curl --request POST \
  --url https://api.nova.net/v1/distributions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "name": "November 9th Distribution from XYZ Sale",
    "vehicle": "veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w",
    "distribution_date": "2026-09-09T09:00",
    "payments": [
      {
        "amount": 1000,
        "currency": "USD",
        "entity": "ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p",
        "notifications": [
          {
            "contact": "cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI"
          }
        ],
        "distribution_date_override": "2026-09-16T09:00"
      }
    ],
    "external_reference": "distribution-123",
    "distribution_timezone": "America/Los_Angeles"
  }
]
'

import requests

url = "https://api.nova.net/v1/distributions"

payload = [
    {
        "name": "November 9th Distribution from XYZ Sale",
        "vehicle": "veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w",
        "distribution_date": "2026-09-09T09:00",
        "payments": [
            {
                "amount": 1000,
                "currency": "USD",
                "entity": "ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p",
                "notifications": [{ "contact": "cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI" }],
                "distribution_date_override": "2026-09-16T09:00"
            }
        ],
        "external_reference": "distribution-123",
        "distribution_timezone": "America/Los_Angeles"
    }
]
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify([
    {
      name: 'November 9th Distribution from XYZ Sale',
      vehicle: 'veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w',
      distribution_date: '2026-09-09T09:00',
      payments: [
        {
          amount: 1000,
          currency: 'USD',
          entity: 'ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p',
          notifications: [{contact: 'cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI'}],
          distribution_date_override: '2026-09-16T09:00'
        }
      ],
      external_reference: 'distribution-123',
      distribution_timezone: 'America/Los_Angeles'
    }
  ])
};

fetch('https://api.nova.net/v1/distributions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nova.net/v1/distributions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    [
        'name' => 'November 9th Distribution from XYZ Sale',
        'vehicle' => 'veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w',
        'distribution_date' => '2026-09-09T09:00',
        'payments' => [
                [
                                'amount' => 1000,
                                'currency' => 'USD',
                                'entity' => 'ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p',
                                'notifications' => [
                                                                [
                                                                                                                                'contact' => 'cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI'
                                                                ]
                                ],
                                'distribution_date_override' => '2026-09-16T09:00'
                ]
        ],
        'external_reference' => 'distribution-123',
        'distribution_timezone' => 'America/Los_Angeles'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.nova.net/v1/distributions"

	payload := strings.NewReader("[\n  {\n    \"name\": \"November 9th Distribution from XYZ Sale\",\n    \"vehicle\": \"veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w\",\n    \"distribution_date\": \"2026-09-09T09:00\",\n    \"payments\": [\n      {\n        \"amount\": 1000,\n        \"currency\": \"USD\",\n        \"entity\": \"ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p\",\n        \"notifications\": [\n          {\n            \"contact\": \"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI\"\n          }\n        ],\n        \"distribution_date_override\": \"2026-09-16T09:00\"\n      }\n    ],\n    \"external_reference\": \"distribution-123\",\n    \"distribution_timezone\": \"America/Los_Angeles\"\n  }\n]")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.nova.net/v1/distributions")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("[\n  {\n    \"name\": \"November 9th Distribution from XYZ Sale\",\n    \"vehicle\": \"veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w\",\n    \"distribution_date\": \"2026-09-09T09:00\",\n    \"payments\": [\n      {\n        \"amount\": 1000,\n        \"currency\": \"USD\",\n        \"entity\": \"ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p\",\n        \"notifications\": [\n          {\n            \"contact\": \"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI\"\n          }\n        ],\n        \"distribution_date_override\": \"2026-09-16T09:00\"\n      }\n    ],\n    \"external_reference\": \"distribution-123\",\n    \"distribution_timezone\": \"America/Los_Angeles\"\n  }\n]")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.nova.net/v1/distributions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n  {\n    \"name\": \"November 9th Distribution from XYZ Sale\",\n    \"vehicle\": \"veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w\",\n    \"distribution_date\": \"2026-09-09T09:00\",\n    \"payments\": [\n      {\n        \"amount\": 1000,\n        \"currency\": \"USD\",\n        \"entity\": \"ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p\",\n        \"notifications\": [\n          {\n            \"contact\": \"cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI\"\n          }\n        ],\n        \"distribution_date_override\": \"2026-09-16T09:00\"\n      }\n    ],\n    \"external_reference\": \"distribution-123\",\n    \"distribution_timezone\": \"America/Los_Angeles\"\n  }\n]"

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "object": "distribution",
      "livemode": true,
      "id": "dst_tQaOR74NP2DZ9mg3votpOnCqAuGs",
      "name": "November 9th Distribution from XYZ Sale",
      "vehicle": "veh_pNvehE6O1KjY2W6Omq9MD3QAEs5w",
      "external_reference": "distribution-123",
      "distribution_date": "2026-09-09T09:00:00-07:00",
      "distribution_timezone": "America/Los_Angeles",
      "short_id": "<string>",
      "status": "published",
      "published_at": "2026-01-01T09:00:00.000Z",
      "approved_at": "2026-01-01T09:00:00.000Z",
      "executed_at": "2026-01-01T09:00:00.000Z",
      "cancelled_at": "2026-01-01T09:00:00.000Z",
      "created_at": "2026-01-01T09:00:00.000Z",
      "updated_at": "2026-01-01T09:00:00.000Z",
      "sender_url": "https://nova.angellist.com/path_to_sender_distribution",
      "recipient_url": "https://nova.angellist.com/path_to_recipient_distribution",
      "payments": {
        "object": "list",
        "data": [
          {
            "object": "distribution_payment",
            "livemode": true,
            "id": "dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4",
            "amount": 1000,
            "currency": "USD",
            "distribution_date_override": "2026-09-16T09:00:00-07:00",
            "status": "staged",
            "recipient_confirmed_at": "2026-01-01T09:00:00.000Z",
            "verified_at": "2026-01-01T09:00:00.000Z",
            "entity": "ent_H0hdMOc5E5QMTEcGVZKegvLNCB6p",
            "payment_instructions": "pmi_021wlGURMlk80cYuKBjENXqwC3OV",
            "notifications": {
              "object": "list",
              "data": [
                {
                  "object": "distribution_notification",
                  "livemode": true,
                  "id": "dntf_bXlZNOmqHkAM8gS4h12vtwlI9sJx",
                  "contact": "cnt_tSfCZrNE8O3c4QATSkzuCljMZ2DI"
                }
              ],
              "next_page_url": "/v1/distribution_payments/dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4/notifications?page=page_5dr8SFDbv7rZ2aj4&limit=10",
              "previous_page_url": "/v1/distribution_payments/dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4/notifications?page_before=page_8VtqLBv3xJpY7mk2&limit=10",
              "has_more": true,
              "url": "/v1/distribution_payments/dpmt_sSTfFdsytyOearj36zDNcmXn1pJ4/notifications"
            }
          }
        ],
        "next_page_url": "/v1/distributions/dst_tQaOR74NP2DZ9mg3votpOnCqAuGs/payments?page=page_5dr8SFDbv7rZ2aj4&limit=10",
        "previous_page_url": "/v1/distributions/dst_tQaOR74NP2DZ9mg3votpOnCqAuGs/payments?page_before=page_8VtqLBv3xJpY7mk2&limit=10",
        "has_more": true,
        "url": "/v1/distributions/dst_tQaOR74NP2DZ9mg3votpOnCqAuGs/payments"
      }
    }
  ],
  "next_page_url": "/v1/distributions?page=page_5dr8SFDbv7rZ2aj4&limit=10",
  "previous_page_url": "/v1/distributions?page_before=page_8VtqLBv3xJpY7mk2&limit=10",
  "has_more": true,
  "url": "/v1/distributions"
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

{
  "object": "error",
  "type": "invalid_request_error",
  "code": "parameter_invalid_integer",
  "message": "One or more fields failed validation.",
  "status": 400,
  "doc_url": "https://docs.nova.net/errors/parameter_invalid_integer",
  "invalid-params": [
    {
      "code": "parameter_invalid_integer",
      "name": "query.limit",
      "value": 200,
      "reason": "Too big: expected number to be <=100"
    }
  ]
}

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"

Idempotency-Key

string

Only applies to POST, PUT, PATCH, and DELETE; ignored on reads.

Type: IdempotencyKey A unique key that makes a mutating request safely retryable, kept for 24 hours

Body

application/json

Required array length: 1 element

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"

distribution_date

string<date-time>

required

ZonedDateTime

The date this distribution pays out, in distribution_timezone.

NOTE: An offset that does not match the zone on this date is rejected

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

Example:

"2026-09-09T09:00"

payments

object[]

required

List of payments

Minimum array length: 1

Show child attributes

external_reference

string | null

Your own identifier for this distribution

Example:

"distribution-123"

distribution_timezone

string | null

default:UTC

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"

Response

Distribution created

Type: List A page of results

object

enum<string>

required

Object type identifier.

Available options:

list

Example:

"list"

data

object[]

required

The page of items.

Show child attributes

next_page_url

string | null

required

URL for the next page of the list, or null when there are no more pages.

Example:

"/v1/distributions?page=page_5dr8SFDbv7rZ2aj4&limit=10"

previous_page_url

string | null

required

URL for the previous page of the list, or null when there are none.

Example:

"/v1/distributions?page_before=page_8VtqLBv3xJpY7mk2&limit=10"

has_more

boolean

required

deprecated

Whether there are more items available after this page. Deprecated: next_page_url is non-null exactly when more pages exist.

url

string

required

deprecated

Path identifying this list. Deprecated: on lists embedded in another object, or returned by a create, it may not be a GET endpoint you can call. Follow next_page_url / previous_page_url to paginate.

Example:

"/v1/distributions"

Distributions

Payment Instructions

Entities

Contacts

Organizations

Vehicles

Financial Accounts

Create distributions

Authorizations

Headers

Body

Response