Skip to main content
GET
/
applications
/
{application_id}
/
insights
Get Application Insights
curl --request GET \
  --url https://api.talentunveiled.com/api/v1/applications/{application_id}/insights \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "status": "pending",
  "error": "<unknown>",
  "data_sources": [
    "cv_evaluation"
  ],
  "cv_score": "<string>",
  "interview_score": "<string>",
  "overall_score": "<string>",
  "overall_score_explanation": "<string>",
  "hiring_recommendation": "strong_hire",
  "hiring_recommendation_explanation": "<string>",
  "strengths": [
    "<string>"
  ],
  "weaknesses": [
    "<string>"
  ],
  "risks": [
    "<string>"
  ],
  "tools_and_skills": [
    "<string>"
  ],
  "areas_for_development": [
    "<string>"
  ],
  "behavioural_observations": "<string>",
  "summary": "<string>",
  "tagline_summary": "<string>",
  "organization": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "candidate": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

API key authentication for public API. Format: {8_char_prefix}.{32_char_secret}

Path Parameters

​
application_id
string<uuid>
required

Response

200 - application/json

Serializer for JobApplicationInsights with synthesized CV and interview data.

​
id
string<uuid>
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
status
enum<string>
required

Processing status: pending, completed, or failed

  • pending - Pending
  • completed - Completed
  • failed - Failed
Available options:
pending,
completed,
failed
​
error
any | null
required

Error details if status=failed: {error_type, error_message, traceback, timestamp}

​
data_sources
enum<string>[]
required

Data sources used to generate insights (cv_evaluation, interview)

  • cv_evaluation - CV Evaluation
  • interview - Interview
Available options:
cv_evaluation,
interview
​
cv_score
string<decimal> | null
required

CV evaluation score (0-5)

Pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
​
interview_score
string<decimal> | null
required

Interview score (0-5)

Pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
​
overall_score
string<decimal> | null
required

Weighted overall score (0-5): 30% CV + 70% Interview

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

Explanation of how overall score was calculated

​
hiring_recommendation
enum<string>
required

AI-generated hiring recommendation based on score and risks

  • strong_hire - Strong Hire
  • hire - Hire
  • maybe - Maybe
  • no_hire - No Hire
Available options:
strong_hire,
hire,
maybe,
no_hire
​
hiring_recommendation_explanation
string | null
required

Short explanation for the hiring recommendation (1-2 sentences)

​
strengths
string[]
required

2-5 key strengths synthesized from CV and interview

​
weaknesses
string[]
required

2-5 key weaknesses and areas for improvement

​
risks
string[]
required

0-3 red flags or concerns

​
tools_and_skills
string[]
required

Technical skills, tools, and competencies identified

​
areas_for_development
string[]
required

2-5 growth areas framed constructively

​
behavioural_observations
string | null
required

Behavioural observations from interview

​
summary
string | null
required

1-2 paragraph executive summary

​
tagline_summary
string | null
required

One-line summary for quick candidate differentiation

Maximum string length: 255
​
organization
string<uuid>
required

Organization this record belongs to

​
candidate
string<uuid>
required