API Reference

Base URL for all endpoints:

https://api.laddro.com/v1

For an interactive API explorer, visit api.laddro.com/reference.

Endpoints Overview

Method	Endpoint	Description
`GET`	`/v1/resumes`	List your resumes
`GET`	`/v1/resumes/{resumeId}`	Get a specific resume
`POST`	`/v1/resumes/parse`	Parse a PDF/DOCX resume
`PUT`	`/v1/resumes/{resumeId}/render`	Render resume to PDF
`POST`	`/v1/tailor`	Tailor resume for a job (SSE)
`POST`	`/v1/export`	Export resume as PDF
`GET`	`/v1/cover-letters`	List cover letters
`GET`	`/v1/cover-letters/{coverLetterId}`	Get a cover letter
`POST`	`/v1/cover-letters`	Create a cover letter
`POST`	`/v1/cover-letters/generate`	Generate cover letter (SSE)
`PUT`	`/v1/cover-letters/{coverLetterId}/render`	Render cover letter to PDF
`GET`	`/v1/settings`	Get current AI settings
`PUT`	`/v1/settings/model`	Set AI model (BYOK)
`DELETE`	`/v1/settings/model`	Reset to default model

All responses return JSON with appropriate HTTP status codes:

{
  "data": { ... },
  "message": "Success"
}

{
  "error": "Not Found",
  "message": "Resume not found",
  "statusCode": 404
}

See Error Codes for a complete reference.

Request bodies: application/json (except file uploads which use multipart/form-data)
PDF responses: application/pdf
SSE streams: text/event-stream