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
cursor	string	-	Cursor 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"
    },
    {
      "id": "64f1a2b3c4d5e6f7g8h9i0j2",
      "title": "Marketing Manager Resume",
      "filename": "JaneDoeResume.pdf",
      "createdAt": "2024-01-10T09:15:00.000Z",
      "updatedAt": "2024-01-18T11:20:00.000Z"
    }
  ],
  "pagination": {
    "cursor": "64f1a2b3c4d5e6f7g8h9i0j2",
    "limit": 20
  }
}

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

Pagination Object

Field	Type	Description
cursor	string | null	Next cursor for pagination, null if no more results
limit	integer	Number of items per page

Examples

Basic Request

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

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);

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 Cursor Pagination

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

const response = await fetch(
  'https://api.enhancv.com/api/v1/resumes?cursor=64f1a2b3c4d5e6f7g8h9i0j2&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 ID (oldest first, newest last)
• Use cursor-based pagination for efficient navigation through large datasets
• Pass the cursor value from the previous response to get the next page
• Maximum limit value is 100