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

# Get transcript verifications

> Get transcript verification results for an inquiry. This endpoint retrieves all transcript verification results for a given inquiry, including verifications from all associated call logs.



## OpenAPI

````yaml get /api/v0/verification
openapi: 3.1.0
info:
  title: Health Harbor
  description: >+

    Health Harbor's API handles calls to insurance for your providers so you
    don't have to.


    This simple API supports a few operations:

    * **Create an inquiry** to call insurance for a provider.

    * **Read an inquiry** to get the status and results for a previously
    submitted inquiry.


    Each operation is supported in bulk or individually. In addition to typical
    patient and practice information needed to complete an inquiry, each
    operation also supports:

    * an 'external_id' parameter which you can define and pass in with your
    creation request. This is useful for tracking a specific subgroup of
    inquiries. For instance, you can assign a unique external id to all
    inquiries for a specific provider on your platform.


    For example, the most common use case is to request benefits for certain
    procedure codes for a patient. You can do this by creating an inquiry with
    the patient's insurance information, the provider's information, and the
    procedure codes you want to check along with CODE_LOOKUP_BENEFITS as the
    query. We will then check benefits for those procedure codes and return the
    results to you.


    We've also started creating customized queries for our customers so they can
    specify certain follow-up questions or specific information they want
    outside the scope of a typical benefits request. Contact
    alan@healthharbor.co, and we'll set one up for you.

  termsOfService: >-
    https://docs.google.com/document/d/1sOPgtPktx4YWc-p5YXWIztGEWusDG4wsP_txWhjpwNw/edit?usp=sharing
  contact:
    name: Support
    email: support@healthharbor.co
  version: 0.1.0
servers: []
security: []
paths:
  /api/v0/verification:
    get:
      tags:
        - Transcripts
      summary: Get transcript verifications
      description: >-
        Get transcript verification results for an inquiry. This endpoint
        retrieves all transcript verification results for a given inquiry,
        including verifications from all associated call logs.
      operationId: get_transcript_verifications_api_v0_verification_get
      parameters:
        - description: Inquiry ID to get all verifications for
          required: true
          schema:
            type: string
            title: Inquiry Id
            description: Inquiry ID to get all verifications for
          name: inquiry_id
          in: query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TranscriptVerificationsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - OAuth2PasswordBearer: []
        - HTTPBasic: []
components:
  schemas:
    TranscriptVerificationsResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: Whether the request was successful
        count:
          type: integer
          title: Count
          description: Number of verifications returned
        verifications:
          items:
            $ref: '#/components/schemas/ExternalTranscriptVerification'
          type: array
          title: Verifications
          description: >-
            List of transcript verification results, sorted by creation time
            (newest first)
      type: object
      required:
        - success
        - count
        - verifications
      title: TranscriptVerificationsResponse
      description: Response model for transcript verifications endpoint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ExternalTranscriptVerification:
      properties:
        id:
          type: string
          title: Id
          description: Unique identifier for the verification
        inquiry_id:
          type: string
          title: Inquiry Id
          description: The inquiry ID this verification belongs to
        call_log_id:
          type: string
          title: Call Log Id
          description: The call log ID this verification is for
        verification_items:
          items:
            $ref: '#/components/schemas/ExternalVerificationItem'
          type: array
          title: Verification Items
          description: List of individual verification items checked
        creation_ts:
          type: string
          title: Creation Ts
          description: Timestamp when the verification was created in ISO format
      type: object
      required:
        - id
        - inquiry_id
        - call_log_id
        - verification_items
        - creation_ts
      title: ExternalTranscriptVerification
      description: External representation of a transcript verification result.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ExternalVerificationItem:
      properties:
        name:
          type: string
          title: Name
          description: Name of the verification item
        description:
          type: string
          title: Description
          description: Description of what is being verified
        status:
          type: string
          title: Status
          description: >-
            Status of the verification (e.g., MET, NOT_MET, UNCLEAR,
            NOT_APPLICABLE)
        evidence:
          type: string
          title: Evidence
          description: Evidence from the transcript supporting the status
        reasoning:
          type: string
          title: Reasoning
          description: AI reasoning for the verification result
        validation:
          type: object
          title: Validation
          description: >-
            Value-accuracy check comparing the recorded result value against the
            transcript. Contains status, recorded_value, transcript_value,
            evidence, and reasoning. Null when no corresponding recorded value
            exists for this item.
      type: object
      required:
        - name
        - description
        - status
      title: ExternalVerificationItem
      description: External representation of a verification item.
  securitySchemes:
    OAuth2PasswordBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: token
    HTTPBasic:
      type: http
      scheme: basic

````