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

# Get Extraction Template by ID

> Retrieve a single extraction template by its unique identifier. Use this to get the evaluation_schema and details of a specific template before submitting workflows.



## OpenAPI

````yaml /api-reference/openapi.json post /workflows/extractionTemplates/getById
openapi: 3.0.3
info:
  title: EmberQA Call Scoring API
  description: >-
    Submit call recordings programmatically for scoring and analysis. This API
    allows you to integrate call scoring directly into your existing systems and
    workflows.


    ## Authentication

    All requests require a Bearer token in the Authorization header. API keys
    are provided on the EmberQA dashboard under the "Integrations" tab.


    ## Audio Requirements

    - **Supported formats:** MP3, WAV

    - **Maximum file size:** 100MB

    - **Audio quality:** Minimum 8kHz sample rate recommended
  version: 1.0.0
  contact:
    name: EmberQA Support
    url: https://emberqa.com
servers:
  - url: https://api.emberqa.com/api
    description: Production server
security:
  - BearerAuth: []
paths:
  /workflows/extractionTemplates/getById:
    post:
      tags:
        - Extraction Templates
      summary: Get Extraction Template by ID
      description: >-
        Retrieve a single extraction template by its unique identifier. Use this
        to get the evaluation_schema and details of a specific template before
        submitting workflows.
      operationId: getExtractionTemplateById
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetTemplateByIdRequest'
            example:
              id: 123e4567-e89b-12d3-a456-426614174000
      responses:
        '200':
          description: Successfully retrieved extraction template
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExtractionTemplateResponse'
              example:
                statusCode: SUCCESS
                statusMessage: Successfully retrieved extraction template
                doc:
                  id: 123e4567-e89b-12d3-a456-426614174000
                  org_id: org-abc123
                  name: Invoice Data Extraction
                  evaluation_schema:
                    invoice_number: Find the invoice number at the top of the document
                    total_amount: Locate the total amount due
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Extraction template not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    GetTemplateByIdRequest:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of the extraction template
          example: 123e4567-e89b-12d3-a456-426614174000
    ExtractionTemplateResponse:
      type: object
      properties:
        statusCode:
          type: string
          example: SUCCESS
        statusMessage:
          type: string
          example: Successfully retrieved extraction template
        doc:
          $ref: '#/components/schemas/ExtractionTemplate'
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message describing what went wrong
        details:
          type: string
          description: Additional details about the error (optional)
    ExtractionTemplate:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier of the template
        org_id:
          type: string
          description: Organization ID the template belongs to
        name:
          type: string
          description: Human-readable name of the template
        evaluation_schema:
          type: object
          additionalProperties:
            type: string
          description: >-
            Key-value pairs where keys are field names to extract and values are
            instructions for extracting them
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key obtained from the EmberQA dashboard under the "Integrations" tab

````