---
canonical_url: "https://docs.composio.dev/toolkits/the_org"
markdown_url: "https://docs.composio.dev/toolkits/the_org.md"
product: "platform"
version: null
last_updated: null
---

# The Org

The Org provides company org charts, people and position search, manager lookup, lead lists, and account usage data.

- **Category:** sales & crm
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 8
- **Triggers:** 0
- **Slug:** `THE_ORG`
- **Version:** 00000000_00

## Tools

### Estimate Position Search Cost

**Slug:** `THE_ORG_ESTIMATE_POSITION_SEARCH_COST`

Estimate the credits required for one page of a position search without consuming credits. Use the same limit, offset, and filters with Search Positions if the estimate is acceptable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Prospective maximum rows for this page (1-1000, default 10, matching Search Positions); each returned row would cost 1 credit. |
| `offset` | integer | No | Prospective result offset (0-10000). |
| `filters` | object | Yes | Position filters to use for the free cost estimate. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Usage

**Slug:** `THE_ORG_GET_CURRENT_USAGE`

Return the connected account's current credit allowance, billing interval, reset date, additional credits, overages, and unlimited status.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Manager

**Slug:** `THE_ORG_GET_MANAGER`

WARNING: Each successful lookup costs 1 credit. Find a person's org-chart manager by work email or LinkedIn profile URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Person's work email. Provide at least one of email or linked_in_url; prefer one because sending both is unverified. |
| `linked_in_url` | string | No | Person's LinkedIn profile URL. Provide at least one of linked_in_url or email; prefer one because sending both is unverified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Org Chart

**Slug:** `THE_ORG_GET_ORG_CHART`

Return a company's current v1.2 org chart or board as a flat node list. A successful request costs 10 credits, although repeats for the same company within 24 hours are not charged again.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | No | Company website or email domain. Provide at least one of domain or linked_in_url; prefer one because sending both is unverified. |
| `section` | string ("orgChart" | "board") | No | Org-chart section to return. Use orgChart for the reporting hierarchy or board for board and advisor nodes; v1.2 does not support unplaced. |
| `linked_in_url` | string | No | LinkedIn company URL or slug. Provide at least one of linked_in_url or domain; prefer one because sending both is unverified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Usage History

**Slug:** `THE_ORG_GET_USAGE_HISTORY`

Return daily or monthly historical usage for one API product over an inclusive date range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to_date` | string | Yes | Inclusive end date in YYYY-MM-DD format; must not be before from_date. |
| `interval` | string ("daily" | "monthly") | No | Usage aggregation interval: daily or monthly. |
| `from_date` | string | Yes | Inclusive start date in YYYY-MM-DD format; must not be after to_date. |
| `api_product` | string ("embed_api" | "manager_api" | "prospecting_api" | "org_chart_api" | "data_api") | Yes | API product to inspect. The accepted values are embed_api, manager_api, prospecting_api, org_chart_api, and data_api. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List People Lists

**Slug:** `THE_ORG_LIST_PEOPLE_LISTS`

Return people and lead lists owned by or shared with the connected account, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum lists to return in this page (1-100). |
| `offset` | integer | No | Result offset. Pass the previous response's next_offset to continue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Companies

**Slug:** `THE_ORG_SEARCH_COMPANIES`

Find companies by name, domain, or email without consuming credits. Provide at least one search identifier; prefer one when possible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address whose company should be identified. Provide at least one of query, domain, or email; prefer one identifier when possible. |
| `limit` | integer | No | Maximum companies to return (1-50). |
| `query` | string | No | Company name or free-text company query. Provide at least one of query, domain, or email; prefer one identifier when possible. |
| `domain` | string | No | Company website or email domain. Provide at least one of query, domain, or email; prefer one identifier when possible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Positions

**Slug:** `THE_ORG_SEARCH_POSITIONS`

Search people and positions using company, role, hierarchy, location, funding, and contact filters. This request consumes 1 credit per returned row; call Estimate Position Search Cost first when cost matters. Returns one page only and a next_offset for controlled continuation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum rows to return and charge for in this page (1-1000, default 10). Each returned row costs 1 credit; prefer a small value and estimate first. |
| `offset` | integer | No | Result offset (0-10000). For continuation, pass the previous response's next_offset while keeping the same filters and limit. |
| `filters` | object | Yes | Position filters for this search. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |