Authentication

All Partner API endpoints (other than the authentication endpoint itself) require a short-lived bearer access token. You get one by calling:

POST /api/v3/partners/auth

Request

Send your client ID and client secret as HTTP Basic credentials in the Authorization header — not in the request body.

Authorization: Basic base64(clientId:clientSecret)

curl -X POST https://be-dev-1.dev.ndovu.co/api/v3/partners/auth \
  -H "Authorization: Basic $(echo -n 'YOUR_CLIENT_ID:YOUR_CLIENT_SECRET' | base64)"

const credentials = Buffer.from(
  `${process.env.NDOVU_CLIENT_ID}:${process.env.NDOVU_CLIENT_SECRET}`
).toString("base64");

const res = await fetch("https://be-dev-1.dev.ndovu.co/api/v3/partners/auth", {
  method: "POST",
  headers: { Authorization: `Basic ${credentials}` },
});

const { access_token, expires_in, token_type } = await res.json();

import base64
import requests

credentials = base64.b64encode(
    f"{CLIENT_ID}:{CLIENT_SECRET}".encode()
).decode()

res = requests.post(
    "https://be-dev-1.dev.ndovu.co/api/v3/partners/auth",
    headers={"Authorization": f"Basic {credentials}"},
)
res.raise_for_status()
token = res.json()["access_token"]

No request body is required or accepted.

Response

A successful call returns 201 Created with:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600,
  "token_type": "Bearer"
}

Field	Type	Description
`access_token`	string	JWT to send as a bearer token on subsequent requests.
`expires_in`	number	Lifetime of the token, in seconds.
`token_type`	string	Always `Bearer`.

There is no refresh token. When access_token expires, call this endpoint again with your client ID and client secret to get a new one.

Using the token

Pass the token as a bearer token on every subsequent request:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Reuse the token until it expires instead of authenticating on every request. When a call returns 401 INVALID_PARTNER_TOKEN, get a new token and retry. See Your Configuration for the next step.

Errors

Status	Code	Cause
`401`	`UNAUTHORIZED`	Missing or malformed `Authorization` header, or not `Basic`.
`401`		Client secret doesn’t match. The body is `{"message": "Unauthorized"}`, with no `code`.
`404`	`PARTNER_NOT_FOUND`	Client ID doesn’t exist.

If you get a 401, double-check you’re sending the raw client secret from your onboarding email — not a hashed or re-encoded version of it. If you’ve lost the original secret, contact support@ndovu.co to have it rotated; we only ever store a one-way hash of it and cannot recover the original value.

Get Started

Customers

Investing

Reference

Request

Response

Using the token

Errors

​Request

​Response

​Using the token

​Errors

Request

Response

Using the token

Errors