# 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://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 | A parameter is missing or malformed, or the link is not one this endpoint takes. | Fix the parameter named in param as the message says. For a link of the wrong kind, call an endpoint listed in details.endpoints, when there is one. |

### 401

401 Unauthorized.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `unauthorized` | 401 | No | The x-api-key header is missing, or its key is unknown or revoked. On the dashboard's routes: the session cookie is missing or expired. | Send a valid API key in the x-api-key header. No key yet? A person gets one at details.signup_url; an AI agent follows details.agent_auth_url. |

### 404

404 Not Found.

| Code | HTTP | Retry | Meaning | What to do |
| --- | --- | --- | --- | --- |
| `job_not_found` | 404 | No | The account has no job with this ID: the ID is wrong, or the job is past its retention. | Check the job ID. Finished jobs are kept for a limited time. |

operationId `jobs.results.download`

---

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