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

# Discovery

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

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.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/revisions/9ea23456f722/schema)