List jobs
GET /v1/jobs returns GreenHired jobs newest first. Filter by category, country, work mode, type, seniority, company, date and pay, and page with a cursor.
On this page
#The request
GET /v1/jobs returns public GreenHired jobs, newest first, as a page of results. Every filter is optional and filters combine with AND. Unknown parameters are a 400, so a typo never silently returns the wrong jobs.
/v1/jobsapi.greenhired.comjobs:readPublic jobs, newest first.
curl -s "https://api.greenhired.com/v1/jobs?category=renewable-energy,green-finance&country=Germany&work_mode=remote,hybrid&posted_since=30d&salary_min=60000¤cy=EUR&limit=10" \
-H "Authorization: Bearer $GREENHIRED_API_KEY" const params = new URLSearchParams({
category: 'renewable-energy,green-finance',
country: 'Germany',
work_mode: 'remote,hybrid',
posted_since: '30d',
salary_min: '60000',
currency: 'EUR',
limit: '10',
});
const res = await fetch('https://api.greenhired.com/v1/jobs?' + params, {
headers: { Authorization: 'Bearer ' + process.env.GREENHIRED_API_KEY },
});
const { data, page } = await res.json(); import os, requests
res = requests.get(
"https://api.greenhired.com/v1/jobs",
params={
"category": "renewable-energy,green-finance",
"country": "Germany",
"work_mode": "remote,hybrid",
"posted_since": "30d",
"salary_min": 60000,
"currency": "EUR",
"limit": 10,
},
headers={"Authorization": "Bearer " + os.environ["GREENHIRED_API_KEY"]},
timeout=15,
)
body = res.json() #Filters
List filters take a comma list (a,b) or a repeated parameter (a=1&a=2).
| Parameter | Meaning |
|---|---|
category | Green category slugs, up to 28. The list is on Categories |
country | Country as written on the jobs, up to 5. Letter case does not matter, accents must match |
work_mode | remote, hybrid or onsite |
employment_type | For example full-time, part-time, contract, internship, freelance. Up to 8 |
seniority | For example entry, mid, senior, lead, director, executive. Up to 8 |
company | A company slug: the company.slug of a job |
posted_since | A date (2026-11-01), a time (2026-11-01T08:00:00Z) or days back (7d, 30d; 1d to 3650d) |
salary_min | Jobs whose stated pay reaches this per YEAR. Needs currency. See How salary figures are made |
currency | An ISO 4217 code such as EUR. With salary_min, or alone to keep only jobs that state pay in that currency |
has_salary | true for jobs that state pay, false for those that do not |
limit, cursor | 1 to 50 results (default 20), and the cursor of the next page. See Pagination |
#What a job looks like
The list cuts description_text at 600 characters. Job detail returns the whole description.
{
"id": "f3b1c2d4e5a6",
"slug": "wind-farm-site-engineer-bergen-f3b1",
"title": "Wind Farm Site Engineer",
"company": { "name": "Fjord Wind Partners", "slug": "fjord-wind-partners", "logo_url": "https://greenhired.com/files/logos/fjord.png" },
"location": { "city": "Bergen", "state": "Vestland", "country": "Norway", "remote": false },
"work_mode": "hybrid",
"employment_type": "full-time",
"seniority": "mid",
"green_category": "renewable-energy",
"salary": { "min": 62000, "max": 78000, "currency": "EUR", "period": "year" },
"posted_at": "2026-11-12T08:00:00.000Z",
"expires_at": "2026-12-31T00:00:00.000Z",
"description_text": "Join our site team to commission offshore wind turbines...",
"url": "https://greenhired.com/jobs/wind-farm-site-engineer-bergen-f3b1/",
"source_type": "first_party"
} | Field | Notes |
|---|---|
id, slug | The stable identifier and the address part of the job. Use the slug for job detail |
company | name, slug and logo_url |
location | city, state, country and remote |
work_mode | remote, hybrid, onsite, or null when unknown |
salary | min, max, currency and period exactly as the employer wrote them (not converted), or null when the job states no pay |
posted_at, expires_at | ISO 8601 times in UTC |
url | The job's page on greenhired.com. Link to it when you show the job |
source_type | first_party for a job posted on GreenHired |
#Order and what is left out
Jobs are newest first (posting time, then id). A job with no posting date is not in the list, though it still has its own address. Only live jobs are listed, and each job appears once even if it was posted in more than one place.
#Frequently asked questions
- How do I get all jobs, not just one page?
- Follow the cursor. Send
page.next_cursorback ascursorwith the same filters untilhas_moreisfalse. See Pagination. - Why is a job I can see on the site missing from the API?
- The API lists only jobs posted on GreenHired itself, live, one copy each. Jobs collected from partner feeds are not served until each source is cleared. See Attribution and source terms.
- Why did my request with q=solar fail?
- Free-text search is not in version 1. The API refuses
qwith400 unknown_parameteron purpose. Filter bycategoryinstead, for examplerenewable-energy. - How fresh is the list?
- New jobs appear when they are published on GreenHired, and the job list answers are marked
Cache-Control: private, max-age=0. Only the category counts (up to a minute old) and the salary statistics (up to five minutes old) are cached.
Was this page helpful?