API Reference
API Reference
Build on the NewJob Guru REST API. Everything the web app does — jobs, applications, documents, and automations — is available over HTTP.
Base URL
All endpoints are served over HTTPS from a single host.
https://api.newjob.guruAuthentication
Obtain an access token from POST /auth/login and send it with every request in the Authorization header as a Bearer token.
Authorization: Bearer <access_token>Example request
curl https://api.newjob.guru/jobs \
-H "Authorization: Bearer $NEWJOB_TOKEN" \
-H "Content-Type: application/json"Example response
{
"data": [
{
"id": "6ac4d2e05ba40c10cec43e1b",
"title": "Senior Frontend Engineer",
"company": "Acme GmbH",
"stage": "applied",
"createdAt": "2026-06-01T09:24:00.000Z"
}
],
"meta": { "page": 1, "pageSize": 20, "total": 1 }
}Endpoints
Authentication
Create sessions and manage access tokens for a workspace.
| POST | /auth/register | Create a new account and workspace. |
| POST | /auth/login | Exchange credentials for an access token. |
| POST | /auth/refresh | Refresh an expiring access token. |
| GET | /auth/me | Return the current user and workspace. |
Jobs
The roles you are tracking and their sources.
| GET | /jobs | List jobs with filtering and pagination. |
| POST | /jobs | Create a job. |
| GET | /jobs/:id | Retrieve a single job. |
| PATCH | /jobs/:id | Update a job. |
| DELETE | /jobs/:id | Archive a job. |
Applications
Move applications through your pipeline stages.
| GET | /applications | List applications in the workspace. |
| POST | /applications | Create an application for a job. |
| PATCH | /applications/:id | Update stage, notes, or metadata. |
Documents
CVs, cover letters, and ATS scoring.
| GET | /documents | List documents. |
| POST | /documents | Upload or create a document. |
| POST | /documents/ats-score | Score a document against a job description. |
Interviews & contacts
People and scheduled conversations.
| GET | /contacts | List contacts. |
| POST | /contacts | Create a contact. |
| GET | /interviews | List scheduled interviews. |
| POST | /interviews | Schedule an interview. |
Automations
Rules that run follow-ups, reminders, and intake.
| GET | /automations | List automation rules. |
| POST | /automations | Create a rule. |
| PATCH | /automations/:id | Enable, disable, or edit a rule. |
System
Health and platform metadata.
| GET | /system/status | Return platform service status. |
Looking for setup instructions instead? Start with the Documentation or visit the Help Center.