# VectorSearchRequest

Model ID: `VectorSearchDocumentsRequest`

Semantic search over one collection's document chunks.

Type: `object`

## Fields

| Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
|---|---|---:|---|---|---|---:|---|
| `collection` | `string|null` | No |  |  | `null` | Yes | Collection to search; defaults to the documents collection. Must be one reported by GET /graph/vector/collections. |
| `collection_group` | `string|null` | No |  |  | `null` | Yes | Corpus label within the collection, e.g. MedlinePlus or MedicalPolicy. |
| `language` | `string|null` | No |  |  | `null` | Yes | Document language, e.g. English. |
| `network_id` | `string|null` | No |  |  | `null` | Yes | Stedi payer id. A narrower scope than payer_key and only resolved for some payers, so prefer payer_key. |
| `payer_key` | `string|null` | No |  |  | `null` | Yes | Payer registry slug, e.g. cigna \| aetna \| bcbsma. REQUIRED when searching the payer-policy collection, which is partitioned by payer so that one search only ever returns one payer's policies. Ignored for the consumer-health collection. |
| `q` | `string` | Yes |  |  |  | No | Natural-language query; embedded and matched by meaning, not keyword. |
| `source` | `string|null` | No |  |  | `null` | Yes | Pipeline that produced the chunk: medlineplus \| medical_policy \| guideline. |
| `tags` | `array` | No |  |  |  | No | Health tags; a chunk matching ANY of them is returned, so more tags broaden the result set. |
| `top_k` | `integer` | No |  |  | `10` | No | Maximum hits returned. |

## Example

None declared in canonical OpenAPI.