> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sutro.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Download job results

> Download a completed Batch job as JSON, CSV, or Parquet.

<ParamField path="job_id" type="string" required>A successfully completed job.</ParamField>

<ParamField query="format" type="enum" required>
  `json`, `csv`, or `parquet`.
</ParamField>

<ParamField query="include_inputs" type="boolean" default="false">
  Include source inputs.
</ParamField>

<ParamField query="include_cumulative_logprobs" type="boolean" default="false">
  Include cumulative log probabilities.
</ParamField>

## Headers

<ParamField header="Authorization" type="string" required>
  Deployment API key in the form `Key YOUR_SUTRO_API_KEY`.
</ParamField>

```bash theme={null}
curl "https://YOUR-SUTRO-DEPLOYMENT/v1/jobs/JOB_ID/results?format=json&include_inputs=true" \
  -H "Authorization: Key YOUR_SUTRO_API_KEY"
```

| Format    | Response                                                                 |
| --------- | ------------------------------------------------------------------------ |
| `json`    | JSON object; best for small results                                      |
| `csv`     | ZIP archive containing CSV; outputs use a column named after the job ID  |
| `parquet` | Snappy-compressed Parquet with preserved column types; best for analysis |

JSON can contain `outputs`, plus `inputs` and `cumulative_logprobs` when requested. Result order matches input order. If the job used `id_column_name`, that column is always present—even when inputs are excluded.

Structured outputs are JSON strings that conform to the submitted schema, so parse each output with `json.loads` or its equivalent. A reasoning-model output string contains `content` and `reasoning_content`; `content` holds the schema-conforming result.

Results are available only after success. For large artifacts or resumable transfer, use [a presigned Parquet URL](/reference/api/job-results-url).