GET

/v1/schemas/deepgram/audio/v1%2Flisten?kind=output

kind outputactivity audiohash 3ba46541…extracted Oct 24, 2026version currentsource upstream spec ↗

Response body

0 properties · 0 required · 0 $defs

This schema isn’t a plain object with properties — showing the raw JSON instead.

application/json
{
  "provider": "deepgram",
  "activity": "audio",
  "endpointId": "v1/listen",
  "kind": "output",
  "contentHash": "3ba46541226a1dcabe5fbf37e21d0ac459029ae43c79e9fb8c8b16ff551f0101",
  "specRevision": null,
  "provenance": {
    "sourceUrl": "https://developers.deepgram.com/openapi.json",
    "sourceHash": "f91de57c05631ad01baabd75ab7cb2938a1ef69e11b1449e05e3bf256838db99",
    "fetchedAt": 1792819826,
    "extractorVersion": "1",
    "derivation": "upstream-spec",
    "verifiedAt": null
  },
  "createdAt": 1792819826,
  "supersededAt": null,
  "schema": {
    "oneOf": [
      {
        "$ref": "#/$defs/ListenV1Response"
      },
      {
        "$ref": "#/$defs/ListenV1AcceptedResponse"
      }
    ],
    "title": "listen_v1_media_transcribe_Response_200",
    "$defs": {
      "ListenV1AcceptedResponse": {
        "type": "object",
        "properties": {
          "request_id": {
            "type": "string",
            "format": "uuid",
            "description": "Unique identifier for tracking the asynchronous request"
          }
        },
        "required": [
          "request_id"
        ],
        "description": "Accepted response for asynchronous transcription requests",
        "title": "ListenV1AcceptedResponse"
      },
      "ListenV1Response": {
        "type": "object",
        "properties": {
          "metadata": {
            "$ref": "#/$defs/ListenV1ResponseMetadata"
          },
          "results": {
            "$ref": "#/$defs/ListenV1ResponseResults"
          }
        },
        "required": [
          "metadata",
          "results"
        ],
        "description": "The standard transcription response",
        "title": "ListenV1Response"
      },
      "ListenV1ResponseMetadata": {
        "type": "object",
        "properties": {
          "transaction_key": {
            "type": "string",
            "default": "deprecated",
            "deprecated": true
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          },
          "sha256": {
            "type": "string"
          },
          "created": {
            "type": "string",
            "format": "date-time"
          },
          "duration": {
            "type": "number",
            "format": "double"
          },
          "channels": {
            "type": "integer"
          },
          "models": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "model_info": {
            "$ref": "#/$defs/ListenV1ResponseMetadataModelInfo"
          },
          "diarize_info": {
            "$ref": "#/$defs/ListenV1ResponseMetadataDiarizeInfo",
            "description": "The diarizer that produced the speaker labels. Present only when a diarizer ran."
          },
          "summary_info": {
            "$ref": "#/$defs/ListenV1ResponseMetadataSummaryInfo"
          },
          "sentiment_info": {
            "$ref": "#/$defs/ListenV1ResponseMetadataSentimentInfo"
          },
          "topics_info": {
            "$ref": "#/$defs/ListenV1ResponseMetadataTopicsInfo"
          },
          "intents_info": {
            "$ref": "#/$defs/ListenV1ResponseMetadataIntentsInfo"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "request_id",
          "sha256",
          "created",
          "duration",
          "channels",
          "models",
          "model_info"
        ],
        "title": "ListenV1ResponseMetadata"
      },
      "ListenV1ResponseMetadataDiarizeInfo": {
        "type": "object",
        "properties": {
          "model_uuid": {
            "type": "string",
            "description": "The diarizer model UUID"
          },
          "arch": {
            "type": "string",
            "description": "The diarizer arch, such as `v1` or `v2`"
          }
        },
        "required": [
          "model_uuid",
          "arch"
        ],
        "description": "The diarizer that produced the speaker labels. Present only when a diarizer ran.",
        "title": "ListenV1ResponseMetadataDiarizeInfo"
      },
      "ListenV1ResponseMetadataIntentsInfo": {
        "type": "object",
        "properties": {
          "model_uuid": {
            "type": "string"
          },
          "input_tokens": {
            "type": "integer"
          },
          "output_tokens": {
            "type": "integer"
          }
        },
        "title": "ListenV1ResponseMetadataIntentsInfo"
      },
      "ListenV1ResponseMetadataModelInfo": {
        "type": "object",
        "properties": {},
        "title": "ListenV1ResponseMetadataModelInfo"
      },
      "ListenV1ResponseMetadataSentimentInfo": {
        "type": "object",
        "properties": {
          "model_uuid": {
            "type": "string"
          },
          "input_tokens": {
            "type": "integer"
          },
          "output_tokens": {
            "type": "integer"
          }
        },
        "title": "ListenV1ResponseMetadataSentimentInfo"
      },
      "ListenV1ResponseMetadataSummaryInfo": {
        "type": "object",
        "properties": {
          "model_uuid": {
            "type": "string"
          },
          "input_tokens": {
            "type": "integer"
          },
          "output_tokens": {
            "type": "integer"
          }
        },
        "title": "ListenV1ResponseMetadataSummaryInfo"
      },
      "ListenV1ResponseMetadataTopicsInfo": {
        "type": "object",
        "properties": {
          "model_uuid": {
            "type": "string"
          },
          "input_tokens": {
            "type": "integer"
          },
          "output_tokens": {
            "type": "integer"
          }
        },
        "title": "ListenV1ResponseMetadataTopicsInfo"
      },
      "ListenV1ResponseResults": {
        "type": "object",
        "properties": {
          "channels": {
            "$ref": "#/$defs/ListenV1ResponseResultsChannels"
          },
          "utterances": {
            "$ref": "#/$defs/ListenV1ResponseResultsUtterances"
          },
          "summary": {
            "$ref": "#/$defs/ListenV1ResponseResultsSummary"
          },
          "topics": {
            "$ref": "#/$defs/SharedTopics"
          },
          "intents": {
            "$ref": "#/$defs/SharedIntents"
          },
          "sentiments": {
            "$ref": "#/$defs/SharedSentiments"
          }
        },
        "required": [
          "channels"
        ],
        "title": "ListenV1ResponseResults"
      },
      "ListenV1ResponseResultsChannels": {
        "type": "array",
        "items": {
          "$ref": "#/$defs/ListenV1ResponseResultsChannelsItems"
        },
        "title": "ListenV1ResponseResultsChannels"
      },
      "ListenV1ResponseResultsChannelsItems": {
        "type": "object",
        "properties": {
          "search": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsSearchItems"
            }
          },
          "alternatives": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItems"
            }
          },
          "detected_language": {
            "type": "string"
          }
        },
        "title": "ListenV1ResponseResultsChannelsItems"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItems": {
        "type": "object",
        "properties": {
          "transcript": {
            "type": "string"
          },
          "confidence": {
            "type": "string",
            "title": "float"
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tags of the languages detected in the transcript, sorted by word count in descending order. Only present when `language=multi`. Can be absent on audio that switches languages."
          },
          "languages_hinted": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The `language_hint` values for the request, normalized: codes are returned in canonical form (`ES` → `es`, `zh-hk` → `zh-HK`), and a regional code the model has no tag for is returned as its base language (`en-GB` → `en`). Returned on every Nova-3 multilingual response (`model=nova-3&language=multi`); an empty array when no `language_hint` was sent."
          },
          "words": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsWordsItems"
            }
          },
          "paragraphs": {
            "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphs"
          },
          "entities": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsEntitiesItems"
            }
          },
          "summaries": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsSummariesItems"
            }
          },
          "topics": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsTopicsItems"
            }
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItems"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItemsEntitiesItems": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "value": {
            "type": "string"
          },
          "raw_value": {
            "type": "string"
          },
          "confidence": {
            "type": "string",
            "title": "float"
          },
          "start_word": {
            "type": "string",
            "title": "float"
          },
          "end_word": {
            "type": "string",
            "title": "float"
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsEntitiesItems"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphs": {
        "type": "object",
        "properties": {
          "transcript": {
            "type": "string"
          },
          "paragraphs": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItems"
            }
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphs"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItems": {
        "type": "object",
        "properties": {
          "sentences": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItemsSentencesItems"
            }
          },
          "speaker": {
            "type": "integer"
          },
          "num_words": {
            "type": "integer"
          },
          "start": {
            "type": "string",
            "title": "float"
          },
          "end": {
            "type": "string",
            "title": "float"
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItems"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItemsSentencesItems": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "start": {
            "type": "string",
            "title": "float"
          },
          "end": {
            "type": "string",
            "title": "float"
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsParagraphsParagraphsItemsSentencesItems"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItemsSummariesItems": {
        "type": "object",
        "properties": {
          "summary": {
            "type": "string"
          },
          "start_word": {
            "type": "string",
            "title": "float"
          },
          "end_word": {
            "type": "string",
            "title": "float"
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsSummariesItems"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItemsTopicsItems": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "start_word": {
            "type": "string",
            "title": "float"
          },
          "end_word": {
            "type": "string",
            "title": "float"
          },
          "topics": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsTopicsItems"
      },
      "ListenV1ResponseResultsChannelsItemsAlternativesItemsWordsItems": {
        "type": "object",
        "properties": {
          "word": {
            "type": "string"
          },
          "start": {
            "type": "string",
            "title": "float"
          },
          "end": {
            "type": "string",
            "title": "float"
          },
          "confidence": {
            "type": "string",
            "title": "float"
          },
          "language": {
            "type": "string",
            "description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tag of the word's detected language. Only present when `language=multi`. Can be absent on audio that switches languages."
          },
          "speaker": {
            "type": "integer",
            "description": "The speaker of the word, present when diarization is enabled"
          },
          "speaker_confidence": {
            "type": "string",
            "title": "float",
            "description": "Confidence in the speaker assignment. Returned only for pre-recorded diarization; not available for streaming"
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsAlternativesItemsWordsItems"
      },
      "ListenV1ResponseResultsChannelsItemsSearchItems": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "hits": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsChannelsItemsSearchItemsHitsItems"
            }
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsSearchItems"
      },
      "ListenV1ResponseResultsChannelsItemsSearchItemsHitsItems": {
        "type": "object",
        "properties": {
          "confidence": {
            "type": "string",
            "title": "float"
          },
          "start": {
            "type": "string",
            "title": "float"
          },
          "end": {
            "type": "string",
            "title": "float"
          },
          "snippet": {
            "type": "string"
          }
        },
        "title": "ListenV1ResponseResultsChannelsItemsSearchItemsHitsItems"
      },
      "ListenV1ResponseResultsSummary": {
        "type": "object",
        "properties": {
          "result": {
            "type": "string"
          },
          "short": {
            "type": "string"
          }
        },
        "title": "ListenV1ResponseResultsSummary"
      },
      "ListenV1ResponseResultsUtterances": {
        "type": "array",
        "items": {
          "$ref": "#/$defs/ListenV1ResponseResultsUtterancesItems"
        },
        "title": "ListenV1ResponseResultsUtterances"
      },
      "ListenV1ResponseResultsUtterancesItems": {
        "type": "object",
        "properties": {
          "start": {
            "type": "string",
            "title": "float"
          },
          "end": {
            "type": "string",
            "title": "float"
          },
          "confidence": {
            "type": "string",
            "title": "float"
          },
          "channel": {
            "type": "integer"
          },
          "transcript": {
            "type": "string"
          },
          "languages": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tags of the languages detected in the utterance, sorted by word count in descending order. Only present when `language=multi`."
          },
          "words": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/ListenV1ResponseResultsUtterancesItemsWordsItems"
            }
          },
          "speaker": {
            "type": "integer"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          }
        },
        "title": "ListenV1ResponseResultsUtterancesItems"
      },
      "ListenV1ResponseResultsUtterancesItemsWordsItems": {
        "type": "object",
        "properties": {
          "word": {
            "type": "string"
          },
          "start": {
            "type": "string",
            "title": "float"
          },
          "end": {
            "type": "string",
            "title": "float"
          },
          "confidence": {
            "type": "string",
            "title": "float"
          },
          "language": {
            "type": "string",
            "description": "[BCP-47](https://tools.ietf.org/html/bcp47) language tag of the word's detected language. Only present when `language=multi`. Can be absent on audio that switches languages."
          },
          "speaker": {
            "type": "integer"
          },
          "speaker_confidence": {
            "type": "string",
            "title": "float"
          },
          "punctuated_word": {
            "type": "string"
          }
        },
        "title": "ListenV1ResponseResultsUtterancesItemsWordsItems"
      },
      "SharedIntents": {
        "type": "object",
        "properties": {
          "segments": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/SharedIntentsSegmentsItems"
            }
          }
        },
        "description": "Output whenever `intents=true` is used",
        "title": "SharedIntents"
      },
      "SharedIntentsSegmentsItems": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "start_word": {
            "type": "number",
            "format": "double"
          },
          "end_word": {
            "type": "number",
            "format": "double"
          },
          "intents": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/SharedIntentsSegmentsItemsIntentsItems"
            }
          }
        },
        "title": "SharedIntentsSegmentsItems"
      },
      "SharedIntentsSegmentsItemsIntentsItems": {
        "type": "object",
        "properties": {
          "intent": {
            "type": "string"
          },
          "confidence_score": {
            "type": "string",
            "title": "float"
          }
        },
        "title": "SharedIntentsSegmentsItemsIntentsItems"
      },
      "SharedSentiments": {
        "type": "object",
        "properties": {
          "segments": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/SharedSentimentsSegmentsItems"
            }
          },
          "average": {
            "$ref": "#/$defs/SharedSentimentsAverage"
          }
        },
        "description": "Output whenever `sentiment=true` is used",
        "title": "SharedSentiments"
      },
      "SharedSentimentsAverage": {
        "type": "object",
        "properties": {
          "sentiment": {
            "type": "string"
          },
          "sentiment_score": {
            "type": "number",
            "format": "double"
          }
        },
        "title": "SharedSentimentsAverage"
      },
      "SharedSentimentsSegmentsItems": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "start_word": {
            "type": "number",
            "format": "double"
          },
          "end_word": {
            "type": "number",
            "format": "double"
          },
          "sentiment": {
            "type": "string"
          },
          "sentiment_score": {
            "type": "number",
            "format": "double"
          }
        },
        "title": "SharedSentimentsSegmentsItems"
      },
      "SharedTopics": {
        "type": "object",
        "properties": {
          "segments": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/SharedTopicsSegmentsItems"
            }
          }
        },
        "description": "Output whenever `topics=true` is used",
        "title": "SharedTopics"
      },
      "SharedTopicsSegmentsItems": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "start_word": {
            "type": "number",
            "format": "double"
          },
          "end_word": {
            "type": "number",
            "format": "double"
          },
          "topics": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/SharedTopicsSegmentsItemsTopicsItems"
            }
          }
        },
        "title": "SharedTopicsSegmentsItems"
      },
      "SharedTopicsSegmentsItemsTopicsItems": {
        "type": "object",
        "properties": {
          "topic": {
            "type": "string"
          },
          "confidence_score": {
            "type": "string",
            "title": "float"
          }
        },
        "title": "SharedTopicsSegmentsItemsTopicsItems"
      }
    }
  }
}

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"deepgram","endpointId":"v1/listen","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}