# IHME GBD Results · Hierarchy children

Get health and medical data with IHME GBD Results · Hierarchy children from Alexandria through one Spiral API key. Traverse one level down a hierarchy: the direct children of a cause, location or rei node (e.g. GBD region Western Europe to its 24 countries), plus the parent node and its ancestors. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `ihme-gbd-results/gbd/children`
- Page: https://spiral.ai/tools/alexandria/ihme-gbd-results/gbd/children

## Pricing

$0.001746 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `id` (required) | number |  | — | Parent node id, e.g. location 73 (Western Europe), cause 294 (All causes), rei 169 (All risk factors). |
| `type` (required) | one of | cause, location, rei | — | Hierarchical entity type. |
| `gbd_round` (required) | one of | 2021, 2023 | — | GBD round served by the Results tool: 2021 (gbd2021.healthdata.org) or 2023 (vizhub.healthdata.org, current release). Pinned on every record. |
| `proxy` | JSON |  | — | Optional runner proxy override {kind: datacenter\|residential\|mobile, country?, sticky?}. Staging leases datacenter only. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "ihme-gbd-results/gbd/children",
    "input": {
      "id": 1,
      "type": "cause",
      "gbd_round": "2021"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=ihme-gbd-results%2Fgbd%2Fchildren

## Common questions

### IHME GBD Results · Hierarchy children

**How much does IHME GBD Results · Hierarchy children cost?**

$0.001746 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use IHME GBD Results · Hierarchy children through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "ihme-gbd-results/gbd/children"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use IHME GBD Results · Hierarchy children?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use IHME GBD Results · Hierarchy children?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

