# ChEMBL

> Explore ChEMBL, EMBL-EBI's open database of bioactive molecules: search molecules by name, similarity, substructure or properties, read their structures and properties, list measured bioactivities against drug targets, approved drugs with their mechanisms, indications and warnings, and the papers behind the data. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/chembl

## Actions

### Find molecules by properties

Find molecules whose calculated properties fall in the ranges you set: molecular weight, ALogP (lipophilicity), polar surface area, hydrogen bond donors and acceptors, rotatable bonds and rule-of-five breaks. Narrow it to approved drugs or one kind of molecule, and sort by weight or ALogP.

**Inputs**

- Molecular weight at least (`min_molecular_weight`, number): In g/mol, of the parent compound (salts aside). From 0 to 5000.
- Molecular weight at most (`max_molecular_weight`, number): In g/mol, of the parent compound. Lipinski's limit is 500. From 0 to 5000.
- ALogP at least (`min_alogp`, number): Calculated lipophilicity (how fat-soluble), -20 to 20. From -20 to 20.
- ALogP at most (`max_alogp`, number): Calculated lipophilicity, -20 to 20. Lipinski's limit is 5. From -20 to 20.
- Polar surface area at most (`max_polar_surface_area`, number): In square angstroms. Under 140 suits oral drugs. From 0 to 1000.
- H-bond donors at most (`max_h_bond_donors`, number): Hydrogen bond donors. Lipinski's limit is 5. From 0 to 100.
- H-bond acceptors at most (`max_h_bond_acceptors`, number): Hydrogen bond acceptors. Lipinski's limit is 10. From 0 to 100.
- Rotatable bonds at most (`max_rotatable_bonds`, number): A measure of flexibility. Under 10 suits oral drugs. From 0 to 100.
- Rule-of-five breaks at most (`max_rule_of_five_violations`, number): How many of Lipinski's four limits it may break, 0 to 4. From 0 to 4.
- Development stage (`stage`, text): Only molecules that got this far. Leave empty for all. One of: `approved` (Approved drugs only), `phase_3` (Phase 3 or later), `phase_2` (Phase 2 or later), `phase_1` (Phase 1 or later), `clinical` (Any clinical stage).
- Molecule type (`molecule_type`, text): Only this kind of molecule. Leave empty for every kind. One of: `Small molecule`, `Protein`, `Antibody`, `Antibody drug conjugate` (Antibody-drug conjugate), `Oligonucleotide`, `Oligosaccharide`, `Enzyme`, `Gene`, `Cell`.
- Order (`order`, text): How to sort them. Leave empty for ChEMBL's own order. One of: `lightest` (Lightest first), `heaviest` (Heaviest first), `least_lipophilic` (Lowest ALogP first), `most_lipophilic` (Highest ALogP first).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `molecules` (list): The molecules in those ranges
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "molecules": [
    {
      "chembl_id": "CHEMBL25",
      "development_stage": "Approved",
      "first_approval": 1950,
      "formula": "C9H8O4",
      "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
      "max_phase": 4.0,
      "molecular_weight": 180.16,
      "molecule_type": "Small molecule",
      "name": "ASPIRIN",
      "properties": {
        "alogp": 1.31,
        "aromatic_rings": 1,
        "drug_likeness": 0.55,
        "formula": "C9H8O4",
        "h_bond_acceptors": 3,
        "h_bond_donors": 1,
        "heavy_atoms": 13,
        "molecular_weight": 180.16,
        "natural_product_likeness": 0.12,
        "parent_molecular_weight": 180.16,
        "polar_surface_area": 63.6,
        "rotatable_bonds": 2,
        "rule_of_five_violations": 0
      },
      "smiles": "CC(=O)Oc1ccccc1C(=O)O",
      "url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
    }
  ],
  "next_offset": null,
  "summary": "1 molecule in those ranges.",
  "total_count": 1
}
```

### Find molecules containing a structure

Find molecules that contain a given structure as part of theirs, such as every compound with a quinoline ring. Give the structure as SMILES (at least 5 characters), a ChEMBL ID or an InChIKey.

**Inputs**

- Structure (`structure`, text, required): The structure to search with: a SMILES string, a ChEMBL ID or an InChIKey.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `molecules` (list): The molecules containing the structure
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "molecules": [
    {
      "chembl_id": "CHEMBL25",
      "development_stage": "Approved",
      "first_approval": 1950,
      "formula": "C9H8O4",
      "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
      "max_phase": 4.0,
      "molecular_weight": 180.16,
      "molecule_type": "Small molecule",
      "name": "ASPIRIN",
      "smiles": "CC(=O)Oc1ccccc1C(=O)O",
      "url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
    }
  ],
  "next_offset": null,
  "summary": "1 molecule containing the structure.",
  "total_count": 1
}
```

### Find similar molecules

Find molecules whose structure is like a given one, most similar first, with how alike each is in percent. Give the structure as SMILES, a ChEMBL ID or an InChIKey.

**Inputs**

- Structure (`structure`, text, required): The structure to search with: a SMILES string, a ChEMBL ID or an InChIKey.
- Minimum similarity (%) (`similarity`, number): How alike a structure must be to count, 40 to 100 percent. 100 finds the same structure (and its salts). Defaults to 70. From 40 to 100.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `molecules` (list): The similar molecules
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "molecules": [
    {
      "chembl_id": "CHEMBL25",
      "development_stage": "Approved",
      "first_approval": 1950,
      "formula": "C9H8O4",
      "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
      "max_phase": 4.0,
      "molecular_weight": 180.16,
      "molecule_type": "Small molecule",
      "name": "ASPIRIN",
      "similarity": 100.0,
      "smiles": "CC(=O)Oc1ccccc1C(=O)O",
      "url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
    }
  ],
  "next_offset": null,
  "summary": "1 molecule at least 70% similar.",
  "total_count": 1
}
```

### Get assay

Get one assay: what it measured, its type, the organism, cell line or tissue it used, its target and how sure ChEMBL is of that target, its conditions and the paper it comes from.

**Inputs**

- Assay (`assay`, text, required): The assay's ChEMBL ID, such as CHEMBL846547, from a bioactivity or 'Search assays'.

**Outputs**

- `assay_category` (text): Its category, such as screening or confirmatory
- `assay_type` (text): B, F, A, T, P or U
- `assay_type_label` (text): Binding, Functional, ADME, Toxicity...
- `cell_chembl_id` (text): The cell line's ChEMBL ID
- `cell_type` (text): The cell type used
- `chembl_id` (text): The record's ChEMBL ID, such as CHEMBL25
- `classifications` (list): Its place in ChEMBL's assay classification
- `confidence_label` (text): The confidence score in words
- `confidence_score` (number): How sure the target mapping is, 0 to 9 (9 is surest)
- `description` (text): What the assay measured, as reported
- `document_chembl_id` (text): The paper or dataset it comes from
- `format` (text): The assay format, such as single protein format
- `organism` (text): The organism the assay used
- `parameters` (list): The assay's conditions
- `relationship_label` (text): How the target relates to what was tested
- `strain` (text): The strain used
- `subcellular_fraction` (text): The subcellular fraction used
- `summary` (text): One line: type, organism and description
- `target_chembl_id` (text): The target the assay is mapped to
- `tax_id` (number): That organism's NCBI taxonomy ID
- `test_type` (text): In vitro, in vivo or ex vivo
- `tissue` (text): The tissue used
- `tissue_chembl_id` (text): The tissue's ChEMBL ID
- `url` (text): The record's page on the ChEMBL website

**Example output**

```json
{
  "assay_category": null,
  "assay_type": "B",
  "assay_type_label": "Binding",
  "cell_chembl_id": null,
  "cell_type": null,
  "chembl_id": "CHEMBL846547",
  "classifications": [],
  "confidence_label": "Homologous single protein target assigned",
  "confidence_score": 8,
  "description": "Inhibition of v-Abl tyrosine kinase.",
  "document_chembl_id": "CHEMBL1130562",
  "format": "single protein format",
  "organism": null,
  "parameters": [
    {
      "comments": null,
      "relation": "=",
      "text_value": null,
      "type": "DOSE",
      "units": "mg.kg-1",
      "value": 30.0
    }
  ],
  "relationship_label": "Homologous protein target assigned",
  "strain": null,
  "subcellular_fraction": null,
  "summary": "CHEMBL846547: binding assay. Inhibition of v-Abl tyrosine kinase.",
  "target_chembl_id": "CHEMBL1862",
  "tax_id": null,
  "test_type": null,
  "tissue": null,
  "tissue_chembl_id": null,
  "url": "https://www.ebi.ac.uk/chembl/explore/assay/CHEMBL846547"
}
```

### Get database status

Get the ChEMBL release being served, when it came out, and how many molecules, activities, targets and documents it holds. Run it on a schedule to notice a new release.

**Inputs**: None.

**Outputs**

- `activities` (number): Measured bioactivities
- `compound_records` (number): Compound records, counting every source
- `documents` (number): Papers, patents and datasets
- `molecules` (number): Distinct compounds in the release
- `release_date` (text): When the release came out, as YYYY-MM-DD
- `release_number` (number): The release's number, such as 37
- `status` (text): UP when the service is running
- `summary` (text): One line: release, date and size
- `targets` (number): Targets
- `version` (text): The release being served, such as ChEMBL_37

**Example output**

```json
{
  "activities": 24527044,
  "compound_records": 3824604,
  "documents": 101100,
  "molecules": 2921148,
  "release_date": "2026-05-01",
  "release_number": 37,
  "status": "UP",
  "summary": "ChEMBL 37, released 2026-05-01: 2,921,148 molecules, 24,527,044 activities.",
  "targets": 18552,
  "version": "ChEMBL_37"
}
```

### Get document

Get one paper, patent or dataset: title, authors, journal, year, DOI, PubMed ID and abstract, with links.

**Inputs**

- Document (`document`, text, required): The document's ChEMBL ID, such as CHEMBL1130562, from a bioactivity, an assay or 'Search documents'.

**Outputs**

- `abstract` (text): The abstract
- `authors` (text): The authors
- `chembl_id` (text): The record's ChEMBL ID, such as CHEMBL25
- `doc_type` (text): PUBLICATION, PATENT, DATASET or BOOK
- `doi` (text): The DOI
- `doi_url` (text): A link to the DOI
- `first_page` (text): The first page
- `issue` (text): The journal issue
- `journal` (text): The journal's short name
- `journal_full_title` (text): The journal's full name
- `last_page` (text): The last page
- `patent_id` (text): The patent number, for a patent
- `pubmed_id` (number): The PubMed ID
- `pubmed_url` (text): A link to the PubMed record
- `summary` (text): One line: title, journal and year
- `title` (text): The title
- `url` (text): The record's page on the ChEMBL website
- `volume` (text): The journal volume
- `year` (number): The year it was published

**Example output**

```json
{
  "abstract": null,
  "authors": "Zimmermann J, Buchdunger E, Mett H, Meyer T, Lydon NB",
  "chembl_id": "CHEMBL1130562",
  "doc_type": "PUBLICATION",
  "doi": "10.1016/S0960-894X(96)00601-4",
  "doi_url": "https://doi.org/10.1016/S0960-894X(96)00601-4",
  "first_page": "187",
  "issue": "2",
  "journal": "Bioorg Med Chem Lett",
  "journal_full_title": "Bioorganic & medicinal chemistry letters.",
  "last_page": "192",
  "patent_id": null,
  "pubmed_id": null,
  "pubmed_url": null,
  "summary": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives (CHEMBL1130562), Bioorg Med Chem Lett, 1997.",
  "title": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives",
  "url": "https://www.ebi.ac.uk/chembl/explore/document/CHEMBL1130562",
  "volume": "7",
  "year": 1997
}
```

### Get molecule

Get everything ChEMBL holds on one molecule: its name and development stage, structure (SMILES, InChI, InChIKey), calculated properties such as molecular weight and ALogP, routes of administration, warnings, trade names, synonyms and ATC codes.

**Inputs**

- Molecule (`molecule`, text, required): The molecule's ChEMBL ID (such as CHEMBL25) or standard InChIKey. 'Search molecules' finds the ID from a name.

**Outputs**

- `atc_codes` (list): Its WHO ATC classification codes, such as N02BA01
- `black_box_warning` (true/false): Carries a black box warning on its label
- `chembl_id` (text): The record's ChEMBL ID, such as CHEMBL25
- `chemical_probe` (true/false): A recommended chemical probe for research
- `development_stage` (text): The furthest stage in words: Approved, Phase 3, Phase 2, Phase 1, Early phase 1, Clinical, phase unknown, or Preclinical
- `first_approval` (number): The year it was first approved, for a drug
- `first_in_class` (true/false): The first approved drug acting this way
- `max_phase` (number): The furthest stage reached: 4 approved, 3, 2 or 1 a clinical phase, 0.5 early phase 1, -1 clinical with the phase unknown; empty for preclinical
- `molecule_type` (text): Small molecule, Protein, Antibody, Oligonucleotide...
- `name` (text): ChEMBL's preferred name, such as ASPIRIN; empty for many compounds
- `natural_product` (true/false): A natural product or derived from one
- `oral` (true/false): Given by mouth, for an approved drug
- `orphan` (true/false): Approved for a rare disease (orphan designation)
- `parent_chembl_id` (text): The parent compound's ChEMBL ID; for a salt, the free base
- `parenteral` (true/false): Given by injection or infusion, for an approved drug
- `prodrug` (true/false): A prodrug, turned into the active compound in the body
- `properties` (object): Properties ChEMBL calculates from the structure
- `research_codes` (list): Development codes, such as STI-571
- `structure` (object): The molecule's structure, in three standard notations
- `summary` (text): One line: name, stage, type, approval year and formula
- `synonyms` (list): Every name ChEMBL knows it by
- `topical` (true/false): Applied to the skin or another surface, for an approved drug
- `trade_names` (list): Brand names it is sold under
- `url` (text): The record's page on the ChEMBL website
- `usan_stem` (text): The USAN naming stem, such as -tinib
- `usan_stem_definition` (text): What the stem means, such as kinase inhibitors
- `withdrawn` (true/false): Withdrawn from the market somewhere

**Example output**

```json
{
  "atc_codes": [
    "B01AC06",
    "N02BA01",
    "N02BA51",
    "A01AD05",
    "N02BA71"
  ],
  "black_box_warning": false,
  "chembl_id": "CHEMBL25",
  "chemical_probe": false,
  "development_stage": "Approved",
  "first_approval": 1950,
  "first_in_class": false,
  "max_phase": 4.0,
  "molecule_type": "Small molecule",
  "name": "ASPIRIN",
  "natural_product": true,
  "oral": true,
  "orphan": false,
  "parent_chembl_id": "CHEMBL25",
  "parenteral": false,
  "prodrug": false,
  "properties": {
    "alogp": 1.31,
    "aromatic_rings": 1,
    "drug_likeness": 0.55,
    "formula": "C9H8O4",
    "h_bond_acceptors": 3,
    "h_bond_donors": 1,
    "heavy_atoms": 13,
    "molecular_weight": 180.16,
    "natural_product_likeness": 0.12,
    "parent_molecular_weight": 180.16,
    "polar_surface_area": 63.6,
    "rotatable_bonds": 2,
    "rule_of_five_violations": 0
  },
  "research_codes": [
    "BAY1019036",
    "NSC-27223"
  ],
  "structure": {
    "inchi": "InChI=1S/C9H8O4/c1-6(10)13-8-5-3-2-4-7(8)9(11)12/h2-5H,1H3,(H,11,12)",
    "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
    "smiles": "CC(=O)Oc1ccccc1C(=O)O"
  },
  "summary": "ASPIRIN (CHEMBL25): approved small molecule, first approved in 1950. C9H8O4, 180.16 g/mol.",
  "synonyms": [
    "Acetylsalicylic acid",
    "Aspirin",
    "BAY1019036",
    "Durlaza",
    "NSC-27223",
    "Vazalore"
  ],
  "topical": false,
  "trade_names": [
    "Aspirin",
    "Durlaza",
    "Vazalore"
  ],
  "url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25",
  "usan_stem": null,
  "usan_stem_definition": null,
  "withdrawn": false
}
```

### Get target

Get one target: its name, type, organism, and the proteins it is made of with their UniProt accessions and gene symbols.

**Inputs**

- Target (`target`, text, required): The target's ChEMBL ID, such as CHEMBL203. 'Search targets' finds it from a name or gene.

**Outputs**

- `chembl_id` (text): The record's ChEMBL ID, such as CHEMBL25
- `components` (list): The proteins (or other parts) it is made of
- `gene_symbols` (list): The genes behind its proteins, such as EGFR
- `name` (text): The target's name, such as Epidermal growth factor receptor
- `organism` (text): The organism, such as Homo sapiens
- `species_group` (true/false): True when the target groups the same protein across species
- `summary` (text): One line: name, type, organism and gene
- `target_type` (text): SINGLE PROTEIN, PROTEIN COMPLEX, ORGANISM, CELL-LINE...
- `tax_id` (number): The organism's NCBI taxonomy ID, such as 9606
- `uniprot_accessions` (list): UniProt accessions of its proteins, such as P00533
- `url` (text): The record's page on the ChEMBL website

**Example output**

```json
{
  "chembl_id": "CHEMBL203",
  "components": [
    {
      "accession": "P00533",
      "component_type": "PROTEIN",
      "description": "Epidermal growth factor receptor",
      "gene_symbols": [
        "EGFR"
      ],
      "relationship": "SINGLE PROTEIN"
    }
  ],
  "gene_symbols": [
    "EGFR"
  ],
  "name": "Epidermal growth factor receptor",
  "organism": "Homo sapiens",
  "species_group": false,
  "summary": "Epidermal growth factor receptor (CHEMBL203): single protein in Homo sapiens, gene EGFR.",
  "target_type": "SINGLE PROTEIN",
  "tax_id": 9606,
  "uniprot_accessions": [
    "P00533"
  ],
  "url": "https://www.ebi.ac.uk/chembl/explore/target/CHEMBL203"
}
```

### List approved drugs

List approved drugs, one per active ingredient, most recently approved first: name, year of first approval, the companies behind it, ATC classes, routes, and any black box warning or withdrawal. Narrow it to a span of years or a naming stem such as -tinib.

**Inputs**

- First approved in or after (`approved_since`, number): A year, such as 2020. From 1900 to 2100.
- First approved in or before (`approved_until`, number): A year, such as 2024. From 1900 to 2100.
- Name stem (`usan_stem`, text): Only drugs whose name has this USAN stem, which says what kind of drug it is: -tinib (kinase inhibitors), -mab (antibodies), -vir (antivirals).
- Order (`order`, text): Defaults to the most recently approved first. One of: `newest` (Most recently approved first), `oldest` (Earliest approved first).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `drugs` (list): The approved drugs
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "drugs": [
    {
      "applicants": [
        "Novartis Pharmaceuticals Corp"
      ],
      "atc_classes": [
        {
          "code": "L01EA01",
          "description": "ANTINEOPLASTIC AND IMMUNOMODULATING AGENTS: ANTINEOPLASTIC AGENTS: PROTEIN KINASE INHIBITORS: BCR-ABL tyrosine kinase inhibitors"
        }
      ],
      "availability": "Prescription only",
      "black_box_warning": false,
      "chembl_id": "CHEMBL941",
      "first_approval": 2001,
      "first_in_class": true,
      "formula": "C29H31N7O",
      "molecular_weight": 493.62,
      "name": "Imatinib",
      "names": [
        "Imatinib (INN)",
        "Imatinib mesylate (EMA, FDA, USAN)"
      ],
      "oral": true,
      "parenteral": false,
      "prodrug": false,
      "research_codes": [
        "STI-571"
      ],
      "smiles": "Cc1ccc(NC(=O)c2ccc(CN3CCN(C)CC3)cc2)cc1Nc1nccc(-c2cccnc2)n1",
      "topical": false,
      "url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL941",
      "usan_stem": "-tinib",
      "usan_stem_definition": "tyrosine kinase inhibitors",
      "withdrawn": false
    }
  ],
  "next_offset": null,
  "summary": "1 approved drug.",
  "total_count": 1
}
```

### List ATC classes

Look up the WHO Anatomical Therapeutic Chemical (ATC) classes that sort drugs by organ system and use: every substance under a code (N02BA, salicylates) or the classes of a substance by name, each with all five levels spelled out.

**Inputs**

- ATC code (`code`, text): A code or the start of one: N (nervous system), N02 (analgesics), N02BA (salicylates) or N02BA01 (aspirin).
- Substance name (`drug_name`, text): Only classes for substances whose WHO name contains this, such as imatinib.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `classes` (list): The ATC classes
- `count` (number): How many are on this page
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "classes": [
    {
      "code": "N02BA01",
      "level1": "N",
      "level1_description": "NERVOUS SYSTEM",
      "level2": "N02",
      "level2_description": "ANALGESICS",
      "level3": "N02B",
      "level3_description": "OTHER ANALGESICS AND ANTIPYRETICS",
      "level4": "N02BA",
      "level4_description": "Salicylic acid and derivatives",
      "name": "acetylsalicylic acid",
      "path": "N NERVOUS SYSTEM > N02 ANALGESICS > N02B OTHER ANALGESICS AND ANTIPYRETICS > N02BA Salicylic acid and derivatives"
    }
  ],
  "count": 1,
  "next_offset": null,
  "summary": "1 ATC class.",
  "total_count": 1
}
```

### List bioactivities

List measured results (IC50, Ki, EC50, % inhibition...) for a molecule, a target, an assay or a paper, with the value, units and pChEMBL potency of each. Narrow them by measurement type, assay type or minimum potency, and sort the most potent first.

**Inputs**

- Molecule (`molecule`, text): Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Target (`target`, text): Only this target, by ChEMBL ID such as CHEMBL1862.
- Assay (`assay`, text): Only this assay, by ChEMBL ID such as CHEMBL846547.
- Document (`document`, text): Only results from this paper or dataset, by ChEMBL ID.
- Measurement type (`standard_type`, text): Only this kind of measurement, such as IC50 or Ki.
- Assay type (`assay_type`, text): Only this kind of assay. Leave empty for every kind. One of: `B` (Binding), `F` (Functional), `A` (ADME (absorption, distribution, metabolism, excretion)), `T` (Toxicity), `P` (Physicochemical), `U` (Unclassified).
- Minimum pChEMBL (`min_pchembl`, number): Only results at least this potent, as -log10 of the molar value: 6 is 1 uM, 9 is 1 nM. From 0 to 15.
- Most potent first (`most_potent_first`, true/false): Sort by potency, strongest first. Results without a pChEMBL value are left out.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `activities` (list): The measured results
- `count` (number): How many are on this page
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "activities": [
    {
      "activity_comment": null,
      "activity_id": 909963,
      "assay_chembl_id": "CHEMBL846547",
      "assay_description": "Inhibition of v-Abl tyrosine kinase.",
      "assay_type": "B",
      "assay_type_label": "Binding",
      "data_validity_comment": null,
      "document_chembl_id": "CHEMBL1130562",
      "document_journal": "Bioorg Med Chem Lett",
      "document_year": 1997,
      "measurement": "IC50 = 38 nM",
      "molecule_chembl_id": "CHEMBL941",
      "molecule_name": "IMATINIB",
      "parent_molecule_chembl_id": "CHEMBL941",
      "pchembl_value": 7.42,
      "relation": "=",
      "smiles": "Cc1ccc(NC(=O)c2ccc(CN3CCN(C)CC3)cc2)cc1Nc1nccc(-c2cccnc2)n1",
      "standard_type": "IC50",
      "target_chembl_id": "CHEMBL1862",
      "target_name": "Tyrosine-protein kinase ABL1",
      "target_organism": "Homo sapiens",
      "units": "nM",
      "value": 38.0
    }
  ],
  "count": 1,
  "next_offset": null,
  "summary": "1 activity.",
  "total_count": 1
}
```

### List drug indications

List the diseases a drug is approved or in clinical trials for, or the drugs for a disease (such as asthma), with the furthest stage reached for each.

**Inputs**

- Molecule (`molecule`, text): Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Disease (`disease`, text): Only indications whose disease name contains this.
- Development stage (`stage`, text): Only indications that got this far. Leave empty for all. One of: `approved` (Approved drugs only), `phase_3` (Phase 3 or later), `phase_2` (Phase 2 or later), `phase_1` (Phase 1 or later), `clinical` (Any clinical stage).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `indications` (list): The indications
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "indications": [
    {
      "development_stage": "Approved",
      "disease": "chronic myelogenous leukemia",
      "efo_id": "EFO:0000339",
      "max_phase": 4.0,
      "mesh_heading": "Leukemia, Myelogenous, Chronic, BCR-ABL Positive",
      "mesh_id": "D015464",
      "molecule_chembl_id": "CHEMBL1642",
      "parent_molecule_chembl_id": "CHEMBL941",
      "references": [
        {
          "reference": "setid=211ef2da-2868-4a77-8055-1cb2cd78e24b",
          "source": "DailyMed",
          "url": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=211ef2da-2868-4a77-8055-1cb2cd78e24b"
        }
      ]
    }
  ],
  "next_offset": null,
  "summary": "1 indication.",
  "total_count": 1
}
```

### List drug warnings

List black box warnings and market withdrawals, for one drug or across all drugs: the kind of harm, the country, the year and the source.

**Inputs**

- Molecule (`molecule`, text): Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Warning type (`warning_type`, text): Only this kind. Leave empty for both. One of: `Black Box Warning`, `Withdrawn` (Withdrawn from the market).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page
- `warnings` (list): The warnings

**Example output**

```json
{
  "count": 1,
  "next_offset": null,
  "summary": "1 warning.",
  "total_count": 1,
  "warnings": [
    {
      "adverse_effect": null,
      "country": "United States",
      "description": null,
      "molecule_chembl_id": "CHEMBL4303288",
      "parent_molecule_chembl_id": "CHEMBL1380",
      "references": [
        {
          "reference": "setid=211ef2da-2868-4a77-8055-1cb2cd78e24b",
          "source": "DailyMed",
          "url": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=211ef2da-2868-4a77-8055-1cb2cd78e24b"
        }
      ],
      "warning_class": "hepatotoxicity",
      "warning_type": "Black Box Warning",
      "year": null
    }
  ]
}
```

### List mechanisms of action

List how drugs act on their targets, such as 'Tyrosine-protein kinase ABL inhibitor', for a drug or for a target, with the action type and sources.

**Inputs**

- Molecule (`molecule`, text): Only this molecule (and its salts and other forms), by ChEMBL ID such as CHEMBL941.
- Target (`target`, text): Only this target, by ChEMBL ID such as CHEMBL1862.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `mechanisms` (list): The mechanisms of action
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "mechanisms": [
    {
      "action_type": "INHIBITOR",
      "binding_site_comment": null,
      "comment": null,
      "development_stage": "Approved",
      "direct_interaction": true,
      "disease_efficacy": true,
      "max_phase": 4.0,
      "mechanism_of_action": "Tyrosine-protein kinase ABL inhibitor",
      "molecule_chembl_id": "CHEMBL1642",
      "parent_molecule_chembl_id": "CHEMBL941",
      "references": [
        {
          "reference": "setid=211ef2da-2868-4a77-8055-1cb2cd78e24b",
          "source": "DailyMed",
          "url": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=211ef2da-2868-4a77-8055-1cb2cd78e24b"
        }
      ],
      "selectivity_comment": null,
      "target_chembl_id": "CHEMBL1862"
    }
  ],
  "next_offset": null,
  "summary": "1 mechanism.",
  "total_count": 1
}
```

### Look up ChEMBL ID

Find out what a ChEMBL ID names (a compound, target, assay, document, cell line or tissue), whether it is still in use, and its page on the ChEMBL website. An unknown ID comes back with 'found' set to false rather than failing the step.

**Inputs**

- ChEMBL ID (`chembl_id`, text, required): Any ChEMBL ID, such as CHEMBL25 or CHEMBL1862.

**Outputs**

- `chembl_id` (text): The record's ChEMBL ID, such as CHEMBL25
- `entity_type` (text): COMPOUND, TARGET, ASSAY, DOCUMENT, CELL or TISSUE
- `found` (true/false): True when ChEMBL has a record with this ID
- `status` (text): ACTIVE, INACTIVE or OBS (obsolete)
- `summary` (text): One line saying what the ID names
- `url` (text): The record's page on the ChEMBL website

**Example output**

```json
{
  "chembl_id": "CHEMBL25",
  "entity_type": "COMPOUND",
  "found": true,
  "status": "ACTIVE",
  "summary": "CHEMBL25 is a compound.",
  "url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
}
```

### Search assays

Find assays (the experiments behind each measurement) by words in their description, such as 'hERG inhibition', optionally of one type: binding, functional, ADME, toxicity.

**Inputs**

- Search for (`query`, text, required): Words from the assay's description.
- Assay type (`assay_type`, text): Only this kind of assay. Leave empty for every kind. One of: `B` (Binding), `F` (Functional), `A` (ADME (absorption, distribution, metabolism, excretion)), `T` (Toxicity), `P` (Physicochemical), `U` (Unclassified).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `assays` (list): The assays that matched
- `count` (number): How many are on this page
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "assays": [
    {
      "assay_category": null,
      "assay_type": "B",
      "assay_type_label": "Binding",
      "cell_chembl_id": null,
      "cell_type": null,
      "chembl_id": "CHEMBL846547",
      "classifications": [],
      "confidence_label": "Homologous single protein target assigned",
      "confidence_score": 8,
      "description": "Inhibition of v-Abl tyrosine kinase.",
      "document_chembl_id": "CHEMBL1130562",
      "format": "single protein format",
      "organism": null,
      "parameters": [
        {
          "comments": null,
          "relation": "=",
          "text_value": null,
          "type": "DOSE",
          "units": "mg.kg-1",
          "value": 30.0
        }
      ],
      "relationship_label": "Homologous protein target assigned",
      "score": 21.0,
      "strain": null,
      "subcellular_fraction": null,
      "summary": "CHEMBL846547: binding assay. Inhibition of v-Abl tyrosine kinase.",
      "target_chembl_id": "CHEMBL1862",
      "tax_id": null,
      "test_type": null,
      "tissue": null,
      "tissue_chembl_id": null,
      "url": "https://www.ebi.ac.uk/chembl/explore/assay/CHEMBL846547"
    }
  ],
  "count": 1,
  "next_offset": null,
  "summary": "1 assay matching 'abl kinase'.",
  "total_count": 1
}
```

### Search cell lines

Find the cell lines ChEMBL's assays use, by name (HeLa), tissue (lung) or organism, with their Cellosaurus and ontology IDs. Leave every field empty to list them all, by name.

**Inputs**

- Name (`name`, text): Only cell lines whose name contains this.
- Tissue (`tissue`, text): Only cell lines from a tissue whose name contains this.
- Organism (`organism`, text): Only cell lines from this organism, by Latin name.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `cell_lines` (list): The cell lines that matched
- `count` (number): How many are on this page
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "cell_lines": [
    {
      "cellosaurus_id": "CVCL_0030",
      "chembl_id": "CHEMBL3308376",
      "clo_id": "CLO_0003684",
      "description": "HeLa (Cervical adenocarcinoma cells)",
      "efo_id": "EFO_0001185",
      "name": "HeLa",
      "organism": "Homo sapiens",
      "tax_id": 9606,
      "tissue": "Cervical adenocarcinoma",
      "url": "https://www.ebi.ac.uk/chembl/explore/cell_line/CHEMBL3308376"
    }
  ],
  "count": 1,
  "next_offset": null,
  "summary": "1 cell line.",
  "total_count": 1
}
```

### Search documents

Find the papers, patents and datasets ChEMBL's data come from by words in their title or abstract, optionally of one type or published since a year.

**Inputs**

- Search for (`query`, text, required): Words from the title or abstract.
- Document type (`doc_type`, text): Only this kind of document. Leave empty for every kind. One of: `PUBLICATION` (Journal article), `PATENT`, `DATASET` (Deposited dataset), `BOOK`.
- Published in or after (`published_since`, number): A year, such as 2015. From 1900 to 2100.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `documents` (list): The documents that matched
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "documents": [
    {
      "abstract": null,
      "authors": "Zimmermann J, Buchdunger E, Mett H, Meyer T, Lydon NB",
      "chembl_id": "CHEMBL1130562",
      "doc_type": "PUBLICATION",
      "doi": "10.1016/S0960-894X(96)00601-4",
      "doi_url": "https://doi.org/10.1016/S0960-894X(96)00601-4",
      "first_page": "187",
      "issue": "2",
      "journal": "Bioorg Med Chem Lett",
      "journal_full_title": "Bioorganic & medicinal chemistry letters.",
      "last_page": "192",
      "patent_id": null,
      "pubmed_id": null,
      "pubmed_url": null,
      "score": 12.0,
      "summary": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives (CHEMBL1130562), Bioorg Med Chem Lett, 1997.",
      "title": "Potent and selective inhibitors of the Abl-kinase: phenylamino-pyrimidine (PAP) derivatives",
      "url": "https://www.ebi.ac.uk/chembl/explore/document/CHEMBL1130562",
      "volume": "7",
      "year": 1997
    }
  ],
  "next_offset": null,
  "summary": "1 document matching 'abl kinase'.",
  "total_count": 1
}
```

### Search molecules

Find molecules by name, trade name, synonym or research code (aspirin, Gleevec, STI-571), best match first, optionally only approved drugs or those that reached a clinical phase. Each result has its ChEMBL ID, stage, formula and structure.

**Inputs**

- Search for (`query`, text, required): A name, trade name, synonym or research code, such as aspirin, Gleevec or STI-571.
- Development stage (`stage`, text): Only molecules that got this far. Leave empty for all. One of: `approved` (Approved drugs only), `phase_3` (Phase 3 or later), `phase_2` (Phase 2 or later), `phase_1` (Phase 1 or later), `clinical` (Any clinical stage).
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `molecules` (list): The molecules that matched
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "molecules": [
    {
      "chembl_id": "CHEMBL25",
      "development_stage": "Approved",
      "first_approval": 1950,
      "formula": "C9H8O4",
      "inchi_key": "BSYNRYMUTXBXSQ-UHFFFAOYSA-N",
      "max_phase": 4.0,
      "molecular_weight": 180.16,
      "molecule_type": "Small molecule",
      "name": "ASPIRIN",
      "score": 36.0,
      "smiles": "CC(=O)Oc1ccccc1C(=O)O",
      "url": "https://www.ebi.ac.uk/chembl/explore/compound/CHEMBL25"
    }
  ],
  "next_offset": null,
  "summary": "1 molecule matching 'aspirin'.",
  "total_count": 1
}
```

### Search targets

Find drug targets (proteins, complexes, organisms, cell lines) by name, gene symbol or UniProt accession, best match first, optionally of one type or in one organism.

**Inputs**

- Search for (`query`, text, required): A target name, gene symbol or UniProt accession, such as EGFR or P00533.
- Target type (`target_type`, text): Only this kind of target. Leave empty for every kind. One of: `SINGLE PROTEIN`, `PROTEIN COMPLEX`, `PROTEIN FAMILY`, `PROTEIN-PROTEIN INTERACTION`, `SELECTIVITY GROUP`, `NUCLEIC-ACID` (Nucleic acid), `ORGANISM`, `CELL-LINE` (Cell line), `TISSUE`.
- Organism (`organism`, text): Only targets in this organism, by Latin name.
- Page size (`limit`, number): How many to return, 1 to 100. Defaults to 20. From 1 to 100.
- Offset (`offset`, number): How many to skip, for the next page: pass the 'next_offset' of the page before. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many are on this page
- `next_offset` (number): Pass as 'Offset' to get the next page; empty on the last page
- `summary` (text): One line saying how many matched and which are shown
- `targets` (list): The targets that matched
- `total_count` (number): How many match in all, across every page

**Example output**

```json
{
  "count": 1,
  "next_offset": null,
  "summary": "1 target matching 'EGFR'.",
  "targets": [
    {
      "chembl_id": "CHEMBL203",
      "gene_symbols": [
        "EGFR"
      ],
      "name": "Epidermal growth factor receptor",
      "organism": "Homo sapiens",
      "score": 11.0,
      "target_type": "SINGLE PROTEIN",
      "tax_id": 9606,
      "uniprot_accessions": [
        "P00533"
      ],
      "url": "https://www.ebi.ac.uk/chembl/explore/target/CHEMBL203"
    }
  ],
  "total_count": 1
}
```
