> ## Documentation Index > Fetch the complete documentation index at: https://docs.gnani.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Transcriber Config > Retrieve available ASR providers and models for agent transcription settings ## Overview Retrieve available ASR (Automatic Speech Recognition) providers and their models, filtered by language. The transcriber is the agent's "ears" — it converts the caller's spoken audio into text for the LLM to process. Use this endpoint to identify which ASR models support the languages your agent is configured to use. The `language` parameter is **required**. For multilingual agents (up to 3 languages), pass all language codes together so only models that support every language in the combination are returned. ## Required Permission `agents` ## Query Parameters | Name | Type | Required | Description | | ------------ | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `language` | string | **Yes** | Filter by one or more language codes. Repeat this parameter for multiple languages (e.g. `?language=en-IN&language=hi-IN`). Returns only ASR models that support **all** specified languages. | | `providerId` | string | No | Filter results to a specific ASR provider (e.g. `gnani`, `deepgram`). | ## Example cURL ### Single Language ```bash theme={null} curl "https://api.inya.ai/platform/v1/agents/config/transcriber_config?language=en-IN" \ -H "x-api-key: " ``` ### Multilingual — Filter by Multiple Languages ```bash theme={null} curl "https://api.inya.ai/platform/v1/agents/config/transcriber_config?language=en-IN&language=hi-IN" \ -H "x-api-key: " ``` ### Filter by Language and Provider ```bash theme={null} curl "https://api.inya.ai/platform/v1/agents/config/transcriber_config?language=en-IN&providerId=gnani" \ -H "x-api-key: " ``` ## Response ### Success (200) ```json theme={null} { "status": "success", "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "message": "Transcriber config retrieved successfully", "response": { "transcriberConfig": [ { "name": "Gnani", "provider": { "providerId": "gnani", "label": "Gnani", "description": "Purpose-built for Indian languages and accents. Best for Indic and multilingual Indian agents." }, "models": [ { "modelId": "gnani_vachana_rest", "label": "Vachana Rest", "supportedLanguages": ["hi-IN", "en-IN", "te-IN", "ta-IN", "mr-IN", "bn-IN", "kn-IN", "ml-IN"], "isMultilingual": true, "modelTier": "balanced" }, { "modelId": "gnani_v2", "label": "Vachana", "supportedLanguages": ["hi-IN", "en-IN", "te-IN", "ta-IN", "mr-IN", "bn-IN", "kn-IN", "ml-IN"], "isMultilingual": true, "modelTier": "custom" } ] }, { "name": "Microsoft", "provider": { "providerId": "microsoft", "label": "Microsoft", "description": "Strong accuracy for English and international languages. Recommended for non-Indic agents." }, "models": [ { "modelId": "microsoft_rest", "label": "Rest", "supportedLanguages": ["en-IN", "hi-IN", "en-US", "ta-IN", "te-IN"], "isMultilingual": true, "modelTier": "balanced" }, { "modelId": "microsoft_streaming", "label": "Streaming", "supportedLanguages": ["en-IN", "hi-IN", "en-US", "ta-IN", "te-IN"], "isMultilingual": true, "modelTier": "responsive" } ] } ] } } ``` ### Error Responses **404 Not Found** - No matching ASR configuration found ```json theme={null} { "status": "failure", "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "message": "Transcriber config not found", "response": { "transcriberConfig": [] } } ``` ## Response Fields | Field | Type | Description | | ------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------- | | `transcriberConfig[].name` | string | Human-readable provider display name. | | `transcriberConfig[].provider.providerId` | string | ASR provider identifier. Use as the `provider` value in `asrParams` when updating an agent. | | `transcriberConfig[].provider.label` | string | Human-readable provider label. | | `transcriberConfig[].provider.description` | string | Brief description of the provider's strengths and recommended use cases. | | `transcriberConfig[].models[].modelId` | string | Model identifier. Use as the `model` value in `asrParams`. | | `transcriberConfig[].models[].label` | string | Human-readable model display name. | | `transcriberConfig[].models[].supportedLanguages` | string\[] | BCP-47 language codes supported by this model. | | `transcriberConfig[].models[].isMultilingual` | boolean | Whether this model can handle multiple languages in a single session. | | `transcriberConfig[].models[].modelTier` | string | Performance tier of the model: `balanced`, `responsive`, or `custom`. | ## Use Cases * Identifying which ASR models support a specific language or language combination before configuring an agent * Filtering the transcription model list to only show compatible options in a configuration UI * Validating that your current ASR model still supports a new language you are adding to a multilingual agent * Cross-referencing with the **Update Agent** `advanceSettings` compatibility table to verify model-specific features The `provider.providerId` and `modelId` values returned here map directly to the `provider` and `model` fields in the **Update Agent** `asrParams` object. Use them as-is. The `language` parameter is **required**. Requests without at least one language value will return a 404 error. Obtain valid language codes from the **Get Languages** endpoint. For multilingual agents, pass all language codes in a single request (e.g. `?language=en-IN&language=hi-IN`). This ensures only models that support every language in the set are returned, preventing incompatible configurations. Save the `requestId` from every response. You will need it if you contact Inya support to trace a specific request. ## OpenAPI ````yaml GET /v1/agents/config/transcriber_config openapi: 3.0.3 info: title: Platform Agent Config API description: >- Read-only endpoints for discovering valid configuration values — languages, regions, timezones, LLM models, ASR providers, and TTS voices — before creating or updating agents. version: 2.1.0 servers: - url: https://api.inya.ai/platform description: Production server security: - ApiKeyAuth: [] tags: - name: AgentConfiguration description: Agent configuration discovery operations paths: /v1/agents/config/transcriber_config: get: tags: - AgentConfiguration summary: Get transcriber configuration description: >- Retrieve ASR providers and models that support the specified language or combination of languages. Use this to validate asrParams before updating an agent. operationId: getTranscriberConfig parameters: - name: language in: query description: >- Language codes to filter by. Repeat this parameter for multiple languages. Example: ?language=en-IN&language=hi-IN required: true schema: type: array items: type: string style: form explode: true example: en-IN - name: providerId in: query description: Filter results to a specific ASR provider required: false schema: type: string example: gnani responses: '200': description: Transcriber config retrieved successfully content: application/json: schema: $ref: '#/components/schemas/StandardResponse' examples: success: value: status: success requestId: a1b2c3d4-e5f6-7890-abcd-ef1234567890 message: Transcriber config retrieved successfully response: transcriberConfig: - name: Gnani provider: providerId: gnani label: Gnani description: Purpose-built for Indian languages and accents. models: - modelId: gnani_vachana_rest label: Vachana Rest supportedLanguages: - hi-IN - en-IN - te-IN - ta-IN isMultilingual: true modelTier: balanced - name: Microsoft provider: providerId: microsoft label: Microsoft description: >- Strong accuracy for English and international languages. models: - modelId: microsoft_streaming label: Streaming supportedLanguages: - en-IN - hi-IN - en-US isMultilingual: true modelTier: responsive '404': description: Transcriber config not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': $ref: '#/components/responses/ServerError' components: schemas: StandardResponse: type: object properties: status: type: string example: success requestId: type: string example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 message: type: string response: type: object ErrorResponse: type: object properties: status: type: string example: failure requestId: type: string example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 message: type: string responses: ServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key with 'agents' permission ````