Skip to main content

Organizations API

The Organizations API allows you to retrieve your organization’s hierarchical structure. For holding companies with subsidiaries, this provides a complete tree view of all child organizations and their relationships.
New API: This endpoint is part of the new API architecture with improved design and maintainability.

Key Features

  • Organization Tree: View the complete hierarchical structure from the top-level holding down to all subsidiaries and child organizations
  • Automatic Root Detection: Always returns the full tree from the root organization, regardless of which organization the API key belongs to
  • Clean & Simple: Minimal response with just the essential fields (id, name, children)

Authentication

All endpoints require authentication using an API key included in the x-api-key header.

Headers

All requests must include:
string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Available Endpoints

Organization Tree

View the complete organizational hierarchy

Data Model

Organization Tree Node

Each node in the tree represents an organization:

Node Attributes

Use Cases

View Holding Structure

Retrieve the full organization tree for a holding company:

Find Specific Subsidiaries

Navigate the tree to find specific child organizations:

Error Handling

Common HTTP Status Codes

Error Response Format

Authentication Guide

Learn how to authenticate API requests

Vehicles API

Manage vehicles within organizations

Employees API

Manage employee commuting data

Invoices API

Manage invoices for organizations

MCP Tools

Explore organization structure from AI assistants via MCP

Rate Limiting

API requests are subject to rate limiting. Include rate limit information from response headers:
  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: Unix timestamp when limit resets