List Interviews | Gradii API Documentation

curl https://gradii.ai/api/v2/interviews/list \
     -H "Authorization: Bearer <token>"

{
  "success": true,
  "data": {
    "interviews": [
      {
        "interviewId": "interview_abc123_candidateId_1234567890",
        "databaseId": "db-id-123",
        "interview": {
          "type": "behavioral",
          "status": "scheduled",
          "scheduledAt": "2024-02-15T04:30:00.000Z",
          "roundOrder": 1,
          "interviewLink": "https://gradii.ai/interview/verify?email=john@example.com&interviewId=interview_abc123&type=behavioral",
          "linkExpiryTime": "2024-02-16T04:30:00.000Z",
          "timezone": "Asia/Kolkata",
          "candidateNotes": "Technical interview",
          "createdAt": "2024-01-28T10:00:00.000Z",
          "updatedAt": "2024-01-28T10:00:00.000Z"
        },
        "candidate": {
          "id": "cand_789",
          "name": "John Doe",
          "email": "john@example.com",
          "phone": "+11234567890",
          "location": "New York",
          "experience": "5 years",
          "currentCompany": "Tech Corp",
          "currentRole": "Software Engineer",
          "skills": [
            "JavaScript",
            "React",
            "Node.js"
          ],
          "resumeUrl": "https://storage/resume.pdf",
          "linkedinUrl": "https://linkedin.com/in/johndoe",
          "talentFitScore": 85,
          "status": "applied",
          "appliedAt": "2024-01-20T10:00:00.000Z"
        },
        "campaign": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "Senior Developer Hiring",
          "jobTitle": "Senior Software Engineer",
          "department": "Engineering",
          "location": "Remote"
        },
        "setup": {
          "roundName": "Technical Round",
          "roundNumber": 1,
          "interviewType": "behavioral",
          "timeLimit": 3600,
          "difficultyLevel": "medium"
        }
      }
    ],
    "summary": {
      "total": 1,
      "statusBreakdown": {
        "scheduled": 1
      },
      "completedInterviews": 0,
      "averageScore": 0,
      "filters": {
        "campaignId": "123e4567",
        "status": "scheduled",
        "search": "john"
      }
    }
  },
  "message": "Retrieved 1 interviews",
  "timestamp": "2024-01-28T10:00:00Z",
  "version": "2.0"
}

Get all interviews for your company with optional filters (no pagination - returns all)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

campaignIdstringOptionalformat: "uuid"

Filter by campaign ID

statusstringOptional

searchstringOptional

Search by candidate name, email, campaign name, or job title (max 100 chars)

Response

Interviews retrieved successfully

successboolean

dataobject

messagestring

timestampstring

versionstring