List Resumes

GET /api/v1/resumes

Retrieve a paginated list of all resumes in your account.

Request

Headers

Header	Value	Required
Authorization	Bearer YOUR_API_KEY	REQUIRED

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination
limit	integer	20	Number of resumes per page (max: 100)

Response

Success Response

Status Code: 200 OK

{
  "resumes": [
    {
      "id": "64f1a2b3c4d5e6f7g8h9i0j1",
      "title": "Software Engineer Resume",
      "filename": "JohnDoeResume.pdf",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-20T14:45:00.000Z",
      "isCoverLetter": false
    },
    {
      "id": "64f1a2b3c4d5e6f7g8h9i0j2",
      "title": "Marketing Manager Resume",
      "filename": "JaneDoeResume.pdf",
      "createdAt": "2024-01-10T09:15:00.000Z",
      "updatedAt": "2024-01-18T11:20:00.000Z",
      "isCoverLetter": false
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "pages": 1
  }
}

Response Fields

Resume Object

Field	Type	Description
id	string	Unique identifier for the resume
title	string	Title of the resume
filename	string	Suggested filename for downloads
createdAt	string (ISO 8601)	When the resume was created
updatedAt	string (ISO 8601)	When the resume was last updated
isCoverLetter	boolean	Whether this is a cover letter

Pagination Object

Field	Type	Description
page	integer	Current page number
limit	integer	Number of items per page
total	integer	Total number of resumes
pages	integer	Total number of pages

Examples

Basic Request

cURL

curl https://api.enhancv.com/api/v1/resumes \
  -H "Authorization: Bearer enh_live_your_api_key_here"

JavaScript

const response = await fetch('https://api.enhancv.com/api/v1/resumes', {
  headers: {
    'Authorization': 'Bearer enh_live_your_api_key_here'
  }
});

const data = await response.json();
console.log(data.resumes);

Python

import requests

response = requests.get(
    'https://api.enhancv.com/api/v1/resumes',
    headers={'Authorization': 'Bearer enh_live_your_api_key_here'}
)

data = response.json()
print(data['resumes'])

With Pagination

cURL

curl "https://api.enhancv.com/api/v1/resumes?page=2&limit=10" \
  -H "Authorization: Bearer enh_live_your_api_key_here"

JavaScript

const response = await fetch(
  'https://api.enhancv.com/api/v1/resumes?page=2&limit=10',
  {
    headers: {
      'Authorization': 'Bearer enh_live_your_api_key_here'
    }
  }
);

const data = await response.json();

Error Responses

401 Unauthorized

Missing or invalid API key.

{
  "error": "Invalid API key",
  "status": 401
}

403 Forbidden

Account doesn't have business plan.

{
  "error": "API access requires a business plan",
  "status": 403
}

Notes

• Resumes are sorted by creation date (newest first)
• Maximum limit value is 100
• Minimum page value is 1
• Cover letters are included in the response with isCoverLetter: true