# Download every result of a job (JSON Lines)

Jobs

GET `/v1/jobs/{id}/results.jsonl`

The job's `results_url`: every result as JSON Lines (one JobResult object per line, in completion order), streamed. The URL is signed: it needs no API key and works until `results_url_expires_at`; GET the job again for a fresh one. Free.

**Auth:** none: the signed URL is the credential.

## Example

cURL:

```shell
curl 'https://staging.socialtap.dev/v1/jobs/<id>/results.jsonl'
```

## Path parameters

| Name | Type | Description | Example |
| --- | --- | --- | --- |
| `id` required | `string` | Job ID (job_…). | — |

## Query parameters

| Name | Type | Description | Example |
| --- | --- | --- | --- |
| `account` optional | `string`<br>max 100 chars | Set by SocialTap: the job's account (and mode). | — |
| `expires` optional | `integer`<br>min 0 | Set by SocialTap: when the URL stops working (Unix seconds). | — |
| `signature` optional | `string`<br>max 200 chars | Set by SocialTap: the URL's signature. | — |

## Response

### 200

Download every result of a job (JSON Lines) (`application/jsonl`)

### 400

400 Bad Request.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `invalid_input` | 400 | No | The request parameters are missing or malformed, or the URL is not a supported link for this endpoint. | Fix the parameter named in param (the message says how); for a link of the wrong kind, call the endpoint the message names. |

### 401

401 Unauthorized.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `unauthorized` | 401 | No | The x-api-key header is missing, unknown or revoked (or, on the dashboard's routes, the session cookie is missing or expired). | Send a valid API key in the x-api-key header; without one, get a key at details.signup_url (AI agents: POST details.agent_signup_url). |

### 404

404 Not Found.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `job_not_found` | 404 | No | No job with this ID exists for the account: unknown, or past its retention. | Check the job ID; finished jobs are kept for a limited time. |

operationId `jobs.results.download`

---

[HTML version](https://staging.socialtap.dev/docs/reference/jobs/results-download/) · [Docs index for AI agents](https://staging.socialtap.dev/llms.txt) · [All docs in one file](https://staging.socialtap.dev/llms-full.txt)