---
title: "Get show notes, transcript and edit summary as text"
method: GET
path: "/orders/{id}/content"
tags: ["Orders"]
---

# Get show notes, transcript and edit summary as text

`GET /orders/{id}/content`

## Request

- Base URL: `https://barevalue.com/api/v1`
- URL: `https://barevalue.com/api/v1/orders/{id}/content`
- Auth: HTTP bearer

The text of a finished order, so no file has to be downloaded and parsed. Available once the order status is done.

## Path parameters

- `id` integer, required

## Query parameters

- `include` string

## Response `200`

OK

- OrderContentResponse
  - `order_id` integer
  - `podcast_name` string, nullable
  - `episode_name` string, nullable
  - `summary` OrderSummary, nullable: What the edit changed. Null until it has been written, shortly after the order is done
    - `changes` string[]: What the edit did, one line each. A line that says something was removed or trimmed is present only when the edit recorded a cut of that kind
    - `cuts` integer: Every cut the edit recorded: passages the editor removed (requested cuts, false starts, repeated words, off-topic talk) and the automatic trimming of filler words and long pauses. Cuts on record for the run that was delivered: 0 means none is on record, which is nothing cut or, rarely, no record kept
    - `seconds_removed` number: Seconds taken out by the cuts counted in cuts. A recorded figure, not the difference between the two lengths: music or a closing tag added to the episode makes it longer
    - `duration_before_seconds` number, nullable: Measured length of the recording as it was sent. null when it was not measured as one length: an order of more than one file (tracks, parts or a recording with its music) always gives null. Never the minutes counted for the order
    - `duration_after_seconds` number, nullable: Measured length of the delivered episode. null until it has been measured, which can take a few minutes after the order is done, and it may stay null (an order that was edited again is not measured a second time). Probe the downloaded file for the exact length when it is null
    - `recording_quality` 'excellent' | 'good' | 'fair' | 'needs_improvement' | 'null', nullable: How the raw recording sounded before editing
    - `recording_tip` string, nullable: A tip to pass on to the person who recorded it, when there is one
  - `show_notes` object
    - `available` boolean
    - `text` string: Plain text
    - `html` string: The same show notes as an HTML fragment. It is generated text: sanitise it before rendering it in a page
    - `reason` string: When available is false
    - `message` string: When available is false
  - `transcript` object
    - `available` boolean
    - `text` string: The transcript of the edited episode, one paragraph per speaker turn. With more than one speaker the turns are labelled Speaker 1, Speaker 2, in the order they first speak
    - `word_count` integer
    - `speakers` integer
    - `reason` string: When available is false
    - `message` string: When available is false

## Other responses

- `401`: Missing or invalid API key
- `404`: Resource not found
- `409`: order_not_done: the order is not finished yet
- `422`: validation_error: include names a part that does not exist

---

[API](https://skmtc.dev/barevalue/apis/barevalue-api.md) · [All operations](https://skmtc.dev/barevalue/apis/barevalue-api/llms.txt) · [OpenAPI document](https://skmtc.dev/barevalue/apis/barevalue-api/revisions/c47bdd23fcf6?raw)