API reference · Public jobs API

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.

3 min read Updated Maintained by the GreenHired team
View Markdown
On this page
  1. The request
  2. Filters
  3. What a job looks like
  4. Order and what is left out
  5. Frequently asked questions

#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.

GET/v1/jobsapi.greenhired.comjobs:read

Public jobs, newest first.

Example: remote and hybrid jobs in two categories, posted in the last 30 days, paying at least 60,000 EUR a year
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&currency=EUR&limit=10" \
  -H "Authorization: Bearer $GREENHIRED_API_KEY"

#Filters

List filters take a comma list (a,b) or a repeated parameter (a=1&a=2).

ParameterMeaning
categoryGreen category slugs, up to 28. The list is on Categories
countryCountry as written on the jobs, up to 5. Letter case does not matter, accents must match
work_moderemote, hybrid or onsite
employment_typeFor example full-time, part-time, contract, internship, freelance. Up to 8
seniorityFor example entry, mid, senior, lead, director, executive. Up to 8
companyA company slug: the company.slug of a job
posted_sinceA date (2026-11-01), a time (2026-11-01T08:00:00Z) or days back (7d, 30d; 1d to 3650d)
salary_minJobs whose stated pay reaches this per YEAR. Needs currency. See How salary figures are made
currencyAn ISO 4217 code such as EUR. With salary_min, or alone to keep only jobs that state pay in that currency
has_salarytrue for jobs that state pay, false for those that do not
limit, cursor1 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.

A job in the list
JSON
{
  "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"
}
FieldNotes
id, slugThe stable identifier and the address part of the job. Use the slug for job detail
companyname, slug and logo_url
locationcity, state, country and remote
work_moderemote, hybrid, onsite, or null when unknown
salarymin, max, currency and period exactly as the employer wrote them (not converted), or null when the job states no pay
posted_at, expires_atISO 8601 times in UTC
urlThe job's page on greenhired.com. Link to it when you show the job
source_typefirst_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_cursor back as cursor with the same filters until has_more is false. 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 q with 400 unknown_parameter on purpose. Filter by category instead, for example renewable-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.