Skip to main content
An organization is a tenant on the Apocor platform. Every resource — applicants, programs, cards, billing — belongs to exactly one organization, and your token is always scoped to the org (or orgs) it can access.

​
Types

TypeDescription
DIRECTA standard tenant that Apocor onboards directly
RESELLERA partner that onboards and manages its own child tenants
MANAGEDA tenant managed on behalf of a reseller

​
Hierarchy

A RESELLER_ADMIN can read and manage its own org plus every child org beneath it. A DIRECT tenant only ever sees itself.

​
Onboarding a tenant

Platform and reseller admins onboard tenants with POST /v1/organizations/onboard. This creates the org, provisions an invited admin user, and emails an onboarding link.
cURL
curl -s -X POST 'https://sandbox.apocor.ai/v1/organizations/onboard' \
  -H 'Authorization: Bearer YOUR_TOKEN' -H 'Content-Type: application/json' \
  -d '{
    "name": "Acme Inc",
    "type": "DIRECT",
    "admin_name": "Alice Admin",
    "admin_email": "[email protected]"
  }'
The invited admin completes identity verification and sets a password through the public onboarding flow before their account activates.

​
The current session

Call GET /v1/me to see which org and role the active token represents: 
{
  "data": {
    "orgId": "org_abc123",
    "role": "ORG_ADMIN",
    "accessibleOrgIds": ["org_abc123"],
    "organization": { "id": "org_abc123", "name": "Acme Inc", "type": "DIRECT", "status": "ACTIVE" }
  }
}