Job API

The Job API lets you search open job postings with company, location, title, and hiring-company filters. Metering matches the Position API: one credit per returned row, with same-day replays of the same job free.

Find Jobs


POST https://api.theorg.com/v1.1/jobs

Parameter	Value
Url	https://api.theorg.com/v1.1/jobs
Method	`POST`
Body	Request body
Cost	One credit pr. returned row
Result sorting	Most relevant first

POST /v1.1/prospect/jobs is an alias for the same endpoint.

Request body

Parameter	Type	Description	Required
`limit`	integer	The maximum number of results to return (max: 1000)	`true`
`offset`	integer	The offset of the results (max: 10,000)	`true`
`filters`	object		`true`
`filters.jobIds`	array of strings	Internal job IDs (UUIDs)	`false`
`filters.companyIds`	array of strings	Company IDs (UUIDs)	`false`
`filters.companyDomains`	array	Hiring company domains	`false`
`filters.keywords`	array	Keywords matched against job title and company name	`false`
`filters.companyName`	array	Hiring company names	`false`
`filters.locations`	array	Job locations (country and optional state)	`false`
`filters.locations.country`	string	Two-letter country code (ISO 3166-1 alpha-2)	`true`
`filters.locations.state`	string	Either two letter code or plain text	`false`
`filters.companyLocations`	array	Hiring company HQ locations	`false`
`filters.companyRegions`	array of `europe`, `north_america`, `other`	Hiring company regions	`false`
`filters.employeeRanges`	array of EmployeeRange	Company size ranges	`false`
`filters.companyLegalStatuses`	array of LegalStatus	Legal statuses of hiring companies	`false`
`filters.latestFundingStages`	array of FundingStage	Latest funding stages	`false`
`filters.jobTitles`	array	Job titles and keywords	`false`
`filters.jobFunctions`	array of JobFunction	Job functions	`false`
`filters.jobTypes`	array of JobType	Employment types	`false`
`filters.orgChartLevels`	array	Org chart levels the role sits at	`false`
`filters.managerFullNames`	array	Full names or parts of names of the hiring managers	`false`
`filters.managerJobTitles`	array	Job titles of the hiring managers	`false`
`filters.industries`	array of Industry	Hiring company industries	`false`
`filters.allowsRemote`	boolean	Whether the job allows remote work	`false`

Example

Return remote engineering jobs at companies in North America:

Requesting remote engineering jobs


curl --location 'https://api.theorg.com/v1.1/jobs' \
--header 'X-Api-Key: **********************a02e' \
--header 'Content-Type: application/json' \
--data '{
    "limit": 1,
    "offset": 0,
    "filters": {
        "jobFunctions": ["engineering"],
        "allowsRemote": true,
        "companyRegions": ["north_america"]
    }
}'

Show response


{
    "data": {
        "items": [
            {
                "id": "6e2407a1-7a26-443e-8762-1cde48daf8a9",
                "slug": "senior-software-engineer",
                "title": "Senior Software Engineer",
                "teaser": "Build product used by millions of professionals.",
                "remote": true,
                "jobType": "full_time",
                "jobFunction": "engineering",
                "orgChartLevel": "level_three",
                "location": {
                    "country": "US",
                    "state": "CA"
                },
                "createdOn": "2026-08-01T12:00:00.000",
                "deadline": null,
                "url": "https://theorg.com/org/the-org/jobs/senior-software-engineer",
                "associatedPositionId": 47185,
                "managers": [
                    {
                        "fullName": "Andreas Jarbol",
                        "roleTitle": "CTO & co-Founder"
                    }
                ],
                "company": {
                    "id": "5a8fbc82-c357-11e7-abc4-cec278b6b50a",
                    "slug": "the-org",
                    "name": "The Org",
                    "logoUrl": "https://cdb.theorg.com/1243da72-2ea0-4425-bc87-febd505d1528.jpg",
                    "legalStatus": "company",
                    "industries": ["professional_networking"],
                    "employeeRange": "50-200",
                    "latestFundingStage": "series_a",
                    "url": "https://theorg.com/org/the-org",
                    "embedUrl": "https://theorg.com/embeds/org-chart/..."
                }
            }
        ],
        "totalCreditsUsed": 1,
        "totalResults": 86
    }
}

Credit Check Utility

The job finding endpoint deducts one credit pr. row returned. Use this endpoint to estimate the cost of a search without charging credits.


POST https://api.theorg.com/v1.1/jobs/credit-usage

Parameter	Value
Url	https://api.theorg.com/v1.1/jobs/credit-usage
Method	`POST`
Body	Request body
Cost	Free

POST /v1.1/prospect/jobs/credit-usage is an alias for the same endpoint.

Example

Estimating credit cost for remote engineering jobs


curl --location 'https://api.theorg.com/v1.1/jobs/credit-usage' \
--header 'X-Api-Key: **********************a02e' \
--header 'Content-Type: application/json' \
--data '{
    "limit": 1000,
    "offset": 0,
    "filters": {
        "jobFunctions": ["engineering"],
        "allowsRemote": true,
        "companyRegions": ["north_america"]
    }
}'

Show response


{
    "data": {
        "creditCost": 86,
        "remainingCredits": 100
    }
}

💡

A specific row can be returned multiple times at no additional cost within 24 hours of the initial return.