{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/transcript1-com/json-schema/transcript1-com-transcription-list-schema.json",
  "title": "TranscriptionList",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/transcript1-com-openapi.json#/components/schemas/TranscriptionList",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "enum": [
        "list"
      ]
    },
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Transcription"
      }
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "object",
    "data",
    "next_cursor"
  ],
  "$defs": {
    "Transcription": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "object": {
          "type": "string",
          "enum": [
            "transcription"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "awaiting_upload",
            "queued",
            "fetching",
            "transcribing",
            "completed",
            "failed",
            "canceled"
          ]
        },
        "source": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "platform": {
                  "type": "string"
                },
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "media_id": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "platform",
                "url",
                "media_id"
              ]
            },
            {
              "type": "object",
              "properties": {
                "platform": {
                  "type": "string",
                  "enum": [
                    "upload"
                  ]
                },
                "filename": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "size": {
                  "type": [
                    "number",
                    "null"
                  ]
                }
              },
              "required": [
                "platform",
                "filename",
                "size"
              ]
            }
          ]
        },
        "media": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "author": {
              "type": [
                "string",
                "null"
              ]
            },
            "author_url": {
              "type": [
                "string",
                "null"
              ]
            },
            "thumbnail_url": {
              "type": [
                "string",
                "null"
              ]
            },
            "filename": {
              "type": "string"
            },
            "mime_type": {
              "type": "string"
            },
            "size": {
              "type": "number"
            },
            "duration_seconds": {
              "type": [
                "number",
                "null"
              ]
            }
          }
        },
        "options": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string",
              "enum": [
                "auto",
                "captions",
                "stt"
              ]
            },
            "language": {
              "type": "string"
            },
            "diarize": {
              "type": "boolean"
            }
          },
          "required": [
            "source",
            "language",
            "diarize"
          ]
        },
        "transcript_source": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "youtube_captions",
            "x_captions",
            "tiktok_captions",
            "bluesky_captions",
            "dailymotion_captions",
            "linkedin_captions",
            "speech_to_text"
          ]
        },
        "caption_kind": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "manual",
            "auto_generated"
          ],
          "description": "Null until resolved, for speech-to-text, or when native caption metadata does not establish authorship. Unknown does not mean manual."
        },
        "language": {
          "type": [
            "string",
            "null"
          ]
        },
        "billed_minutes": {
          "type": [
            "integer",
            "null"
          ]
        },
        "cached": {
          "type": "boolean"
        },
        "error": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "code",
            "message"
          ]
        },
        "created_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "completed_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "deleted_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "When the transcription was deleted. Always `null` unless the request includes `include_deleted=true`."
        },
        "transcript": {
          "type": "object",
          "properties": {
            "text": {
              "type": "string"
            },
            "speakers": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "segments": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "start": {
                    "type": "number"
                  },
                  "end": {
                    "type": "number"
                  },
                  "speaker": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "language": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "text": {
                    "type": "string"
                  },
                  "words": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "object",
                      "properties": {
                        "start": {
                          "type": "number"
                        },
                        "end": {
                          "type": "number"
                        },
                        "text": {
                          "type": "string"
                        },
                        "confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "speaker": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "start",
                        "end",
                        "text",
                        "speaker"
                      ]
                    }
                  }
                },
                "required": [
                  "start",
                  "end",
                  "speaker",
                  "language",
                  "text"
                ]
              }
            }
          },
          "required": [
            "text",
            "speakers",
            "segments"
          ],
          "description": "Included in `GET` responses for completed transcriptions."
        }
      },
      "required": [
        "id",
        "object",
        "status",
        "source",
        "media",
        "options",
        "transcript_source",
        "caption_kind",
        "language",
        "billed_minutes",
        "cached",
        "error",
        "created_at",
        "completed_at",
        "deleted_at"
      ]
    }
  }
}