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

# Get Roadmap Result (JSON)

> Retrieve structured AI analysis JSON for a completed cognitive roadmap, including overview, domain scores, safety flags, and recommendations.

Use this endpoint to retrieve the structured AI analysis for a completed cognitive roadmap. The JSON response contains the full multi-instrument combined analysis, including overview text, domain scores, safety flags, and recommendations. The exact schema varies by roadmap product type.

## Prerequisites

The roadmap must be finished with AI analysis (`status: 1`). If analysis is not yet complete, the endpoint returns a 409 error. Poll `/roadmap/{token}/generate/status/` first to confirm completion.

## Endpoint

```http theme={"dark"}
GET https://braintest.ir/api/v2/roadmap/{token}/result/json/
```

## Path Parameters

<ParamField path="token" type="string" required>
  The unique cognitive roadmap instance UUID.
</ParamField>

## Response

<ResponseField name="data" type="object">
  Roadmap-specific structured AI output. The schema depends on the roadmap product type. Common fields include `overview`, `domains`, `safety`, and `recommendations`.
</ResponseField>

## Example Request

```bash theme={"dark"}
curl -X GET "https://braintest.ir/api/v2/roadmap/b2c3d4e5-f6a7-8901-bcde-f12345678901/result/json/" \
  -H "API-KEY: YOUR_API_KEY"
```

## Example Response

```json theme={"dark"}
{
  "data": {
    "overview": {
      "title": "Clinical Wellbeing Overview",
      "summary": "Integrated analysis across submitted instruments."
    },
    "domains": [
      {
        "id": "mood",
        "score": 65,
        "label": "Moderate concern"
      }
    ],
    "safety": {
      "flags": []
    },
    "recommendations": {
      "short_term": [],
      "long_term": []
    }
  },
  "successful": true,
  "messages": []
}
```

## Common Response Fields

| Field                        | Description                                             |
| ---------------------------- | ------------------------------------------------------- |
| `overview.title`             | Report title                                            |
| `overview.summary`           | High-level narrative summary                            |
| `domains`                    | Array of scored domains with `id`, `score`, and `label` |
| `safety.flags`               | Array of safety alerts if any are triggered             |
| `recommendations.short_term` | Short-term action recommendations                       |
| `recommendations.long_term`  | Long-term action recommendations                        |

## Error Responses

| HTTP | Cause                                     |
| ---- | ----------------------------------------- |
| 404  | Roadmap not found                         |
| 409  | Roadmap not yet finished with AI analysis |