### Get Review Job Status

Source: https://deepscientist.cc/docs

Retrieves the status and current stage of a specific review job.

```APIDOC
## Get Review Job Status

### Description
Retrieves the status and current stage of a specific review job.

### Method
GET

### Endpoint
/api/v1/review/jobs/{job_id}

### Parameters
#### Path Parameters
- **job_id** (string) - Required - The stable review ID (e.g., DS-RV-XXXXXXXXXX).
```

--------------------------------

### Submit and Download Review Job with Python

Source: https://deepscientist.cc/docs

Use this script to submit a PDF for review, poll its status, and download the results. Ensure you replace 'YOUR_API_TOKEN' with your actual token. The script handles the entire pipeline from submission to downloading a zip file containing markdown and PDF reports.

```python
import time
import requests

BASE_URL = 'https://deepscientist.cc'
HEADERS = {'Authorization': 'Bearer YOUR_API_TOKEN'}

with open('paper.pdf', 'rb') as f:
    submit = requests.post(
        f'{BASE_URL}/api/v1/review/jobs',
        headers=HEADERS,
        files={'paper_pdf': ('paper.pdf', f, 'application/pdf')},
        data={'title': 'My Paper Review'},
        timeout=600,
    )
submit.raise_for_status()
job = submit.json()['job_id']

while True:
    status = requests.get(
        f'{BASE_URL}/api/v1/review/jobs/{job}',
        headers=HEADERS,
        timeout=600,
    )
    status.raise_for_status()
    payload = status.json()
    print(payload['status'], payload['stage'])
    if payload['status'] in ('completed', 'failed'):
        break
    time.sleep(8)

if payload['status'] != 'completed':
    raise RuntimeError(payload['message'])

download = requests.get(
    f'{BASE_URL}/api/v1/review/jobs/{job}/download',
    headers=HEADERS,
    timeout=600,
)
download.raise_for_status()
with open(f'{job}.zip', 'wb') as out:
    out.write(download.content)


```

--------------------------------

### Submit Document for Review

Source: https://deepscientist.cc/docs

Submits a document for AI-powered review. The backend automatically executes the full pipeline including review model run, annotation agent run, report write, and PDF export.

```APIDOC
## Submit Document for Review

### Description
Submits a document for AI-powered review. The backend automatically executes the full pipeline including review model run, annotation agent run, report write, and PDF export.

### Method
POST

### Endpoint
/api/v1/review/jobs

### Parameters
#### Request Body
- **paper_pdf** (file) - Required - The PDF file to be reviewed.
- **title** (string) - Optional - The title of the paper.
```

--------------------------------

### List Review Jobs

Source: https://deepscientist.cc/docs

Retrieves a list of all review jobs.

```APIDOC
## List Review Jobs

### Description
Retrieves a list of all review jobs.

### Method
GET

### Endpoint
/api/v1/review/jobs
```

--------------------------------

### Download Review Results

Source: https://deepscientist.cc/docs

Downloads the review results package, which includes the markdown report and the exported PDF.

```APIDOC
## Download Review Results

### Description
Downloads the review results package, which includes the markdown report and the exported PDF.

### Method
GET

### Endpoint
/api/v1/review/jobs/{job_id}/download

### Parameters
#### Path Parameters
- **job_id** (string) - Required - The stable review ID (e.g., DS-RV-XXXXXXXXXX).
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.