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

# Decisions Best Practices

> Shared evidence, citation fields, and API limits for Decisions

## Group Related Questions

All questions in a request share one set of retrieved evidence. Group questions about
the same entity or topic; use separate requests for unrelated entities.

## Citations

Each object in the `citations` array has these fields:

| Field | Type | Meaning |
| - | - | - |
| `url` | `string` | Source page URL. |
| `title` | `string`, optional | Page title; omitted when unavailable. |
| `excerpts` | `string[]` | Passages included in the decision context, possibly shortened. Can be empty. |

Excerpts are included by default. Set `advanced_settings.include_excerpts: false` to return
`"excerpts": []` for each citation. URLs and available titles are still returned;
the decision still uses the excerpts as evidence.

The former top-level `include_excerpts` is still accepted. Do not send both forms.

## Input Limits

| Setting | Limit |
| - | - |
| Mode | `fast` (default) |
| Questions per request | 1–100 |
| Options per choice question | 2–255 |
| Levels per score question | 2–10 |
| Input per question | 32,000 estimated tokens, including shared state |
| Rendered question | 5,000 characters, including its name, instructions, criteria, and formatting |

See the [API Reference](https://docs.parallel.ai/api-reference/decisions/decisions.md)
for the complete request and response schemas.

## Limit Evidence by Date

Add `"advanced_settings": {"after_date": "2026-10-01"}` to limit grounding
evidence to content published on or after a date. Use an RFC 3339 date in
`YYYY-MM-DD` format. Omit `after_date` when older evidence is still relevant.

## Location

Add `"advanced_settings": {"location": "gb"}` to geo-target the grounding search.
Use a [supported country code](https://docs.parallel.ai/search/advanced-search-settings.md#supported-locations).
Codes are case-insensitive; use `gb` for the United Kingdom, not `uk`.

`advanced_settings` accepts `location`, `after_date`, `include_excerpts`, or any
combination of those fields.
Omit the object when unused. Empty settings or invalid values return HTTP 422.
