<div class="section-label"><span class="num">05</span> Results</div>
<div class="section-title">Retrieve the forecast and <em>insights</em>.</div>
`GET /results` returns the outcome of a prediction task. Identify the job with <span class="mono">job_id</span> and <span class="mono">job_code</span> from the POST receipt.
The response is a JSON object. **Core** fields apply to every successful task. **Extended** fields add PSR / MaxFit diagnostics (relevance, similarity, informativeness, and related scalars). Grid jobs also include impact measures on the composite.
**Call:** `GET /results`
**Auth:** `x-api-key` header
**Body:** task receipt
> [!note]
> v2 sends the receipt in the GET body (not as query parameters). That matches the OpenAPI spec.
## Signature
```http
GET https://api.csanalytics.io/v2/prediction-engine/results
```
## Task receipt
Every successful `POST /grid`, `POST /maxfit`, or `POST /psr` returns:
| Name | Type | Description |
| --- | --- | --- |
| <span class="mono">job_id</span> | integer | Prediction task id |
| <span class="mono">job_code</span> | string | Prediction task code |
Send the same object back to retrieve results:
```python
import json
import requests
url = "https://api.csanalytics.io/v2/prediction-engine/results"
payload = {
"job_id": 1074,
"job_code": "66cfc21f7effa501",
}
headers = {
"x-api-key": "CSA_API_KEY",
"Content-Type": "application/json",
"Connection": "keep-alive",
}
response = requests.get(url, headers=headers, data=json.dumps(payload))
```
<p> </p>
<div class="section-label"><span class="num">06</span> Core</div>
These fields are on the basic results schema. Shapes follow [[API/Getting Started/Arrays|two-dimensional JSON arrays]].
```openapi
spec: basic
path: /results
method: get
```
Prefer **Impact on Fit** and **Impact on Prediction** on Grid composites. The same arrays are also stored as <span class="mono">marginal_contribution_to_conviction</span> and <span class="mono">marginal_contribution_to_prediction</span>. Legacy names <span class="mono">variable_importance</span> and <span class="mono">variable_importance_on_yhat</span> are deprecated in the spec.
<p> </p>
<div class="section-label"><span class="num">07</span> Extended</div>
The extended results schema adds diagnostics that are especially useful for PSR and MaxFit — relevance, similarity, informativeness, <span class="mono">r_star</span>, agreement, and asymmetry.
```openapi
spec: extended
path: /results
method: get
```
A field that was not filled for this job is simply absent (or unused) on the object. Read numerics to six decimal places: [[API/Getting Started/Precision|Precision]].
> [!tip]
> For the local engine’s nested result object, see [[Results/Overview|Results]]. Names overlap, but v2 JSON is a flat payload from this endpoint, not the thin-client class layout.
## Related
- [[API/Introduction|API]]
- [[API/Prediction Engine/Grid|Grid]] · [[API/Prediction Engine/MaxFit|MaxFit]] · [[API/Prediction Engine/PSR|PSR]]
- [[Results/Overview|Results (local)]] · [[Results/Grid Insights|Grid Insights]]
<div class="btn-row center">
<a class="btn-primary" href="/API/Python%20Client/Introduction">Python Client</a>
<a class="btn-ghost" href="/API/Prediction%20Engine/Grid">Grid</a>
</div>