REST API

Build on your org data with a production-grade REST API

11 endpoints for employees, departments, hierarchy, and search. JSON responses, cursor pagination, 60 req/min rate limits, plus built-in AI assistant integration so your team can query org data from ChatGPT, Claude, Gemini, or Copilot.

bash

$ curl -H "Authorization: Bearer cp_..." \
  https://chartpull.com/api/v1/employees/search?q=sarah

Endpoints

11 endpoints for everything org

Employees, departments, hierarchy, search, and bulk operations.

GET/api/v1/employees

Paginated list of all employees with optional department filter.

GET/api/v1/employees/search

Multi-field search across name, title, department, location, and manager.

POST/api/v1/employees/bulk

Batch lookup for up to 100 email addresses in a single request.

GET/api/v1/employees/:id

Single employee details. Optional ?include=descendants for full subtree.

GET/api/v1/employees/:id/manager-chain

Ordered management chain from the employee up to the CEO.

GET/api/v1/employees/:id/direct-reports

Paginated list of all direct reports for a manager.

GET/api/v1/departments

All departments with headcounts and optional tree structure.

GET/api/v1/org-tree

Full hierarchical tree of the entire organisation.

Example

Request and response

Simple Bearer auth. JSON everywhere. Predictable pagination.

Request

curl -H "Authorization: Bearer cp_live_a1b2c3..." \
  https://chartpull.com/api/v1/employees/search?q=sarah

Response · 200 OK

{
  "data": [
    {
      "name": "Sarah Chen",
      "title": "VP Engineering",
      "department": "Engineering",
      "email": "sarah@company.com"
    }
  ],
  "pagination": {
    "total": 1
  }
}

Build With It

What you can build

From internal tools to enterprise integrations, the API is your foundation.

Internal people search portal

Build a custom employee directory UI powered by real-time org data.

Manager reports for the board

Generate span-of-control and headcount reports automatically.

ITSM access provisioning

Sync org structure to ServiceNow or Jira for role-based access control.

BI dashboard headcounts

Feed department headcount and hierarchy data into Looker, Tableau, or Power BI.

CRM contact enrichment

Bulk-enrich Salesforce or HubSpot contacts with org titles and departments.

AI assistant org queries

Connect ChatGPT, Claude, Gemini, Copilot, or any AI assistant to your org chart. Ask "Who reports to Sarah?" or "How big is the engineering team?" in plain English.

Technical

Built for production

Secure, rate-limited, and paginated. Everything you need for a reliable integration.

Bearer token auth

API keys are generated in the admin panel. Pass as Authorization: Bearer cp_...

60 requests per minute

Rate-limited per API key. Headers include X-RateLimit-Remaining.

Cursor pagination

All list endpoints support cursor-based pagination with ?limit and ?cursor.

HTTPS only

All API traffic is encrypted. HTTP requests are rejected with 301.

Full interactive documentation

Explore all 11 endpoints with request/response examples, parameter descriptions, and a live API playground powered by Scalar.

Open API Docs

AI Assistant Integration

Integrations Add-on

Let your team ask AI assistants questions about your org chart in plain English — who reports to whom, department headcounts, management chains, and more. Works with ChatGPT, Claude, Google Gemini, Microsoft Copilot, and any tool that supports the open MCP standard. Uses your existing API keys — your IT team can set it up in minutes.

Endpoint: /api/mcp

Get API access

Generate API keys from the admin panel and start building in minutes.

API access requires the Integrations add-on.

Get Started View API Docs