> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# The Org

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

![The Org logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/the_org.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=8d3ee6cd72f2dc9b98a80e2f4d073dc8)

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

## Tools

> [accordion] 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
>
> **limit** `integer`
>
> Prospective maximum rows for this page (1-1000, default 10, matching Search Positions); each returned row would cost 1 credit.
>
> **offset** `integer`
>
> Prospective result offset (0-10000).
>
> **filters** `object` *required*
>
> Position filters to use for the free cost estimate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string`
>
> 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`
>
> Person's LinkedIn profile URL. Provide at least one of linked\_in\_url or email; prefer one because sending both is unverified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Org Chart
>
> **Slug:** `THE_ORG_GET_ORG_CHART`
>
> Return a company's v1.2 org chart or board as a flat node list. A successful request costs 10 credits; metered REST requests can be replayed within 24 hours at no additional cost.
>
> #### Input Parameters
>
> **domain** `string`
>
> 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")`
>
> 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`
>
> LinkedIn company URL or slug. Provide at least one of linked\_in\_url or domain; prefer one because sending both is unverified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **to\_date** `string` *required*
>
> Inclusive end date in YYYY-MM-DD format; must not be before from\_date.
>
> **interval** `string ("daily" | "monthly")`
>
> Usage aggregation interval: daily or monthly.
>
> **from\_date** `string` *required*
>
> 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")` *required*
>
> API product to inspect. The accepted values are embed\_api, manager\_api, prospecting\_api, org\_chart\_api, and data\_api.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **limit** `integer`
>
> Maximum lists to return in this page (1-100).
>
> **offset** `integer`
>
> Result offset. Pass the previous response's next\_offset to continue.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **email** `string`
>
> Email address whose company should be identified. Provide at least one of query, domain, or email; prefer one identifier when possible.
>
> **limit** `integer`
>
> Maximum companies to return (1-50).
>
> **query** `string`
>
> Company name or free-text company query. Provide at least one of query, domain, or email; prefer one identifier when possible.
>
> **domain** `string`
>
> Company website or email domain. Provide at least one of query, domain, or email; prefer one identifier when possible.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Positions
>
> **Slug:** `THE_ORG_SEARCH_POSITIONS`
>
> Search people and positions using company, role, hierarchy, location, funding, and contact filters, returning one page with a next\_offset for continuation. Searches cost one credit per returned row, with repeat returns of the same row within 24 hours free.
>
> #### Input Parameters
>
> **limit** `integer`
>
> 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`
>
> Result offset (0-10000). For continuation, pass the previous response's next\_offset while keeping the same filters and limit.
>
> **filters** `object` *required*
>
> Position filters for this search.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
