API Documentation

Integrate trust-scored hiring into your platform with the TIERHIRES REST API.

Overview

Base URL: https://your-domain.com/api
Authentication: Cookie-based session auth via Supabase. Include credentials in requests.
Rate Limits: API access is available on Business and Enterprise plans.

Response Format

All responses follow a consistent JSON format:

// Success
{
  "data": { ... },
  "count": 42,
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3
  },
  "timestamp": "2026-02-02T12:00:00.000Z"
}

// Error
{
  "error": "Description of what went wrong",
  "code": "ERROR_CODE"
}

Endpoints

GET/api/jobs

List jobs with trust scores. Supports search, filtering, and pagination.

searchlocationemployment_typepagelimitsortorder
Public
GET/api/jobs/:id

Job detail with full trust breakdown including org trust, JD legitimacy, and posting behavior.

Public
POST/api/jobs

Ingest jobs from aggregators. Accepts a source identifier and array of job payloads.

Required
GET/api/employers

List verified employers. Supports search and pagination.

searchpagelimit
Public
GET/api/employers/:id

Employer detail with trust profile, job count, and recruiter list.

Public
POST/api/employers

Register a new employer organization.

Required
GET/api/candidates

Get authenticated candidate profile.

Required (own data)
POST/api/candidates

Create or update candidate profile.

Required
GET/api/candidates/:id/score

Candidate trust score with verification receipts and claims.

Required (own data)
GET/api/applications

List applications for authenticated candidate with job details.

Required
POST/api/applications

Submit a job application. Prevents duplicate applications.

Required
POST/api/verification

Webhook endpoint for third-party verification providers.

Webhook signature

API access is available on Business and Enterprise plans.

View Pricing