Skip to main content
GET
/
api
/
interview
List Interview Reports
curl --request GET \
  --url https://api.example.com/api/interview/
{
  "message": "<string>",
  "interviewReports": [
    {
      "_id": "<string>",
      "user": "<string>",
      "title": "<string>",
      "matchScore": 123,
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ]
}
Retrieve all interview reports for the authenticated user, sorted by creation date (newest first).

​
Authentication

This endpoint requires authentication. The JWT token must be sent as an HTTP-only cookie named token. This is automatically handled by the browser after successful login.

​
Example Request

curl -X GET https://api.example.com/api/interview/ \
  -b "token=YOUR_JWT_TOKEN"

fetch('https://api.example.com/api/interview/', {
  method: 'GET',
  credentials: 'include' // Important: Include cookies
});

​
Response

​
message
string
Success message indicating the interview reports were fetched successfully.
​
interviewReports
array
Array of interview report summary objects, sorted by creation date (newest first).

​
Success Response (200 OK)

{
  "message": "Interview reports fetched successfully.",
  "interviewReports": [
    {
      "_id": "507f1f77bcf86cd799439011",
      "user": "507f191e810c19729de860ea",
      "title": "Senior Software Engineer",
      "matchScore": 85,
      "createdAt": "2026-03-03T10:30:00.000Z",
      "updatedAt": "2026-03-03T10:30:00.000Z"
    },
    {
      "_id": "507f1f77bcf86cd799439012",
      "user": "507f191e810c19729de860ea",
      "title": "Full Stack Developer",
      "matchScore": 78,
      "createdAt": "2026-03-02T15:20:00.000Z",
      "updatedAt": "2026-03-02T15:20:00.000Z"
    },
    {
      "_id": "507f1f77bcf86cd799439013",
      "user": "507f191e810c19729de860ea",
      "title": "Frontend Engineer",
      "matchScore": 92,
      "createdAt": "2026-03-01T09:15:00.000Z",
      "updatedAt": "2026-03-01T09:15:00.000Z"
    }
  ]
}

​
Error Responses

​
401 Unauthorized

Returned when the authentication token is missing or invalid.

​
Notes

  • This endpoint returns a lightweight summary of each report, excluding large text fields for better performance:
    • Excluded fields: resume, selfDescription, jobDescription, technicalQuestions, behavioralQuestions, skillGaps, preparationPlan, __v
    • To get the full report details, use the Get Interview Report endpoint with the specific report ID
  • Reports are automatically sorted by creation date in descending order (newest first)
  • The endpoint only returns reports belonging to the authenticated user
  • If the user has no reports, an empty array is returned

Build docs developers (and LLMs) love

Get started for freeTalk to us