---
title: "Get summary and insights"
method: GET
path: "/v1/jobs/{job_id}/insights"
tags: ["Jobs"]
---

# Get summary and insights

`GET /v1/jobs/{job_id}/insights`

## Request

- Base URL: `https://whipscribe.com/api`
- URL: `https://whipscribe.com/api/v1/jobs/{job_id}/insights`
- Auth: API key in header `X-API-Key`

Summary, key quotes, topics and named speakers for a finished job. Generated on first request, then returned from cache.

## Path parameters

- `job_id` string, uuid, required

## Headers

- `X-Claim-Token` string

## Response `200`

Insights.

- Insights
  - `insights` object: Summary, key quotes, topics and named speakers for the recording.

## Other responses

- `400`: Malformed request (e.g. `BAD_ID`, `BAD_URL`, `BAD_IDEMPOTENCY_KEY`).
- `401`: Missing or invalid API key, or the job needs an ownership proof (`X-Claim-Token`).
- `402`: Not enough credit (`NO_CREDITS`, `INSUFFICIENT_CREDITS_FOR_DURATION`), or the finished transcript is locked (`transcript_locked`). With your own API key the body also carries `checkout_url`: a card checkout link for your account that a person can open and pay; then repeat the request.
- `404`: Unknown job id, or a job that is not yours.
- `409`: Job not finished (`NOT_READY`), or not enough speech to summarize (`NO_SPEECH`).
- `429`: Too many requests; retry with backoff (`RATE_LIMITED`, `QUOTA_EXCEEDED`).
- `502`: Temporary service error; safe to retry (`BACKEND_ERROR`, `BACKEND_UNREACHABLE`).
- `503`: Insights temporarily unavailable; retry later.

---

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