> For the complete documentation index, see [llms.txt](https://devdocs.olisystems.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devdocs.olisystems.com/chemistry-model-files/chembuilder-api/chembuilder-query/species-query.md).

# Species Query

<mark style="color:green;">`POST`</mark> `https://api.olisystems.com/engine/chemistry/query/species`

#### Headers

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | String |             |

The Species query method can clarify whether a species exists in the databank of an associated thermodynamic framework and whether the entered name of the species is valid or not, addressing potential user uncertainties.

### Request Payload&#x20;

```json
{ 
    "params":{ 
        "thermodynamicFramework": "MSE (H3O+ ion)",
      }
}
```

<table><thead><tr><th width="266.3333333333333" align="center">Keyword in JSON</th><th align="center">Required </th><th align="center">Type</th></tr></thead><tbody><tr><td align="center"><strong>params</strong></td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2714">✔️</span></td><td align="center">JSON Object</td></tr><tr><td align="center"><strong>thermodynamicFramework</strong></td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2714">✔️</span></td><td align="center">String</td></tr></tbody></table>

{% hint style="info" %}
Only the "thermodynamicFramework" parameter is needed here. All public and private databank information for this thermodynamic framework will be displayed in the output.
{% endhint %}

### Response (status=SUCCESS)

If no run-time [errors ](/chemistry-model-files/chembuilder-api/supporting-information-for-chembuilder/chembuilder-errors.md)are encountered, the [Query output](/chemistry-model-files/chembuilder-api/chembuilder-query/query-output-results.md) with the requested contents will be available for users to view.