Resumes

Manage resumes — list, retrieve, parse from files, and render to PDF.

List Resumes


GET /v1/resumes

Returns all resumes belonging to the authenticated user.

Request


curl https://api.laddro.com/v1/resumes \
  -H "x-api-key: YOUR_API_KEY"

Response


{
  "data": [
    {
      "id": "res_abc123",
      "title": "Software Engineer Resume",
      "createdAt": "2026-05-01T10:00:00Z",
      "updatedAt": "2026-05-02T15:30:00Z"
    }
  ]
}

Get Resume


GET /v1/resumes/{resumeId}

Returns the full resume data including all sections.

Parameters

Parameter	Type	Location	Description
`resumeId`	string	path	Resume ID

Request


curl https://api.laddro.com/v1/resumes/res_abc123 \
  -H "x-api-key: YOUR_API_KEY"

Response


{
  "data": {
    "id": "res_abc123",
    "title": "Software Engineer Resume",
    "sections": {
      "header": {
        "name": "Jane Smith",
        "email": "[email protected]",
        "phone": "+49 170 1234567",
        "location": "Berlin, Germany"
      },
      "summary": "Experienced software engineer...",
      "experience": [...],
      "education": [...],
      "skills": [...],
      "languages": [...]
    }
  }
}

Errors

Status	Description
`401`	Missing or invalid API key
`404`	Resume not found

Parse Resume


POST /v1/resumes/parse

Upload a PDF or DOCX file to extract structured resume data. The file is parsed using AI to identify sections, dates, and content.

Request


curl https://api.laddro.com/v1/resumes/parse \
  -H "x-api-key: YOUR_API_KEY" \
  -F "[email protected]"

Parameters

Parameter	Type	Location	Description
`file`	file	form-data	PDF or DOCX file (max 10MB)

Response


{
  "data": {
    "id": "res_def456",
    "title": "Parsed Resume",
    "sections": {
      "header": { ... },
      "summary": "...",
      "experience": [...],
      "education": [...],
      "skills": [...]
    }
  }
}

Errors

Status	Description
`400`	Invalid file format (only PDF/DOCX)
`401`	Missing or invalid API key
`402`	No credits remaining
`413`	File too large (max 10MB)

Render Resume to PDF


PUT /v1/resumes/{resumeId}/render

Renders a resume using the specified template and returns a PDF file.

Parameters

Parameter	Type	Location	Description
`resumeId`	string	path	Resume ID
`templateId`	string	body	Template to use (e.g., `graphite`)
`fontId`	string	body	Font to use (optional)

Request


curl https://api.laddro.com/v1/resumes/res_abc123/render \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "templateId": "graphite" }' \
  --output resume.pdf

Response

Returns application/pdf binary data.

Errors

Status	Description
`401`	Missing or invalid API key
`402`	No credits remaining
`404`	Resume or template not found