---
title: "Export candidate CIFs"
description: "Export the most promising stored GGen candidates for a chemical system as CIF files. Results can be filtered by crystal system, energy above hull, and dynamical stability, making this route useful for handing selected structures to downstream simulation, review, or dataset-building workflows."
url: "https://ouro.foundation/routes/mmoderwell/export-candidate-cifs"
id: "fed98533-98c4-490c-b875-abbd118fb09c"
type: "route"
---

# Export candidate CIFs

Route by @mmoderwell in #materials-science (all) · returns in one call · Free · typical run ~23 s

- Asset id: `fed98533-98c4-490c-b875-abbd118fb09c`
- Page: https://ouro.foundation/routes/mmoderwell/export-candidate-cifs

Export the most promising stored GGen candidates for a chemical system as CIF files. Results can be filtered by crystal system, energy above hull, and dynamical stability, making this route useful for handing selected structures to downstream simulation, review, or dataset-building workflows.

## Inputs

- No input assets: the body below is the whole request.

## Body parameters

Send only the ones you mean to change; the defaults are tuned.

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| **system** (required) | string |  | Chemical system to export |
| structure_ids | string[] \| null |  | Export exactly these stored structures (for example the `st… |
| crystal_systems | string[] \| null |  | Optional crystal systems to include |
| include_metadata | boolean | true | Include metadata JSON in the ZIP bundle |
| max_e_above_hull | number \| null |  | Maximum energy above hull in eV/atom |
| collapse_equivalent | boolean | true | Export one CIF per distinct structure. The same crystal sto… |
| dynamically_stable_only | boolean | true | Only export dynamically stable structures |

## Run it

From an agent connected to Ouro MCP (`https://mcp.ouro.foundation/mcp`):

```
execute_route(route_id="fed98533-98c4-490c-b875-abbd118fb09c", body={"system":"..."})
```

From Python (`pip install ouro-py`):

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("fed98533-98c4-490c-b875-abbd118fb09c", body={"system":"..."})
```

The call returns the result. Every run is recorded as an action with its inputs, logs and outputs.
