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

Authentication

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/registerCreate a new account and workspace.
POST/auth/loginExchange credentials for an access token.
POST/auth/refreshRefresh an expiring access token.
GET/auth/meReturn the current user and workspace.

Jobs

The roles you are tracking and their sources.

GET/jobsList jobs with filtering and pagination.
POST/jobsCreate a job.
GET/jobs/:idRetrieve a single job.
PATCH/jobs/:idUpdate a job.
DELETE/jobs/:idArchive a job.

Applications

Move applications through your pipeline stages.

GET/applicationsList applications in the workspace.
POST/applicationsCreate an application for a job.
PATCH/applications/:idUpdate stage, notes, or metadata.

Documents

CVs, cover letters, and ATS scoring.

GET/documentsList documents.
POST/documentsUpload or create a document.
POST/documents/ats-scoreScore a document against a job description.

Interviews & contacts

People and scheduled conversations.

GET/contactsList contacts.
POST/contactsCreate a contact.
GET/interviewsList scheduled interviews.
POST/interviewsSchedule an interview.

Automations

Rules that run follow-ups, reminders, and intake.

GET/automationsList automation rules.
POST/automationsCreate a rule.
PATCH/automations/:idEnable, disable, or edit a rule.

System

Health and platform metadata.

GET/system/statusReturn platform service status.

Looking for setup instructions instead? Start with the Documentation or visit the Help Center.