Developers

Build with GreenHired

Read green jobs and salary data, manage your own account and your company's jobs, or connect an AI assistant. Two REST APIs and one MCP server, all JSON over HTTPS, all documented here.

Pick your path

Each one has its own key or sign-in, and its own limits. Start with the one that matches what you want to do.

Job seekers and employers

Make your own key. Seekers read their profile, applications and saved jobs. Employers read their company and create, publish and close jobs from their own systems.

RESTghpk_ keymake it yourself

Your first request

Every call is an HTTPS request with a bearer key. This one checks that your key works and shows its permissions and limits.

  1. Get a key: request one for the public jobs API, or make a personal key in your account.
  2. Keep it in an environment variable, and call from your server.
  3. Pick a language once: every sample on these pages follows your choice.
Check your key (a public API key, from your server)
curl -s https://api.greenhired.com/v1/ping \
  -H "Authorization: Bearer $GREENHIRED_API_KEY"

Where most people go next.

What is available

Three services, each at its own address. All are version 1, which only grows: nothing is removed or renamed.

ServiceAddressHow you get inStatus
Public jobs APIhttps://api.greenhired.com/v1An API key, issued on request by the GreenHired teamLive
Account APIhttps://api.greenhired.com/v1/assistantA personal key you make yourself. Employers also need the company owner to allow job changesLive
MCP serverhttps://mcp.greenhired.com/mcpSign in with GreenHired, or an API key for the job search toolsLive

Last updated . Every page can be copied as Markdown, for your notes or for an AI assistant.

Questions we get

Which one should I start with?
To show jobs in your own app, start with the public jobs API. To work with your own profile or your company's jobs, make a personal key. To use GreenHired from Claude, ChatGPT or Cursor, connect the MCP server.
Do I need an API key?
The public jobs API needs a ghk_ key, which the GreenHired team issues on request. For your own account you make a ghpk_ personal key yourself. To connect an AI assistant you do not need a key: you sign in with GreenHired.
Can I call the APIs from a web page?
Do not. A key in browser code can be read by every visitor. Call the API from your server and give visitors your own pages or endpoint.
Where do I report a problem or ask for something?
Use the feedback buttons on any page, or write to partners@greenhired.com for keys and integrations, and support@greenhired.com for anything else.