Skip to main content
GET
/
applications
/
{application_id}
/
cv-evaluation
Get Application CV Evaluation
curl --request GET \
  --url https://api.talentunveiled.com/api/v1/applications/{application_id}/cv-evaluation \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "overall_score": "<string>",
  "overall_score_explanation": "<string>",
  "tagline_summary": "<string>",
  "summary": "<string>",
  "strengths": [
    "<string>"
  ],
  "weaknesses": [
    "<string>"
  ],
  "red_flags": [
    "<string>"
  ],
  "evaluated_at": "2023-11-07T05:31:56Z",
  "criteria_scores": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "criteria_name": "<string>",
      "category": "<string>",
      "score": 123,
      "weight": "<string>",
      "weighted_score": 123,
      "reasoning": "<string>",
      "highlights": [
        {
          "reason_summary": "<string>",
          "reason_explanation": "<string>",
          "highlight": "<string>",
          "paragraph_index": 123,
          "cv_section": "<string>"
        }
      ]
    }
  ],
  "error_display": null
}

Authorizations

​
Authorization
string
header
required

API key authentication for public API, validated against WorkOS.

Path Parameters

​
application_id
string<uuid>
required

Response

200 - application/json

Detailed serializer for CV evaluation with complete nested data.

Returns:

  • Overall evaluation results (score, summary, tagline)
  • Strengths, weaknesses, and red flags
  • Individual criteria scores with evidence highlights
  • Error details if evaluation failed
​
id
string<uuid>
required
read-only
​
status
enum<string>
required

Evaluation processing status

  • pending - Pending
  • completed - Completed
  • failed - Failed
Available options:
pending,
completed,
failed
​
overall_score
string<decimal> | null
required
read-only

Aggregate score across all criteria (0-5 scale)

Pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
​
overall_score_explanation
string | null
required
read-only

Explanation of the overall score calculation

​
tagline_summary
string | null
required
read-only

Concise one-line summary for quick overview (e.g., 'Strong technical fit with leadership gaps')

​
summary
string | null
required
read-only

Comprehensive evaluation summary synthesizing all assessment data into hiring recommendation (2-4 paragraphs)

​
strengths
string[] | null
required
read-only

Key strengths identified in the CV (2-5 items)

​
weaknesses
string[] | null
required
read-only

Areas for improvement or skill gaps (2-5 items)

​
red_flags
string[] | null
required
read-only

Serious concerns or deal-breakers (0-3 items)

​
evaluated_at
string<date-time>
required
read-only
​
criteria_scores
object[]
required
read-only
​
error_display
unknown
required