GreenCycle Compound Atlas

Search the whole GreenCycle Compound Atlas by any name: cannabis compounds (THC, CBD, CBG, terpenes, flavonoids), receptors and enzymes (CB1, CB2, TRPV1, 5-HT1A, FAAH), medical conditions with an evidence grade (epilepsy, chronic pain, sleep) and registered clinical trials. Returns results with id, title and url; pass an id to fetch for the full sourced record. Educational reference, not medical advice.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Any name or words, for example \"cannabidiol\", \"CB1\", \"myrcene\", \"epilepsy\" or \"chronic pain trial\".",
      "maxLength": 120
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

The full text of one atlas record by the id that search returned ("compound:cbd", "target:CB1", "condition:epilepsy", "trial:NCT03883360", "cultivar:STRAIN0001"): what it is, the targets and effects with evidence grades, measured binding values, cautions, every source (PubMed ids with links) and the citation line, with the atlas url. Educational reference, not medical advice. No doses.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A record id from search, for example \"compound:cbd\".",
      "maxLength": 120
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Use for lists of cannabis compounds: find the compounds mapped onto the human body (curated atlas records and database compounds with a measured, sourced value at a target placed in tissue) by name, chemical class, record type or molecular target (for example every compound acting at CB2, TRPV1, 5-HT1A or FAAH, or every terpene). Returns identity, PubChem CID, record type, targets and the atlas url. Use get_compound for one full record. Educational reference, not medical advice.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Part of a name or identifier, for example \"cannabidiol\", \"CBD\", \"thymol\" or \"CDB000032\". Leave out to list all.",
      "maxLength": 120
    },
    "class": {
      "type": "string",
      "enum": [
        "cannabinoid",
        "terpene",
        "flavonoid",
        "metabolite",
        "phenolic",
        "fatty"
      ],
      "description": "Chemical class."
    },
    "recordType": {
      "type": "string",
      "enum": [
        "curated",
        "database"
      ],
      "description": "curated (atlas records with reviewed effects and grades) or database (compounds with a measured value at a placed target)."
    },
    "target": {
      "type": "string",
      "description": "A receptor, channel or enzyme by name or gene, for example \"CB2\", \"CNR1\" or \"PPAR-gamma\".",
      "maxLength": 120
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "How many items to return, at most 100."
    }
  },
  "additionalProperties": false
}

Use for "what does THC, CBD or myrcene do in the body": the full record of one mapped compound by atlas id, Cannabis Compound Database id, name or PubChem CID. A curated record gives identity and structure identifiers, every target with the action, effect, evidence grade, body structures and PubMed identifiers, the measured binding values (pKi, pIC50, pEC50) from the IUPHAR/BPS Guide to PHARMACOLOGY, the cultivars a laboratory measured it in with their sources, an evidence summary, its cautions and a ready citation. A database compound gives its identity and every measured value at a placed target with its PubMed id or DOI. Educational reference, not medical advice. No doses.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Atlas id (\"thc\", \"bcp\"), database id (\"CDB000032\"), name (\"Beta-caryophyllene\", \"Thymol\") or PubChem CID (16078 or \"CID 16078\").",
      "maxLength": 120
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Use for "THC versus CBD" and similar questions: two to four compounds side by side, target by target, with each action, evidence grade, measured binding values and PubMed identifiers, the targets they share and the atlas comparison page when one exists. Educational reference, not medical advice. Not a ranking of which is better for anyone.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "minItems": 2,
      "maxItems": 4,
      "items": {
        "type": "string",
        "maxLength": 120
      },
      "description": "Two to four compound ids or names, for example [\"thc\", \"cbd\"]."
    }
  },
  "required": [
    "ids"
  ],
  "additionalProperties": false
}

Use for receptor questions: one receptor, ion channel or enzyme by name or gene (for example CB1, CNR1, TRPV1, GPR55, FAAH, CYP3A4): what it is, where it sits in the body, the compounds mapped to it with their action, effect and evidence grade, and every measured binding or functional value with species and PubMed identifiers. Educational reference, not medical advice.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Target id, name or gene.",
      "maxLength": 120
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Use for "where in the body": the atlas body structures (organs and regions) that carry a molecular target: for CB1 and CB2 the qualitative receptor density (0 to 4, a teaching summary of the literature, not a measurement), other receptors listed for a structure, and the structures where a compound effect at this target is mapped, with the compound and its evidence grade. Educational reference, not medical advice.

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "description": "Target id, name or gene, for example \"CB1\" or \"TRPV1\".",
      "maxLength": 120
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 99,
      "default": 40,
      "description": "How many items to return, at most 99."
    }
  },
  "required": [
    "target"
  ],
  "additionalProperties": false
}

Use for "what is the evidence" and "which studies": the PubMed studies the atlas cites for a compound, a target, a condition or a compound at one target, each with its PubMed link, what it supports (an effect at a target, a binding value, a caution, a systematic review or a trial as administered) and the atlas record it belongs to, plus the PubMed search behind each record. Doses are left out on purpose. Educational reference, not medical advice.

{
  "type": "object",
  "properties": {
    "compound": {
      "type": "string",
      "description": "A compound id or name, for example \"cbd\".",
      "maxLength": 120
    },
    "target": {
      "type": "string",
      "description": "A target, for example \"TRPV1\".",
      "maxLength": 120
    },
    "condition": {
      "type": "string",
      "description": "A condition, for example \"epilepsy\".",
      "maxLength": 120
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "How many items to return, at most 50."
    }
  },
  "additionalProperties": false
}

Use for "does cannabis help with ...": conditions on the atlas evidence ladder (substantial, moderate, limited, insufficient, evidence of no benefit): the grade and why, the systematic reviews and trials behind it by PubMed identifier, the compounds and body structures involved and the atlas page. Trials are kept as administered in each trial; doses are left out on purpose. Educational reference, not medical advice. Not a diagnostic or dosing tool.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Part of a condition name, for example \"epilepsy\", \"pain\" or \"sleep\". Leave out to list all.",
      "maxLength": 120
    },
    "grade": {
      "type": "string",
      "enum": [
        "substantial",
        "moderate",
        "limited",
        "insufficient",
        "against"
      ],
      "description": "Only conditions with this evidence grade."
    }
  },
  "additionalProperties": false
}

Use for clinical trial questions: registered trials from the atlas snapshot of ClinicalTrials.gov (trials whose intervention is named cannabis, a cannabinoid, cannabidiol, THC or a related medicine): identifier, title, status, phase, enrolment, conditions, countries, start date, the atlas compounds involved and the registry link, newest snapshot first. Intervention names that state an amount are left out. Titles are third party text. Educational reference, not medical advice.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Words in the title, the conditions or the MeSH terms, for example \"epilepsy\" or \"chronic pain\".",
      "maxLength": 120
    },
    "status": {
      "type": "string",
      "enum": [
        "RECRUITING",
        "NOT_YET_RECRUITING",
        "ENROLLING_BY_INVITATION",
        "ACTIVE_NOT_RECRUITING",
        "COMPLETED",
        "TERMINATED",
        "SUSPENDED",
        "WITHDRAWN",
        "UNKNOWN",
        "AVAILABLE",
        "NO_LONGER_AVAILABLE",
        "APPROVED_FOR_MARKETING"
      ],
      "description": "Overall status as registered."
    },
    "phase": {
      "type": "string",
      "enum": [
        "EARLY_PHASE1",
        "PHASE1",
        "PHASE2",
        "PHASE3",
        "PHASE4",
        "NA"
      ],
      "description": "Phase as registered."
    },
    "compound": {
      "type": "string",
      "description": "Atlas compound id or name, for example \"cbd\".",
      "maxLength": 120
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "How many items to return, at most 25."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 5000,
      "default": 0,
      "description": "Skip this many matching trials (for paging)."
    }
  },
  "additionalProperties": false
}

Use for strain chemistry: one cultivar from the laboratory measurements the atlas uses (Cannabis Compound Database values, mg per gram of dry flower), by CCD id or name: every atlas compound measured in it with the mean, the number of values and the PubMed identifier of each source. Cultivar names are a poor guide to chemistry (PMID 35588111, PMID 39137353); never the community strain index. Educational reference, not medical advice.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "CCD cultivar id (\"STRAIN0001\") or name (\"8-Ball Kush\").",
      "maxLength": 120
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

A ready citation for one atlas record (compound, target or condition) or for the atlas as a whole: the canonical url, the citation line, a BibTeX entry, the version, the original papers to cite for its findings (PubMed links) and the licence (CC BY 4.0 with attribution).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A record id or name, for example \"compound:cbd\", \"CB1\" or \"epilepsy\". Leave out to cite the atlas.",
      "maxLength": 120
    }
  },
  "additionalProperties": false
}

The latest releases of the atlas data files: the version to cite, which datasets changed, records added and removed, and where the dated copy of each release lives.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 3,
      "description": "How many items to return, at most 20."
    }
  },
  "additionalProperties": false
}