> ## 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 Insights

> Retrieve AI-generated insights for a job application including scores, recommendation, and analysis.



## OpenAPI

````yaml /swagger/v1_schema.yaml get /applications/{application_id}/insights
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}/insights:
    get:
      tags:
        - TalentUnveiled Public API
      summary: Get Application Insights
      description: >-
        Retrieve AI-generated insights for a job application including scores,
        recommendation, and analysis.
      operationId: applications_insights_retrieve
      parameters:
        - in: path
          name: application_id
          schema:
            type: string
            format: uuid
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobApplicationInsights'
          description: ''
      security:
        - apiKeyAuth: []
        - {}
components:
  schemas:
    JobApplicationInsights:
      type: object
      description: >-
        Serializer for JobApplicationInsights with synthesized CV and interview
        data.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
        status:
          allOf:
            - $ref: '#/components/schemas/CVEvaluationStatusEnum'
          readOnly: true
          description: |-
            Processing status: pending, completed, or failed

            * `pending` - Pending
            * `completed` - Completed
            * `failed` - Failed
        error:
          readOnly: true
          nullable: true
          description: >-
            Error details if status=failed: {error_type, error_message,
            traceback, timestamp}
        data_sources:
          type: array
          items:
            $ref: '#/components/schemas/DataSourcesEnum'
          readOnly: true
          description: Data sources used to generate insights (cv_evaluation, interview)
        cv_score:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
          readOnly: true
          nullable: true
          description: CV evaluation score (0-5)
        interview_score:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
          readOnly: true
          nullable: true
          description: Interview score (0-5)
        overall_score:
          type: string
          format: decimal
          pattern: ^-?\d{0,3}(?:\.\d{0,2})?$
          readOnly: true
          nullable: true
          description: 'Weighted overall score (0-5): 30% CV + 70% Interview'
        overall_score_explanation:
          type: string
          readOnly: true
          nullable: true
          description: Explanation of how overall score was calculated
        hiring_recommendation:
          allOf:
            - $ref: '#/components/schemas/HiringRecommendationEnum'
          readOnly: true
          nullable: true
          description: |-
            AI-generated hiring recommendation based on score and risks

            * `strong_hire` - Strong Hire
            * `hire` - Hire
            * `maybe` - Maybe
            * `no_hire` - No Hire
        hiring_recommendation_explanation:
          type: string
          readOnly: true
          nullable: true
          description: Short explanation for the hiring recommendation (1-2 sentences)
        strengths:
          type: array
          items:
            type: string
          readOnly: true
          description: 2-5 key strengths synthesized from CV and interview
        weaknesses:
          type: array
          items:
            type: string
          readOnly: true
          description: 2-5 key weaknesses and areas for improvement
        risks:
          type: array
          items:
            type: string
          readOnly: true
          description: 0-3 red flags or concerns
        tools_and_skills:
          type: array
          items:
            type: string
          readOnly: true
          description: Technical skills, tools, and competencies identified
        areas_for_development:
          type: array
          items:
            type: string
          readOnly: true
          description: 2-5 growth areas framed constructively
        behavioural_observations:
          type: string
          readOnly: true
          nullable: true
          description: Behavioural observations from interview
        summary:
          type: string
          readOnly: true
          nullable: true
          description: 1-2 paragraph executive summary
        tagline_summary:
          type: string
          readOnly: true
          nullable: true
          description: One-line summary for quick candidate differentiation
          maxLength: 255
        submitted_application_summary:
          type: string
          readOnly: true
          nullable: true
          description: >-
            LLM-generated markdown bullet list summarizing the data the
            candidate submitted with their application
            (JobApplication.custom_fields). One '- ' bullet per relevant item,
            lightly rephrased for readability. Null when custom_fields is empty
            or insights have not yet been synthesized.
        organization:
          type: string
          format: uuid
          readOnly: true
          description: Organization this record belongs to
        candidate:
          type: string
          format: uuid
          readOnly: true
        interview_session_result:
          type: string
          format: uuid
          readOnly: true
          nullable: true
          description: '[v3 jobs only] Interview v3 session result used for this insight.'
      required:
        - areas_for_development
        - behavioural_observations
        - candidate
        - created_at
        - cv_score
        - data_sources
        - error
        - hiring_recommendation
        - hiring_recommendation_explanation
        - id
        - interview_score
        - interview_session_result
        - organization
        - overall_score
        - overall_score_explanation
        - risks
        - status
        - strengths
        - submitted_application_summary
        - summary
        - tagline_summary
        - tools_and_skills
        - updated_at
        - weaknesses
    CVEvaluationStatusEnum:
      enum:
        - pending
        - completed
        - failed
      type: string
      description: |-
        * `pending` - Pending
        * `completed` - Completed
        * `failed` - Failed
    DataSourcesEnum:
      enum:
        - cv_evaluation
        - interview
      type: string
      description: |-
        * `cv_evaluation` - CV Evaluation
        * `interview` - Interview
    HiringRecommendationEnum:
      enum:
        - strong_hire
        - hire
        - maybe
        - no_hire
      type: string
      description: |-
        * `strong_hire` - Strong Hire
        * `hire` - Hire
        * `maybe` - Maybe
        * `no_hire` - No Hire
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: >-
        API key authentication for the public API. Pass your API key as a Bearer
        token.

````