Skip to main content
GET
/
v1
/
organizations
cURL
curl --request GET \
  --url https://api.nxos.io/v1/organizations \
  --header 'Authorization: <authorization>'
{
  "object": "organization",
  "organizationId": "org_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "name": "Acme Trading Co.",
  "type": "BUSINESS",
  "verificationStatus": "APPROVED",
  "createdByOrganizationId": "org_b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5",
  "metadata": {},
  "createdAt": "2025-12-01T10:30:00.000Z",
  "updatedAt": "2026-03-15T14:30:00.000Z"
}

Headers

​
Authorization
string
required

Bearer token. Format: Bearer <api_key>

Response

The request has succeeded.

An organization on the platform.

​
object
enum<string>
required

Object type. Always organization.

Available options:
organization
​
organizationId
string
required

Unique organization identifier.

​
name
string
required

Display name of the organization.

​
type
enum<string>
required

Legal-entity type.

Available options:
BUSINESS,
INDIVIDUAL
​
verificationStatus
enum<string>
required

Current verification status. The org may transact only when this is APPROVED.

Available options:
NOT_STARTED,
PENDING,
APPROVED,
REJECTED,
ON_HOLD,
RESUBMISSION_REQUIRED
​
createdByOrganizationId
string | null
required

Organization that created this one via the platform API. null for direct sign-ups (the org created itself through the dashboard).

​
metadata
object
required

Caller-supplied metadata. Free-form JSON, max 4 KB serialized and 50 keys.

​
createdAt
string
required

ISO 8601 timestamp when the org was created.

​
updatedAt
string
required

ISO 8601 timestamp of the most recent state change.