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

# List pronunciation dictionaries

> List pronunciation dictionaries for the authenticated organization.

<Note>For workflow examples, see the [Pronunciation dictionaries guide](/pronunciation-dictionaries).</Note>


## OpenAPI

````yaml GET /v1/pronunciation/dictionaries
openapi: 3.0.3
info:
  title: SLNG Gateway API - SLNG TTS
  version: 0.1.0
  description: Pronunciation dictionary management endpoints for SLNG TTS.
  contact:
    name: SLNG Support
    email: support@slng.ai
servers:
  - url: https://api.slng.ai
    description: Production
  - url: https://stageapi.slng.ai
    description: Staging
security:
  - BearerAuth: []
tags:
  - name: Pronunciation dictionaries
    description: Manage reusable pronunciation rewrite dictionaries for TTS.
paths:
  /v1/pronunciation/dictionaries:
    get:
      tags:
        - Pronunciation dictionaries
      summary: List pronunciation dictionaries
      description: List pronunciation dictionaries for the authenticated organization.
      operationId: pronunciation-dictionaries-list
      responses:
        '200':
          description: Pronunciation dictionaries for the authenticated organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PronunciationDictionaryListResponse'
        '401':
          $ref: '#/components/responses/PronunciationUnauthenticated'
        '503':
          $ref: '#/components/responses/PronunciationUnavailable'
components:
  schemas:
    PronunciationDictionaryListResponse:
      type: object
      required:
        - dictionaries
      properties:
        dictionaries:
          type: array
          description: Pronunciation dictionaries for the authenticated organization.
          items:
            $ref: '#/components/schemas/PronunciationDictionary'
    PronunciationDictionary:
      type: object
      required:
        - id
        - org_id
        - name
        - normalized_name
        - modes
        - content_hash
        - created_at
      properties:
        id:
          type: string
          description: Immutable pronunciation dictionary identifier.
          example: pd_01abc...
        org_id:
          type: string
          description: Organization that owns the dictionary.
          example: org_123
        name:
          type: string
          description: Dictionary name.
          example: brand-pronunciations
        normalized_name:
          type: string
          description: Normalized dictionary name used for lookups.
          example: brand-pronunciations
        metadata:
          type: object
          description: Optional application metadata stored with the dictionary.
          additionalProperties: true
          example:
            language: hi-IN
            providers:
              - sarvam
              - cartesia
        modes:
          $ref: '#/components/schemas/PronunciationModes'
        content_hash:
          type: string
          description: Content hash for the stored dictionary.
          example: sha256:...
        created_at:
          type: string
          format: date-time
          description: Creation timestamp.
          example: '2026-05-15T12:00:00.000Z'
        created_by_key_label:
          type: string
          description: API key label that created the dictionary, when available.
          example: production-key
    PronunciationError:
      type: object
      required:
        - code
        - error
      properties:
        code:
          type: string
          description: Pronunciation error code.
          example: invalid_pronunciation
        error:
          type: string
          description: Human-readable error message.
          example: Invalid pronunciation dictionary reference.
        fieldErrors:
          type: object
          description: Field-level validation errors, when available.
          additionalProperties:
            type: array
            items:
              type: string
          example:
            modes:
              - modes.rewrite is required
        slng_request_id:
          type: string
          description: SLNG request identifier for support.
          example: req_01abc...
    PronunciationModes:
      type: object
      required:
        - rewrite
      properties:
        rewrite:
          $ref: '#/components/schemas/PronunciationRewriteMode'
        ipa:
          $ref: '#/components/schemas/PronunciationIpaMode'
      description: >-
        Pronunciation modes stored on the dictionary. Only `rewrite` is
        executable today.
    PronunciationRewriteMode:
      type: object
      required:
        - rules
      properties:
        rules:
          type: array
          description: >-
            Deterministic rewrite rules. Matching is case-insensitive,
            whole-word or whole-phrase, longest-match first, and non-recursive.
          maxItems: 256
          items:
            $ref: '#/components/schemas/PronunciationRewriteRule'
    PronunciationIpaMode:
      type: object
      description: IPA entries can be stored but are not executed today.
      properties:
        rules:
          type: array
          maxItems: 256
          items:
            $ref: '#/components/schemas/PronunciationIpaRule'
    PronunciationRewriteRule:
      type: object
      required:
        - match
        - replace
      properties:
        match:
          type: string
          description: Word or phrase to match.
          maxLength: 128
          example: NAIC
        replace:
          type: string
          description: Replacement text sent to the selected TTS model.
          maxLength: 256
          example: en ay eye see
    PronunciationIpaRule:
      type: object
      required:
        - match
        - ipa
      properties:
        match:
          type: string
          maxLength: 128
          description: Word or phrase to match.
          example: SLNG
        ipa:
          type: string
          maxLength: 256
          description: IPA pronunciation value. Stored only; not executed today.
          example: slɪŋ
  responses:
    PronunciationUnauthenticated:
      description: Missing or unresolved organization context.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PronunciationError'
          examples:
            unauthenticated:
              summary: Missing organization context
              value:
                code: pronunciation_unauthenticated
                error: Missing or invalid organization context.
    PronunciationUnavailable:
      description: Pronunciation storage or dependency unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PronunciationError'
          examples:
            unavailable:
              summary: Pronunciation service unavailable
              value:
                code: pronunciation_unavailable
                error: Pronunciation dictionaries are temporarily unavailable.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````