Skip to main content
GET
Retrieve an organization

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

org_id
string
required

ID of the organization

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

"org_EkzhrUc3U6C0UbxNBlK7WLz51ofT"

Response

Organization details

object
enum<string>
required

Object type identifier.

Available options:
organization
Example:

"organization"

livemode
boolean
required

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

id
string
required

ID of the organization

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

"org_EkzhrUc3U6C0UbxNBlK7WLz51ofT"

name
string
required

Name of the organization

Example:

"Acme Capital"

recipient_payment_instructions_verification_url
string<uri>
required

Link where a recipient confirms payment instructions. The recipient selects which of their entities to confirm for.

Example:

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