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

# Get Scored Call by ID

> Retrieves a single scored call by its ID with full AI-generated insight.

Retrieves a single scored call by its ID, including the full AI-generated insight with scoring facets, lead qualification, and coaching recommendations.

### Path Parameters

* **id** (*required*, string): Scored call ID

### Response

Returns the scored call object matching the given ID, or 404 if not found.

```json theme={null}
{
  "data": {
    "_id": "507f1f77bcf86cd799439011",
    "insight": {
      "total_score": 78,
      "lead": {
        "function": "Sales",
        "tech_stack_mentioned": ["Salesforce", "Outreach"],
        "current_vendor": "Competitor Inc",
        "fit_score": 85,
        "is_decision_maker": true,
        "is_correct_persona": true,
        "pain_point_resonated": true,
        "is_qualified_meeting": true,
        "is_likely_to_buy": false,
        "prospect_lifecycle_stage": ["solution_aware"]
      },
      "messaging": {
        "value_prop_resonated": ["efficiency", "time_savings"],
        "objection_outcome": ["handled"],
        "emotional_triggers": ["frustration_with_current_tool"],
        "recommendation_to_nail_messaging": "Lead with ROI data specific to their industry"
      },
      "targeting_feedback": {
        "persona_fit": "excellent",
        "industry_fit": "good",
        "persona_seniority": "vp",
        "title_relevance": "good",
        "data_quality_issue": [],
        "future_follow_up_needed": true,
        "follow_up_reason": ["renewal"]
      },
      "metadata": {
        "duration_sec": 245,
        "asr_confidence_avg": 0.92,
        "audio_features_available": true,
        "talk_listen_ratio_rep": 0.45,
        "total_questions": 8,
        "open_question_ratio": 0.625,
        "interruptions_by_rep": 1,
        "core_pitch_duration_sec": 35,
        "estimated_wpm_rep": 155,
        "objections_detected": ["budget"]
      },
      "facets": {
        "intro": {
          "score": 85,
          "weight_pct": 10,
          "explanation": "Strong permission-based opener",
          "insufficient_evidence": false,
          "checks": {
            "permission_opener_used": true,
            "opener_length_sec": 12,
            "time_to_opener_sec": 3,
            "improvement_recommendation": "Consider a more personalized opener"
          }
        },
        "discovery": {
          "score": 72,
          "weight_pct": 25,
          "explanation": "Good question quality but missed timing topic",
          "insufficient_evidence": false,
          "metrics": {
            "total_questions": 8,
            "open_question_ratio": 0.625,
            "improvement_recommendation": "Ask about timeline and decision process",
            "topic_coverage": ["pain", "current_tools"]
          }
        },
        "pitch": {
          "score": 80,
          "weight_pct": 20,
          "explanation": "Well-tailored pitch to discovery findings",
          "insufficient_evidence": false,
          "metrics": {
            "core_pitch_duration_sec": 35,
            "tailored_to_discovery": true,
            "improvement_recommendation": "Include a customer success story",
            "outcome_keywords": ["efficiency", "save_time"]
          }
        },
        "tonality": {
          "score": 75,
          "weight_pct": 15,
          "explanation": "Good pace, minor filler word usage",
          "insufficient_evidence": false,
          "metrics": {
            "estimated_wpm": 155,
            "interruptions_by_rep": 1,
            "filler_density_per_min": 2.1,
            "improvement_recommendation": "Reduce filler words"
          }
        },
        "objection_handling": {
          "score": 70,
          "weight_pct": 15,
          "explanation": "Addressed budget objection but no follow-up probe",
          "insufficient_evidence": false,
          "metrics": {
            "objections_detected": ["budget"],
            "followup_probe_present": false,
            "resolution_check_present": true,
            "improvement_recommendation": "Add a follow-up question after handling objections"
          }
        },
        "cta": {
          "score": 82,
          "weight_pct": 15,
          "explanation": "Clear CTA with specific time offered",
          "insufficient_evidence": false,
          "metrics": {
            "cta_attempted": true,
            "cta_type": "meeting",
            "specific_time_offered": true,
            "improvement_recommendation": "Confirm next steps via email",
            "outcome": "accepted"
          }
        }
      },
      "gaps": {
        "skill": 25,
        "playbook": 15,
        "rationale": "Discovery needs more depth on timing and decision process"
      },
      "coaching": {
        "top_wins": ["Strong opener", "Good pitch tailoring"],
        "top_opportunities": ["Deeper discovery", "Objection follow-up probes"],
        "suggested_drills": [
          {
            "facet": "discovery",
            "assignment": "Practice SPIN questions for uncovering timeline"
          }
        ]
      }
    },
    "call_log": {
      "_id": "507f1f77bcf86cd799439022",
      "contact": {
        "first_name": "John",
        "last_name": "Doe",
        "company": "Acme Corp"
      },
      "recording_url": "https://recordings.example.com/call_abc123.mp3",
      "duration": 245
    },
    "user": {
      "_id": "507f1f77bcf86cd799439033",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@company.com"
    },
    "type": "call",
    "createdAt": "2024-01-15T14:33:00.000Z",
    "updatedAt": "2024-01-15T14:33:00.000Z"
  }
}
```


## OpenAPI

````yaml GET /v1/scored-calls/{id}
openapi: 3.0.1
info:
  title: Salesfinity API
  description: API documentation for Salesfinity platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://client-api.salesfinity.co
security:
  - ApiKeyAuth: []
paths:
  /v1/scored-calls/{id}:
    get:
      tags:
        - Scored Calls
      description: Retrieves a single scored call by its ID with full AI-generated insight.
      operationId: get-scored-call-by-id
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: Scored call ID
      responses:
        '200':
          description: Scored call retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/ScoredCallDTO'
        '404':
          description: Scored call not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ScoredCallDTO:
      type: object
      properties:
        _id:
          type: string
          description: Unique identifier
        insight:
          type: object
          description: Full scoring insight
          properties:
            total_score:
              type: number
              description: Overall call score (0-100)
            lead:
              type: object
              properties:
                function:
                  type: string
                tech_stack_mentioned:
                  type: array
                  items:
                    type: string
                current_vendor:
                  type: string
                fit_score:
                  type: number
                is_decision_maker:
                  type: boolean
                is_correct_persona:
                  type: boolean
                pain_point_resonated:
                  type: boolean
                is_qualified_meeting:
                  type: boolean
                is_likely_to_buy:
                  type: boolean
                prospect_lifecycle_stage:
                  type: array
                  items:
                    type: string
            messaging:
              type: object
              properties:
                value_prop_resonated:
                  type: array
                  items:
                    type: string
                objection_outcome:
                  type: array
                  items:
                    type: string
                emotional_triggers:
                  type: array
                  items:
                    type: string
                recommendation_to_nail_messaging:
                  type: string
            targeting_feedback:
              type: object
              properties:
                persona_fit:
                  type: string
                industry_fit:
                  type: string
                persona_seniority:
                  type: string
                title_relevance:
                  type: string
                data_quality_issue:
                  type: array
                  items:
                    type: string
                future_follow_up_needed:
                  type: boolean
                follow_up_reason:
                  type: array
                  items:
                    type: string
            metadata:
              type: object
              properties:
                duration_sec:
                  type: number
                asr_confidence_avg:
                  type: number
                audio_features_available:
                  type: boolean
                talk_listen_ratio_rep:
                  type: number
                total_questions:
                  type: integer
                open_question_ratio:
                  type: number
                interruptions_by_rep:
                  type: integer
                core_pitch_duration_sec:
                  type: number
                estimated_wpm_rep:
                  type: number
                objections_detected:
                  type: array
                  items:
                    type: string
            facets:
              type: object
              properties:
                intro:
                  $ref: '#/components/schemas/ScoringFacet'
                discovery:
                  $ref: '#/components/schemas/ScoringFacet'
                pitch:
                  $ref: '#/components/schemas/ScoringFacet'
                tonality:
                  $ref: '#/components/schemas/ScoringFacet'
                objection_handling:
                  $ref: '#/components/schemas/ScoringFacet'
                cta:
                  $ref: '#/components/schemas/ScoringFacet'
            gaps:
              type: object
              properties:
                skill:
                  type: number
                playbook:
                  type: number
                rationale:
                  type: string
            coaching:
              type: object
              properties:
                top_wins:
                  type: array
                  items:
                    type: string
                top_opportunities:
                  type: array
                  items:
                    type: string
                suggested_drills:
                  type: array
                  items:
                    type: object
                    properties:
                      facet:
                        type: string
                      assignment:
                        type: string
        call_log:
          type: object
          properties:
            _id:
              type: string
            contact:
              type: object
            recording_url:
              type: string
            duration:
              type: number
        user:
          $ref: '#/components/schemas/UserDTO'
        type:
          type: string
          enum:
            - call
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - _id
        - insight
        - type
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    ScoringFacet:
      type: object
      properties:
        score:
          type: number
          description: Facet score (0-100)
        weight_pct:
          type: number
          description: Weight percentage of this facet
        explanation:
          type: string
          description: Human-readable explanation
        insufficient_evidence:
          type: boolean
        evidence:
          type: array
          items:
            type: object
            properties:
              start_sec:
                type: number
              end_sec:
                type: number
              text:
                type: string
    UserDTO:
      type: object
      properties:
        _id:
          type: string
        email:
          type: string
        first_name:
          type: string
        last_name:
          type: string
      required:
        - _id
        - email
        - first_name
        - last_name
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````