---
title: GET /v1/lookup/molecule/enhanced
description: "Analyze one molecule — Computes molecular properties and a quality assessment for a single SMILES string, plus a flat list of annotations for display."
full: true
---

**Auth:** required. Send an `ivy_` API key (`Authorization: Bearer ivy_…`), a signed-in session token (`Authorization: Bearer …`) or the session cookie (browser sessions). See [Authentication](/docs/api/authentication).

Computes molecular properties and a quality assessment for a single SMILES string, plus a flat list of annotations for display. An unparseable SMILES returns 400.

## Request

### Query parameters

- `smiles` (string) —
SMILES string of the molecule.

## Responses

### `200` OK

Properties, quality and annotations for the molecule

Response shape:

- `smiles` (string) —
The SMILES you sent.

- `molecular_properties` (any) —

- `molecular_quality` (any) —

- `enhanced_annotations` (object[]) —

### `400` Bad Request

The SMILES could not be parsed

Response shape: `object`

### `401` Unauthorized

Authentication required

Response shape: `object`

### `422` Unprocessable Entity

A required query parameter is missing or out of range; the body says which

Response shape: `object`

### `429` Too Many Requests

Rate limit exceeded

Response shape: `object`

### `502` Bad Gateway

The compute service is unavailable. Retry with backoff.

Response shape: `object`

**curl**

```bash
curl -X GET 'https://ivybiosciences.com/api/v1/lookup/molecule/enhanced' \
  -H "Authorization: Bearer $IVY_API_KEY"
```

**JavaScript**

```js
const res = await fetch('https://ivybiosciences.com/api/v1/lookup/molecule/enhanced', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.IVY_API_KEY}`,
  },
});
const data = await res.json();
```

**Python**

```python
import os, requests

res = requests.get(
    "https://ivybiosciences.com/api/v1/lookup/molecule/enhanced",
    headers={"Authorization": f"Bearer {os.environ['IVY_API_KEY']}"},
)
data = res.json()
```
