> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talentunveiled.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Application CV Evaluation

> Retrieve the latest CV evaluation for a job application with criteria scores and evidence.



## OpenAPI

````yaml /swagger/v1_schema.yaml get /applications/{application_id}/cv-evaluation
openapi: 3.0.3
info:
  title: TalentUnveiled Public API
  version: 1.0.0
  description: API documentation for TalentUnveiled endpoints
servers:
  - url: https://api.talentunveiled.com/api/v1
    description: Production server
security: []
paths:
  /applications/{application_id}/cv-evaluation:
    get:
      tags:
        - TalentUnveiled Public API
      summary: Get Application CV Evaluation
      description: >-
        Retrieve the latest CV evaluation for a job application with criteria
        scores and evidence.
      operationId: applications_cv_evaluation_retrieve
      parameters:
        - in: path
          name: application_id
          schema:
            type: string
            format: uuid
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CVEvaluationDetail'
          description: ''
      security:
        - apiKeyAuth: []
        - {}
components:
  schemas:
    CVEvaluationDetail:
      type: object
      description: |-
        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
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        status:
          allOf:
            - $ref: '#/components/schemas/CVEvaluationStatusEnum'
          readOnly: true
          description: |-
            Evaluation processing status

            * `pending` - Pending
            * `completed` - Completed
            * `failed` - Failed
        overall_score:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
          readOnly: true
          nullable: true
          description: >-
            Aggregate score across all criteria on a 0 to 5 scale. Null until
            the evaluation completes.
        overall_score_explanation:
          type: string
          readOnly: true
          nullable: true
          description: Explanation of the overall score calculation
        tagline_summary:
          type: string
          readOnly: true
          nullable: true
          description: >-
            Concise one-line summary for quick overview (e.g., 'Strong technical
            fit with leadership gaps')
        summary:
          type: string
          readOnly: true
          nullable: true
          description: >-
            Comprehensive evaluation summary synthesizing all assessment data
            into hiring recommendation (2-4 paragraphs)
        strengths:
          type: array
          items:
            type: string
          readOnly: true
          nullable: true
          description: Key strengths identified in the CV (2-5 items)
        weaknesses:
          type: array
          items:
            type: string
          readOnly: true
          nullable: true
          description: Areas for improvement or skill gaps (2-5 items)
        red_flags:
          type: array
          items:
            type: string
          readOnly: true
          nullable: true
          description: Serious concerns or deal-breakers (0-3 items)
        evaluated_at:
          type: string
          format: date-time
          readOnly: true
        criteria_scores:
          type: array
          items:
            $ref: '#/components/schemas/CVCriteriaScore'
          readOnly: true
        error_display:
          nullable: true
          readOnly: true
      required:
        - criteria_scores
        - error_display
        - evaluated_at
        - id
        - overall_score
        - overall_score_explanation
        - red_flags
        - status
        - strengths
        - summary
        - tagline_summary
        - weaknesses
    CVEvaluationStatusEnum:
      enum:
        - pending
        - completed
        - failed
      type: string
      description: |-
        * `pending` - Pending
        * `completed` - Completed
        * `failed` - Failed
    CVCriteriaScore:
      type: object
      description: |-
        Serializer for individual CV criteria scores.

        Includes the score value, reasoning, and supporting evidence highlights.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        criteria_name:
          type: string
          nullable: true
          readOnly: true
        category:
          allOf:
            - $ref: '#/components/schemas/ScoreCriteriaCategoryEnum'
          nullable: true
          readOnly: true
        score_system:
          allOf:
            - $ref: '#/components/schemas/ScoreSystemEnum'
          nullable: true
          readOnly: true
        score:
          type: integer
          readOnly: true
          nullable: true
          description: >-
            Score for this criterion. The accepted range depends on the parent
            criterion's score_system: 0 or 1 when score_system=binary, 0 to 5
            when score_system=out_of_5, 0 to 100 when score_system=percentage.
            Null when the criterion was not assessed.
        weight:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
          readOnly: true
          description: >-
            Snapshot of criteria.weight at time of scoring (preserves historical
            calculation)
        weighted_score:
          type: number
          format: double
          nullable: true
          readOnly: true
        reasoning:
          type: string
          readOnly: true
        highlights:
          type: array
          items:
            $ref: '#/components/schemas/CVCriteriaScoreHighlight'
          readOnly: true
      required:
        - category
        - criteria_name
        - highlights
        - id
        - reasoning
        - score
        - score_system
        - weight
        - weighted_score
    ScoreCriteriaCategoryEnum:
      enum:
        - general
        - language_proficiency
        - soft_skills
        - technical_skills
        - communication_skills
        - custom
      type: string
      description: |-
        * `general` - General
        * `language_proficiency` - Language Proficiency
        * `soft_skills` - Soft Skills
        * `technical_skills` - Technical Skills
        * `communication_skills` - Communication Skills
        * `custom` - Custom
    ScoreSystemEnum:
      enum:
        - binary
        - percentage
        - out_of_5
      type: string
      description: |-
        * `binary` - Binary
        * `percentage` - Percentage
        * `out_of_5` - Out of 5
    CVCriteriaScoreHighlight:
      type: object
      description: |-
        Serializer for CV criteria score highlights (evidence quotes from CV).

        Highlights show specific evidence from the CV that supports the score,
        including the exact quote, sentiment, and location in the CV.
      properties:
        reason_summary:
          type: string
          readOnly: true
        reason_explanation:
          type: string
          readOnly: true
        highlight:
          type: string
          readOnly: true
        sentiment:
          allOf:
            - $ref: '#/components/schemas/SentimentEnum'
          readOnly: true
        paragraph_index:
          type: integer
          readOnly: true
          nullable: true
          description: >-
            Zero-based index of paragraph/item in CV where this evidence was
            found. Null when evidence is about something missing from the CV.
        cv_section:
          type: string
          readOnly: true
          nullable: true
          description: CV section name (e.g., 'Work Experience', 'Skills', 'Education')
      required:
        - cv_section
        - highlight
        - paragraph_index
        - reason_explanation
        - reason_summary
        - sentiment
    SentimentEnum:
      enum:
        - positive
        - negative
        - neutral
      type: string
      description: |-
        * `positive` - Positive
        * `negative` - Negative
        * `neutral` - Neutral
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: >-
        API key authentication for the public API. Pass your API key as a Bearer
        token.

````