Get Run Data | Onepin

{
  "data": {
    "workflow_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "run_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "run_status": "completed",
    "partial": {
      "status": "available",
      "reason": null,
      "source": null
    },
    "rows": [
      {
        "id": "row-001",
        "script_status": "available",
        "line_index": 0,
        "line_id": "line-abc123",
        "source_line_id": "src-line-xyz789",
        "script": "Hello, welcome to our tutorial.",
        "script_reason": null,
        "auto_corrected": 0,
        "auto_corrected_status": "unavailable",
        "auto_corrected_reason": "auto_correction_count_unavailable",
        "cards": [
          {
            "id": "card-001-en-US",
            "audio": {
              "status": "available",
              "playback_url": "https://audio.onepin.ai/playback/abc123?token=xyz",
              "reason": null,
              "duration_ms": 3500,
              "content_type": "audio/mpeg",
              "provider": "aws-polly",
              "model": "neural"
            },
            "voice": {
              "status": "available",
              "display_name": "Joanna",
              "reason": null
            },
            "line_id": "line-abc123",
            "source_line_id": "src-line-xyz789",
            "line_index": 0,
            "locale_code": "en-US",
            "script": "Hello, welcome to our tutorial.",
            "validations": [
              {
                "kind": "word_accuracy",
                "status": "available",
                "label": "Word Accuracy",
                "score": 98.5,
                "reason": null,
                "wer": 0.015,
                "cer": 0.01,
                "transcript": "Hello, welcome to our tutorial."
              },
              {
                "kind": "naturalness",
                "status": "available",
                "label": "Naturalness",
                "score": 92,
                "reason": null,
                "wer": null,
                "cer": null,
                "transcript": null
              }
            ],
            "waveform_url": "https://audio.onepin.ai/waveform/abc123.png",
            "waveform_status": "available",
            "waveform_reason": null,
            "retry_count": 0
          }
        ]
      }
    ]
  },
  "meta": {
    "request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "timestamp": "2024-01-15T09:30:00Z"
  },
  "pagination": {
    "limit": 20,
    "total": 1,
    "next": null,
    "prev": null
  }
}

Paginated script-and-audio data rows for a completed workflow run.

Returns grouped rows where each row represents one source script line. Within each row, cards contain the per-language audio outputs, per-card validation scores (word accuracy, naturalness), and short-lived audio playback_url values (valid for 15 minutes).

Filtering:

search narrows which rows are returned based on their source script text.
language narrows the cards list within each returned row to a single locale. Rows with no matching cards are still returned (with empty cards), and pagination.total always reflects the search-filtered row count regardless of language.

Pagination: pagination.total is scoped to the search filter only.

Response includes a partial field indicating whether any data is still being computed (e.g. audio not yet generated, validation not yet scored). This endpoint sets Cache-Control: no-store because playback URLs are short-lived and data may change while a run is still in progress.

Paginated script-and-audio data rows for a completed workflow run. Returns grouped rows where each row represents one source script line. Within each row, `cards` contain the per-language audio outputs, per-card validation scores (word accuracy, naturalness), and short-lived audio `playback_url` values (valid for 15 minutes). **Filtering:** - `search` narrows which rows are returned based on their source script text. - `language` narrows the `cards` list within each returned row to a single locale. Rows with no matching cards are still returned (with empty `cards`), and `pagination.total` always reflects the search-filtered row count regardless of `language`. **Pagination:** `pagination.total` is scoped to the `search` filter only. Response includes a `partial` field indicating whether any data is still being computed (e.g. audio not yet generated, validation not yet scored). This endpoint sets `Cache-Control: no-store` because playback URLs are short-lived and data may change while a run is still in progress.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

workflow_idstringRequiredformat: "uuid"

run_idstringRequiredformat: "uuid"

Query parameters

searchstring or nullOptional<=100 characters

Case-insensitive search over the source/script text of each row.

languagestring or nullOptional<=50 characters

Exact full-locale code to filter cards within each row (e.g. en-US). _ is normalized to -. Filtering is card-level only — rows remain visible even when all their cards are filtered out, and pagination.total is unaffected.

offsetintegerOptional>=0Defaults to 0

Zero-based pagination offset.

limitintegerOptional1-100Defaults to 20

Maximum rows to return (1–100).

Response

Successful Response

dataobject

metaobject

paginationobject

PaginationMeta variant for endpoints that compute an unpaginated total.

Errors

422

Unprocessable Entity Error