Company API

Find Org Chart

Returns the full org chart for the company in a flat list as ChartNodes.


GET https://api.theorg.com/v1.2/companies/org-chart

Parameter	Value
Url	https://api.theorg.com/v1.2/companies/org-chart
Method	`GET`
Parameters	Query parameters
Cost	10 credits pr. successful request

The endpoint does not support the unplaced section. Node objects in the response do not include linkedinUrl or workEmail.

Parameters

Parameter	Type	Description	Required
`linkedInUrl`	query	LinkedIn company URL or slug	`false`
`domain`	query	Company website or email domain	`false`
`section`	query	Section to filter by: `orgChart` or `board`. Defaults to `orgChart`.	`false`

💡

Nodes can be enriched by their id using the Position API. Use the node id (e.g. p-47185) to fetch full position details including contact information such as linkedinUrl and workEmail.

Example

Find org chart for The Org


curl --location 'https://api.theorg.com/v1.2/companies/org-chart?domain=theorg.com' \
--header 'X-Api-Key: **********************a02e'

Show response


{
    "data": [
        {
            "id": "p-12287726",
            "jobId": "6e2407a1-7a26-443e-8762-1cde48daf8a9",
            "jobTitle": "Tell Us Your Dream Job",
            "managerId": "p-47185",
            "nodeType": "job",
            "section": "orgChart"
        },
        {
            "id": "p-47185",
            "positionId": 47185,
            "fullName": "Christian Wylonis",
            "title": "CEO & co-Founder",
            "managerId": null,
            "nodeType": "position",
            "section": "orgChart"
        },
        {
            "id": "p-2",
            "positionId": 2,
            "fullName": "Andreas Jarbol",
            "title": "CTO & co-Founder",
            "managerId": "p-47185",
            "nodeType": "position",
            "section": "orgChart"
        }
    ]
}

Find Manager

Returns the manager of a position in the org chart.


GET https://api.theorg.com/v1.1/companies/org-chart/managers

Parameter	Value
Url	https://api.theorg.com/v1.1/companies/org-chart/managers
Method	`GET`
Parameters	Query parameters
Cost	1 credit per successful find

Parameters

Parameter	Type	Description	Required
`email`	query	Email address of the person	`false`
`linkedInUrl`	query	LinkedIn profile URL	`false`

Examples

Find the manager of Andreas at The Org


curl --location 'https://api.theorg.com/v1.1/companies/org-chart/managers?email=andreas@theorg.com' \
--header 'X-Api-Key: **********************a02e'

Show response


{
    "data": {
        "position": {
            "id": "p-2",
            "positionId": 2,
            "fullName": "Andreas Jarbol",
            "title": "CTO & co-Founder",
            "linkedInUrl": "https://linkedin.com/in/ajarbol",
            "workEmail": "andreas@theorg.com",
            "nodeType": "position",
            "section": "orgChart"
        },
        "manager": {
            "id": "p-47185",
            "positionId": 47185,
            "fullName": "Christian Wylonis",
            "title": "CEO & co-Founder",
            "linkedInUrl": "https://linkedin.com/in/christianwylonis/",
            "workEmail": "christian@theorg.com",
            "nodeType": "position",
            "section": "orgChart"
        }
    }
}

Find the manager of David Hyman the CLO at Netflix


curl --location 'https://api.theorg.com/v1.1/companies/org-chart/managers?email=dhyman@netflix.com' \
--header 'X-Api-Key: **********************a02e'

Show response


{
    "data": {
        "position": {
            "id": "p-4446",
            "positionId": 4446,
            "fullName": "David Hyman",
            "title": "Chief Legal Officer",
            "workEmail": "dhyman@netflix.com",
            "linkedInUrl": "https://www.linkedin.com/in/dhymansf/",
            "nodeType": "position",
            "section": "orgChart"
        },
        "manager": {
            "id": "g-12403",
            "name": "Co-CEOs",
            "members": [
                {
                    "id": "p-4448",
                    "positionId": 4448,
                    "fullName": "Ted Sarandos",
                    "title": "Co-CEO",
                    "workEmail": "tsarandos@netflix.com",
                    "linkedInUrl": "https://www.linkedin.com/in/tedsarandos",
                    "nodeType": "position",
                    "section": "orgChart"
                },
                {
                    "id": "p-4448",
                    "positionId": 4448,
                    "fullName": "Greg Peters",
                    "title": "Co-CEO",
                    "workEmail": "gpeters@netflix.com",
                    "linkedInUrl": "https://linkedin.com/in/petersgreg",
                    "nodeType": "position",
                    "section": "orgChart"
                }
            ],
            "nodeType": "coManager"
        }
    }
}