GET /jobs/:id — retrieve a single job by ID

The GET /jobs/:id endpoint fetches a single job listing by its UUID. When the ID is found in the store, the complete job object is returned — including all structured data and content fields. When no match exists, the API responds with a 404 status.

GET /jobs/:id

Path Parameters

string

required

The UUID of the job listing to retrieve. UUIDs are assigned automatically when a job is created and never change.

Response Fields

string

Unique UUID identifier for the job listing.

titulo

string

Job title.

empresa

string

Company offering the position.

ubicacion

string

Job location or remote designation.

descripcion

string

Short summary description of the role.

data

object

Structured metadata about the job.

Show data fields

technology

string[]

List of technology tags associated with the role (e.g. ["react", "typescript"]).

modalidad

string

Work modality — e.g. remoto, presencial, híbrido.

nivel

string

Experience level — e.g. junior, mid, senior.

content

object

Long-form structured content for the job listing.

Show content fields

description

string

Full job description.

responsibilities

string

Key responsibilities for the role.

requirements

string

Required skills and qualifications.

about

string

Information about the company.

Example

curl http://localhost:1234/jobs/7a4d1d8b-1e45-4d8c-9f1a-8c2f9a9121a4

{
  "id": "7a4d1d8b-1e45-4d8c-9f1a-8c2f9a9121a4",
  "titulo": "Desarrollador de Software Senior",
  "empresa": "Tech Solutions Inc.",
  "ubicacion": "Buenos Aires, Argentina",
  "descripcion": "Buscamos un desarrollador senior con experiencia en arquitecturas modernas.",
  "data": {
    "technology": ["node", "typescript", "postgresql"],
    "modalidad": "híbrido",
    "nivel": "senior"
  },
  "content": {
    "description": "Serás responsable de diseñar y mantener servicios backend escalables...",
    "responsibilities": "Diseñar APIs REST, revisar código del equipo, colaborar con producto...",
    "requirements": "5+ años de experiencia, dominio de TypeScript y SQL...",
    "about": "Tech Solutions Inc. es una empresa de tecnología con más de 10 años en el mercado..."
  }
}

404 Response

Returned when no job with the given ID exists in the store.

{ "error": "job Not Found" }

Jobs API

AI API

GET /jobs/:id — retrieve a single job by ID

Path Parameters

Response Fields

Example

404 Response

Build docs developers (and LLMs) love

Jobs API

AI API

Documentation Index

​Path Parameters

​Response Fields

​Example

​404 Response

Build docs developers (and LLMs) love

Path Parameters

Response Fields

Example

404 Response