---
title: "Discovery"
method: GET
path: "/voice/v1/.well-known/medscribealliance"
tags: ["protocol"]
---

# Discovery

`GET /voice/v1/.well-known/medscribealliance`

## Request

- Base URL: `https://api.eka.care`
- URL: `https://api.eka.care/voice/v1/.well-known/medscribealliance`
- Auth: none required
- TypeScript: <https://skmtc.dev/eka/apis/eka-developer-apis/docs/voice/v1/.well-known/medscribealliance/get.ts> (a function with typed inputs; its response is checked against the schema)

Public, unauthenticated endpoint that advertises the service's protocol version, supported authentication methods, audio capabilities, available models and supported languages. Clients should fetch this first and use the returned `models`, `capabilities.audio_formats` and `capabilities.upload_methods` to configure their session. The response is cacheable (`Cache-Control: max-age=10800`).

## Response `200`

Discovery document

- DiscoveryResponse
  - `protocol` string
  - `protocol_version` string
  - `supported_versions` string[]
  - `service` object
    - `name` string
    - `documentation_url` string
    - `support_email` string
  - `endpoints` object
    - `base_url` string
    - `webhooks_url` string
    - `templates_url` string
  - `authentication` object
    - `supported_methods` string[]
    - `oidc` object
      - `issuer` string
      - `authorization_endpoint` string
      - `token_endpoint` string
      - `scopes_supported` string[]
  - `capabilities` object
    - `audio_formats` string[]
    - `max_chunk_duration_seconds` integer
    - `upload_methods` string[]
    - `webhook_delivery` boolean
    - `client_sdk_delivery` boolean
  - `models` object[]
    - `id` string
    - `display_name` string
    - `languages` string[]
    - `max_session_duration_seconds` integer
    - `response_speed` string
    - `features` object
      - `realtime_transcription` boolean
      - `speaker_diarization` boolean
      - `custom_templates` boolean
  - `languages` object
    - `supported` string[]
    - `auto_detection` boolean

---

[API](https://skmtc.dev/eka/apis/eka-developer-apis.md) - [All operations](https://skmtc.dev/eka/apis/eka-developer-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/eka/apis/eka-developer-apis/revisions/9ea23456f722?raw)