---
title: "JobsPipe OpenAPI Specification - JSON and YAML"
description: "The machine-readable OpenAPI 3.1 spec for the JobsPipe API: job search, tech-stack scan, sandbox, webhooks and auth schemes, served as JSON and YAML."
canonical: https://jobspipe.dev/openapi
---

OpenAPI

# JobsPipe OpenAPI specification

The complete machine-readable description of the JobsPipe API as an OpenAPI 3.1 document, published at predictable URLs in JSON and YAML. Use it for code generation, request validation, and agent tool discovery, alongside the [JobsPipe API docs](https://docs.jobspipe.dev).

## [jobspipe.dev/openapi.json](https://jobspipe.dev/openapi.json)

The full JobsPipe OpenAPI 3.1 document as JSON - the format most code generators and agent tool loaders expect.

## [jobspipe.dev/openapi.yaml](https://jobspipe.dev/openapi.yaml)

The same specification as YAML, for humans and YAML-first tooling.

## What the spec covers

### POST /v1/jobs/search

Live job-posting search across 30+ ATS feeds and job boards with the full filter, pagination and job-schema contract.

### POST /v1/stack/scan

Website technology-stack detection for any company domain.

### /v1/sandbox/\*

The free no-key sandbox endpoints, including the batch and async-export patterns.

### Webhooks contract

The job.closed webhook payload and its HMAC-SHA256 X-JobsPipe-Signature verification header.

### Auth schemes

Bearer API-key auth (jp\_live\_ keys) plus the OpenID Connect scheme with jobs:read and stack:read scopes.

## Fetch it

Pull the spec straight into your generator or agent:

curl

Copy

$ curl https://jobspipe.dev/openapi.json

Every JobsPipe developer resource is indexed on the [developer resources hub](https://jobspipe.dev/developers), and the spec is also listed in the machine-readable [API catalog](https://jobspipe.dev/.well-known/api-catalog). Get a free API key (1,000 jobs to start) at [https://jobspipe.dev/signup](https://jobspipe.dev/signup).


---
Try it with no key: `curl -d '{"limit":3}' https://api.jobspipe.dev/v1/sandbox/jobs/search`. AI agents: the full machine-readable index of this site is https://jobspipe.dev/llms.txt?src=md-twin - API quickstart, MCP server, pricing. Free key (1,000 jobs to start): https://jobspipe.dev/signup