Overview
Accounts
Funding methods
Beneficiaries
Transactions
Authorizations
Create organization
Create a child organization owned by the calling org.
The new org is returned with verificationStatus = 'NOT_STARTED' and
createdByOrganizationId set to your org. The default primary account
and funding methods are provisioned asynchronously. No API key is
auto-issued for the child; the calling org operates on it through the
Nxos-On-Behalf-Of header (after the customer signs the LOA and
completes verification).
This endpoint deliberately ignores Nxos-On-Behalf-Of: a broker
cannot create grandchild orgs on a customer’s behalf.
curl --request POST \
--url https://api.nxos.io/v1/organizations \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"type": "BUSINESS",
"metadata": {}
}
'{
"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"
}Documentation Index
Fetch the complete documentation index at: https://docs.nxos.io/llms.txt
Use this file to discover all available pages before exploring further.
Headers
Bearer token. Format: Bearer <api_key>
Unique key per logical operation. UUID v4 recommended. Max 255 characters.
Body
Request body for POST /v1/organizations.
Response
The request has succeeded.
An organization on the platform.
Object type. Always organization.
organization Unique organization identifier.
Display name of the organization.
Legal-entity type.
BUSINESS, INDIVIDUAL Current verification status. The org may transact only when this is APPROVED.
NOT_STARTED, PENDING, APPROVED, REJECTED, ON_HOLD, RESUBMISSION_REQUIRED Organization that created this one via the platform API. null for direct sign-ups (the org created itself through the dashboard).
Caller-supplied metadata. Free-form JSON, max 4 KB serialized and 50 keys.
Show child attributes
Show child attributes
ISO 8601 timestamp when the org was created.
ISO 8601 timestamp of the most recent state change.
curl --request POST \
--url https://api.nxos.io/v1/organizations \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"type": "BUSINESS",
"metadata": {}
}
'{
"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"
}