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

# Fetch an analysis

> Returns the full analysis row. When `status === "completed"` the `analysis` field is populated with the canonical six-pillar shape (clarity / influence / objection / discovery / delivery / close), each pillar exposed as a flat `*_score` field plus `feedback_v5.<pillar>.{positive, negative}` and `action_plan_v5`. KPIs (`questions_asked`, `filler_word_count`, `words_per_minute`) are flat at the top of `analysis`. Mock fixtures emit the same shape so a partner can decode `mock://*` and real audio with one decoder.



## OpenAPI

````yaml https://api.goparlay.io/docs/json get /v1/analyses/{id}
openapi: 3.0.3
info:
  title: Parlay API
  description: >-
    Partner-facing API for Parlay pitch scoring, rep intelligence, and coaching.
    See API.md for the full spec.
  version: 0.1.0
servers:
  - url: http://localhost:3000
    description: production
security:
  - ApiKeyAuth: []
tags:
  - name: Health
    description: Service health and platform status
  - name: Analyses
    description: Submit and retrieve pitch scoring analyses
  - name: Orgs
    description: Partner org management
  - name: Reps
    description: Rep management
  - name: Keys
    description: API key lifecycle
  - name: Webhooks
    description: Webhook registration and delivery
  - name: Personas
    description: Rep persona intelligence
  - name: Methodologies
    description: Rep methodology intelligence
  - name: Synthesis
    description: Profile synthesis
  - name: Insights
    description: Org-level insights
  - name: Playbooks
    description: Playbook management + AI drafting
  - name: Prompts
    description: Custom AI prompts
  - name: Scoring
    description: Scoring profile config
  - name: Chat
    description: Scout AI chat
  - name: Dispositions
    description: Call dispositions
  - name: Practice
    description: Practice sessions
  - name: Bulk
    description: Batch and export
  - name: Usage
    description: Usage and billing
  - name: Audit
    description: Audit log
paths:
  /v1/analyses/{id}:
    get:
      tags:
        - Analyses
      summary: Fetch an analysis
      description: >-
        Returns the full analysis row. When `status === "completed"` the
        `analysis` field is populated with the canonical six-pillar shape
        (clarity / influence / objection / discovery / delivery / close), each
        pillar exposed as a flat `*_score` field plus
        `feedback_v5.<pillar>.{positive, negative}` and `action_plan_v5`. KPIs
        (`questions_asked`, `filler_word_count`, `words_per_minute`) are flat at
        the top of `analysis`. Mock fixtures emit the same shape so a partner
        can decode `mock://*` and real audio with one decoder.
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: id
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - queued
                      - processing
                      - completed
                      - failed
                      - cancelled
                  recording_url:
                    type: string
                    nullable: true
                  transcript_url:
                    type: string
                    nullable: true
                  callback_url:
                    type: string
                    nullable: true
                  options:
                    type: object
                    additionalProperties: {}
                  metadata:
                    type: object
                    additionalProperties: {}
                  transcript:
                    type: object
                    properties:
                      text:
                        type: string
                      utterances:
                        type: array
                        items:
                          type: object
                          properties:
                            speaker:
                              anyOf:
                                - type: string
                                - type: number
                            start:
                              type: number
                            end:
                              type: number
                            transcript:
                              type: string
                            text:
                              type: string
                          required:
                            - start
                            - end
                          additionalProperties: true
                      words:
                        type: array
                        items:
                          type: object
                          additionalProperties: {}
                      word_count:
                        type: integer
                        minimum: 0
                      duration_seconds:
                        type: number
                        minimum: 0
                      overall_sentiment:
                        type: string
                        nullable: true
                      sentiment_score:
                        type: number
                        nullable: true
                    additionalProperties: true
                    nullable: true
                  analysis:
                    type: object
                    properties:
                      prospect_name:
                        type: string
                        nullable: true
                      recording_title:
                        type: string
                      double_down:
                        type: string
                      ai_summary:
                        type: string
                      ai_summary_v5:
                        type: string
                      questions_asked:
                        type: integer
                        minimum: 0
                      filler_word_count:
                        type: integer
                        minimum: 0
                      words_per_minute:
                        type: number
                        minimum: 0
                      overall_score:
                        type: integer
                        minimum: 0
                        maximum: 100
                      clarity_score:
                        type: integer
                        minimum: 0
                        maximum: 100
                      influence_score:
                        type: integer
                        minimum: 0
                        maximum: 100
                      objection_score:
                        type: integer
                        minimum: 0
                        maximum: 100
                      discovery_score:
                        type: integer
                        minimum: 0
                        maximum: 100
                      delivery_score:
                        type: integer
                        minimum: 0
                        maximum: 100
                      close_score:
                        type: integer
                        minimum: 0
                        maximum: 100
                      feedback_v5:
                        type: object
                        properties:
                          clarity:
                            type: object
                            properties:
                              positive:
                                type: string
                              negative:
                                type: string
                            required:
                              - positive
                              - negative
                            additionalProperties: false
                          influence:
                            type: object
                            properties:
                              positive:
                                type: string
                              negative:
                                type: string
                            required:
                              - positive
                              - negative
                            additionalProperties: false
                          objection:
                            type: object
                            properties:
                              positive:
                                type: string
                              negative:
                                type: string
                            required:
                              - positive
                              - negative
                            additionalProperties: false
                          discovery:
                            type: object
                            properties:
                              positive:
                                type: string
                              negative:
                                type: string
                            required:
                              - positive
                              - negative
                            additionalProperties: false
                          delivery:
                            type: object
                            properties:
                              positive:
                                type: string
                              negative:
                                type: string
                            required:
                              - positive
                              - negative
                            additionalProperties: false
                          close:
                            type: object
                            properties:
                              positive:
                                type: string
                              negative:
                                type: string
                            required:
                              - positive
                              - negative
                            additionalProperties: false
                        required:
                          - clarity
                          - influence
                          - objection
                          - discovery
                          - delivery
                          - close
                        additionalProperties: false
                      action_plan_v5:
                        type: object
                        properties:
                          double_down_implementation:
                            type: string
                          general_communication_improvement:
                            type: string
                          quoted_principle:
                            type: string
                        required:
                          - double_down_implementation
                          - general_communication_improvement
                          - quoted_principle
                        additionalProperties: false
                      organization_prompt_summary:
                        type: string
                        nullable: true
                      organization_feedback:
                        type: string
                        nullable: true
                      master_prompt_id:
                        type: string
                        nullable: true
                      master_prompt_version:
                        type: string
                      persona_snapshot:
                        type: object
                        additionalProperties: {}
                        nullable: true
                      synthesis_snapshot:
                        type: object
                        additionalProperties: {}
                        nullable: true
                    required:
                      - prospect_name
                      - recording_title
                      - double_down
                      - ai_summary
                      - ai_summary_v5
                      - questions_asked
                      - filler_word_count
                      - words_per_minute
                      - overall_score
                      - clarity_score
                      - influence_score
                      - objection_score
                      - discovery_score
                      - delivery_score
                      - close_score
                      - feedback_v5
                      - action_plan_v5
                      - organization_prompt_summary
                      - organization_feedback
                      - master_prompt_id
                      - master_prompt_version
                      - persona_snapshot
                      - synthesis_snapshot
                    additionalProperties: false
                    nullable: true
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details:
                        type: object
                        additionalProperties: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                    nullable: true
                  duration_seconds:
                    type: integer
                    nullable: true
                  cost_usd_cents:
                    anyOf:
                      - type: number
                      - type: string
                    nullable: true
                  created_at:
                    type: string
                  started_at:
                    type: string
                    nullable: true
                  completed_at:
                    type: string
                    nullable: true
                  partner_org_id:
                    type: string
                    format: uuid
                    nullable: true
                  partner_rep_id:
                    type: string
                    format: uuid
                    nullable: true
                  parent_session_id:
                    type: string
                    format: uuid
                    nullable: true
                required:
                  - id
                  - status
                  - recording_url
                  - transcript_url
                  - callback_url
                  - options
                  - metadata
                  - transcript
                  - analysis
                  - error
                  - duration_seconds
                  - cost_usd_cents
                  - created_at
                  - started_at
                  - completed_at
                  - partner_org_id
                  - partner_rep_id
                  - parent_session_id
                additionalProperties: false
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key (pk_sandbox_* or pk_live_*)

````