---
title: "Fetch a past conversion or extraction"
method: GET
path: "/api/v1/conversions/{id}"
tags: ["Conversions"]
---

# Fetch a past conversion or extraction

`GET /api/v1/conversions/{id}`

## Request

- Base URL: `https://scrapewhale.dev`
- URL: `https://scrapewhale.dev/api/v1/conversions/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Returns a conversion owned by the API key’s user, including its stored markdown and — for extractions — the structured `data` payload. Free (no credits charged).

**Credits: free.**

## Path parameters

- `id` string, required

## Response `200`

Success.

- ConversionDetail: A stored conversion or extraction.
  - `id` string, required
  - `status` 'completed' | 'failed', required
  - `sourceType` 'url' | 'file', required
  - `sourceUrl` string, nullable
  - `title` string, nullable
  - `provider` string, required
  - `extractor` string
  - `contentChars` integer
  - `creditsUsed` integer
  - `errorMessage` string
  - `createdAt` integer, required
  - `completedAt` integer
  - `markdown` string, nullable
  - `data` object: Structured payload (extractions only).

## Other responses

- `400`: Invalid parameters.
- `401`: Missing or invalid API key.
- `404`: Not found.
- `429`: Rate limit exceeded (60 requests/min per key).

---

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