> For the complete documentation index, see [llms.txt](https://docs.biobox.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biobox.io/guide/how-to/ask-biobox-with-claude/tools/get-query-template.md).

# get\_query\_template — Get one query template

Get one query template

Get one query template

## What it does

Fetch a single query template by uuid, with its full cypherTemplate, plannerNotes, and BxQL.

**When to use:** you have a template uuid (from list\_query\_templates) and want its full definition.

**When NOT to use:** you don't have a uuid yet — use list\_query\_templates to find one.

**Parameters:**

* `uuid` — the query template's uuid (from list\_query\_templates).

**Returns:** The template { uuid, name, description, cypherTemplate, returnStatement, inputVariables, plannerNotes, qlEquivalent, distinct, enabled, allowWriteOperations }, or { found: false } if no template has that uuid.

## Parameters

| Parameter | Type   | Required | Description                                              |
| --------- | ------ | -------- | -------------------------------------------------------- |
| `uuid`    | string | yes      | the query template's uuid (from list\_query\_templates). |

## Response

```ts
_(identity shaper — response = the handler result; see the tool source.)_
```

## Example

```json
// get_query_template({"uuid":"2pFLryHlH5XpCFjUGjA5p"})
{
  "uuid": "2pFLryHlH5XpCFjUGjA5p"
}
```

Response (arrays truncated):

```json
{
  "uuid": "2pFLryHlH5XpCFjUGjA5p",
  "name": "find_genes_acted_on_by_drugs_approved_for_disease",
  "description": "Find genes that are acted upon by drugs, which are approved for a disease. Query template should be used when wanting genes given the disease uuid",
  "cypherTemplate": "MATCH (g:Gene)<-[:`acts on`]-(d:Drug)-[:`is approved for`]->(input:Disease)",
  "returnStatement": "RETURN d.uuid as resultDiseaseID",
  "inputVariables": [
    {
      "groupingVariable": "diseaseVar",
      "key": "uuid",
      "variable": "input",
      "name": "diseaseID",
      "description": "The uuid of the disease",
      "type": "string",
      "required": true,
      "operator": "="
    }
  ],
  "plannerNotes": null,
  "qlEquivalent": "(g:Gene)<- acts on<- (d:Drug)-> is approved for-> (input:Disease $diseaseVar)",
  "distinct": true,
  "enabled": true,
  "allowWriteOperations": false
}
```