GET /v1/history — Browse Transcription History Entries

The history endpoint returns a list of recent transcription entries from FluidVoice’s local history store, ordered from most recent to oldest. Each entry includes both the raw speech model output and the final text after AI enhancement (if it was applied), along with metadata about which app and window were active at the time.

Request

GET /v1/history

Query parameters

integer

The maximum number of history entries to return. Defaults to 100. The maximum allowed value is 1000. Values below 1 are clamped to 1. Values above 1000 are clamped to 1000.

Examples

Fetch the most recent 100 entries (default):

curl "http://localhost:47733/v1/history"

Fetch the 10 most recent entries:

curl "http://localhost:47733/v1/history?limit=10"

Fetch up to 500 entries:

curl "http://localhost:47733/v1/history?limit=500"

Response

{
  "count": 2,
  "items": [
    {
      "aiProcessingError": null,
      "appName": "Slack",
      "characterCount": 22,
      "finalText": "The deployment failed.",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "originalText": "hey so um the deploy broke",
      "processedText": "The deployment failed.",
      "rawText": "hey so um the deploy broke",
      "timestamp": "2025-01-15T09:41:00Z",
      "wasAIProcessed": true,
      "windowTitle": "#engineering"
    },
    {
      "aiProcessingError": null,
      "appName": "Notion",
      "characterCount": 47,
      "finalText": "Add a section for onboarding docs to the wiki.",
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "originalText": "add a section for onboarding docs to the wiki",
      "processedText": "Add a section for onboarding docs to the wiki.",
      "rawText": "add a section for onboarding docs to the wiki",
      "timestamp": "2025-01-15T09:38:22Z",
      "wasAIProcessed": true,
      "windowTitle": "Team Wiki"
    }
  ]
}

integer

required

The number of items returned in this response. Equal to or less than the requested limit.

array

required

An array of transcription history entries, ordered from most recent to oldest.

Show Item fields

string

required

A UUID that uniquely identifies this history entry.

string

required

The ISO 8601 date-time string recording when this dictation occurred (e.g. "2025-01-15T09:41:00Z").

string

required

The raw text produced directly by the speech model, before any AI enhancement. Same as rawText.

string

required

The text that was ultimately typed into the target app. If AI enhancement ran successfully, this is the enhanced text. If enhancement was skipped or failed, this equals rawText. Same as processedText.

string

required

The unmodified speech-model output. Alias for originalText.

string

required

The text after AI post-processing. Alias for finalText.

string

required

The name of the application that was frontmost when dictation occurred (e.g. "Slack", "Notion", "Terminal").

string

required

The title of the active window or document at the time of dictation (e.g. "#engineering", "Team Wiki").

integer

required

The number of characters in finalText.

boolean

required

true if AI enhancement ran and produced a result for this entry; false if enhancement was skipped or not configured.

string | null

required

An error message string if AI enhancement failed, or null if enhancement succeeded or was not attempted.

Error responses

Status	Meaning
`405`	You used a method other than `GET`.

History entries are stored locally on your Mac. If you have not used FluidVoice yet, or if you have cleared history from the app, the items array will be empty and count will be 0.

Overview

Endpoints

GET /v1/history — Browse Transcription History Entries

Request

Query parameters

Examples

Response

Error responses

​Request

​Query parameters

​Examples

​Response

​Error responses

Request

Query parameters

Examples

Response

Error responses