Skip to main content

​
Get All Resumes

Retrieves a paginated list of all resumes uploaded by the authenticated user, including metadata, analysis scores, and associated interview counts.

​
Endpoint

GET /api/resumes

​
Authentication

This endpoint requires authentication. Include your authentication token in the request headers.

​
Rate Limiting

This endpoint has no specific rate limits but follows global API rate limiting policies.

​
Request

No request body or query parameters required.

​
Response

​
code
integer
Status code. 200 indicates success.
​
message
string
Response message
​
data
array
Array of resume list items

​
Examples

curl -X GET https://api.example.com/api/resumes \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response Example

​
Success Response

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 12345,
      "filename": "john_doe_resume.pdf",
      "fileSize": 245680,
      "uploadedAt": "2026-03-10T14:30:00",
      "accessCount": 5,
      "latestScore": 85,
      "lastAnalyzedAt": "2026-03-10T14:31:25",
      "interviewCount": 2
    },
    {
      "id": 12344,
      "filename": "jane_smith_cv.docx",
      "fileSize": 189234,
      "uploadedAt": "2026-03-08T10:15:00",
      "accessCount": 3,
      "latestScore": 92,
      "lastAnalyzedAt": "2026-03-08T10:16:18",
      "interviewCount": 1
    },
    {
      "id": 12343,
      "filename": "resume_draft.pdf",
      "fileSize": 156789,
      "uploadedAt": "2026-03-05T16:45:00",
      "accessCount": 1,
      "latestScore": null,
      "lastAnalyzedAt": null,
      "interviewCount": 0
    }
  ]
}

​
Response Fields Explained

The latestScore represents the overall quality score (0-100) from the most recent AI analysis:
  • 90-100: Exceptional resume
  • 80-89: Excellent resume
  • 70-79: Good resume with minor improvements needed
  • 60-69: Average resume, several areas for improvement
  • Below 60: Needs significant revision
  • null: Analysis not yet completed or failed
Shows how many mock interview sessions have been created using this resume. Higher counts indicate:
  • The resume is being actively used for interview preparation
  • Multiple practice sessions have been conducted
  • Can help track which resumes are most relevant for current job search
Tracks the number of times the resume has been accessed via detail view or export operations. Useful for:
  • Identifying frequently referenced resumes
  • Understanding user engagement with uploaded resumes
  • Analytics and usage tracking

​
Error Responses

​
Error Codes
object

​
Error Response Example

{
  "code": 401,
  "message": "未授权",
  "data": null
}

​
Use Cases

  1. Dashboard Display: Show all user resumes in a table or card layout
  2. Resume Selection: Let users select a resume for creating an interview session
  3. Progress Tracking: Display analysis status and scores across all resumes
  4. Activity Monitoring: Track which resumes are most accessed or used for interviews

​
Implementation Tips

Sorting: Resumes are returned in reverse chronological order by upload date (newest first).
Filtering: Implement client-side filtering by score range, analysis status, or interview count for better UX.
Performance: For users with many resumes (>100), consider implementing pagination on the client side or requesting server-side pagination support.

Build docs developers (and LLMs) love

Get started for freeTalk to us