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

- Source: https://greenhired.com/developers/api/v1/jobs/
- Section: GreenHired developers · API · Public jobs API
- Last updated: 2026-11-21

## 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 https://api.greenhired.com/v1/jobs`** (permission `jobs: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*

```bash
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"
```

*JavaScript*

```javascript
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();
```

*Python*

```python
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](https://greenhired.com/developers/api/v1/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](https://greenhired.com/developers/api/v1/salaries/#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](https://greenhired.com/developers/api/v1/pagination/) |

> **Info:** There is no free-text `q` yet. It is refused with `400 unknown_parameter` instead of being ignored, so you can tell it is not supported. Use the filters.

## What a job looks like

The list cuts `description_text` at 600 characters. [Job detail](https://greenhired.com/developers/api/v1/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"
}
```

| Field | Notes |
| --- | --- |
| `id`, `slug` | The stable identifier and the address part of the job. Use the `slug` for [job detail](https://greenhired.com/developers/api/v1/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_cursor` back as `cursor` with the same filters until `has_more` is `false`. See [Pagination](https://greenhired.com/developers/api/v1/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](https://greenhired.com/developers/api/v1/attribution/).

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

## Related pages

- https://greenhired.com/developers/api/v1/job-detail/
- https://greenhired.com/developers/api/v1/pagination/
- https://greenhired.com/developers/api/v1/categories/
