node-cannabis-reports API documentation

Strains

Strain object

Cannabis strains in the Cannabis Reports system.

Cannabis strains are the various cultivars available for the cannabis family. Thousands of years of human domestication and breeding of cannabis strains have resulted in a huge variety of attributes that we know and love today.

http://en.wikipedia.org/wiki/Cultivar

Over time, strain names have been used by various companies in their attempts to recreate the results of other breeders. Cannabis Reports identifies strains not only by their name, but by their seed company as well, to ensure they are all properly represented.

Strain Attributes

NameTypeDescription
namestringName of the cannabis strain.
ucpcstringUCPC code for this strain.
linkurlLink to the strain in the Cannabis Reports API.
qrurlLink to the QR code for this strain.
urlurlLink to the strain listing on the Cannabis Reports website.
imageurlLink to the full size image for this strain on Cannabis Reports.
seedCompanyobjectInformation about the seed company that created or provides the strain.
seedCompany.namestringName of the seed company for the strain.
seedCompany.ucpcstringUCPC for the seed company.
seedCompany.linkurlLink to the seed company for the strain in the Cannabis Reports API.
geneticsobjectObject that holds information about the genetics for the strain.
genetics.namesstringThe textual representation of the genetics for a strain.
genetics.ucpcstringThe genetics of a strain with UCPC codes instead of names. Delimiters in the genetic string are parentheses (), lower case "x", common slash /, and question mark ?. These characters will never be included within the UCPC.
genetics.linkurlLink to the genetics for the strain in the Cannabis Reports API.
lineageobjectCountries of origin for the genetics for the strain. Object keys are the country name and the values are the two character country codes.
childrenobjectObject that holds information about the children for the strain.
children.countintegerNumber of strains this one has been bred into.
children.linkurlLink to the children for the strain in the Cannabis Reports API.
reviewsobjectObject that holds information about the reviews for the strain.
reviews.countintegerNumber of reviews for the strain.
reviews.linkurlLink to the reviews for the strain in the Cannabis Reports API.
createdAtobjectObject containing two strings, "dateTime" and the "timezone" when the strain was added.
updatedAtobjectObject containing two strings, "dateTime" and the "timezone" when the strain was updated.

Where's Indica, Sativa, Hybrid?

Mainstream cannabis science does not subscribe to what has become a common classification scheme for identifying cannabis strains. There are differing opinions on the appropriate taxonomy of cannabis in the scientific community. Until there is consensus, Cannabis Reports does not participate in this type of classification.

Cannabis consumers have become used to associating feelings to these words which were previously used to describe physical or genetic characteristics of a plant.

To this effect, we have given producers the ability to classify their products as indica, sativa, and hybrid as it has become part of the common vocabulary. We have also allowed for strains to be listed on menus in ways that consumers have grown accustomed to, with most strains ending up in the "hybrid" category.

Where are the THC, CBD, and Other Percentages for Strains?

Results from cannabis labs on the percentage of THC and CBD content are based upon samples of the overall harvest for particular strains.

The cannabis plant contains hundreds of chemicals that interact together to provide the experience you have when you consume it. Science has shown that genetics of a strain can determine whether the disposition exists to produce the chemicals we measure for. However, the overall abundance of them in what you are consuming can vary depending on many factors:

  1. Skill of producer.
  2. Environment.
  3. Genetic phenotypes from seeds.
  4. Part of plant consumed.
  5. Processing.

Cannabis Reports lets producers tie lab tests to individual products, batches of products, or flowers. For the overall information of a cannabis strain, however, we recognize that the actual results can vary from crop to crop.

Explore Strain Endpoints

Here are some of the results available from the different strain endpoints

EndpointResult

Gets a paginated list of strains with optional sorting.

Returns search results for strains in our database.

Gets an individual strain based on the UCPC.

Gets the reviews for a cannabis strain.

Gets the average effects and flavors from reviews for this strain.

Gets the seed company that was responsible for a cannabis strain.

Gets the strains that were the parent material for the strain with the given UCPC.

Gets the child strains that this one has been bred into.

Gets information about the availability of a strain using latitude and longitude.

get

get

Gets a paginated list of strains with optional sorting.

get

The strain search API can be used to find strains by name. Search with at least 2 characters and get an array of strains to work with.

get

Returns search results for strains in our database.

Returns search results for strains in our database.

URI Parameters

  • query: required (string)

    Search query to find strains in our system. Must be at least 2 characters.

    Example:

    Blue

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Blue",
      "ucpc": "L2KQMTUFDH000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/L2KQMTUFDH000000000000000",
      "qr": "https://www.cannabisreports.com/strain-reports/thc-seeds/blue/qr-code.svg",
      "url": "https://www.cannabisreports.com/strain-reports/thc-seeds/blue",
      "image": "https://www.cannabisreports.com/images/strains/c/full_c49ce8f893df7bd23711d6deb29a5159fca97b37.jpg",
      "seedCompany": {
        "name": "THC Seeds",
        "ucpc": "L2KQM00000000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/L2KQM00000000000000000000"
      },
      "genetics": {
        "names": false,
        "ucpc": false,
        "link": false
      },
      "lineage": [],
      "children": {
        "count": 0,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/L2KQMTUFDH000000000000000/children"
      },
      "reviews": {
        "count": 0,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/L2KQMTUFDH000000000000000/reviews"
      },
      "createdAt": {
        "datetime": "2008-08-15 19:20:00",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-06-08 03:36:59",
        "timezone": "UTC"
      }
    },
    { ... }
  ],
  "meta": {
    "pagination": {
      "total": 232,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 24,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/strains/search/Blue?q=Blue&page=2"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid query. Query must be at least two characters.",
  "status_code": 400
}

get

get

Gets an individual strain based on the UCPC.

Gets an individual strain based on the UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Jack Herer",
    "ucpc": "VUJCJ4TYMG000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJ4TYMG000000000000000",
    "qr": "https://www.cannabisreports.com/strain-reports/sensi-seeds/jack-herer/qr-code.svg",
    "url": "https://www.cannabisreports.com/strain-reports/sensi-seeds/jack-herer",
    "image": "https://www.cannabisreports.com/images/strains/a/full_ae82eef3bb2b7694df7f8bfa0da22a5d2b0f3689.jpg",
    "seedCompany": {
      "name": "Sensi Seeds",
      "ucpc": "VUJCJ00000000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000"
    },
    "genetics": {
      "names": "(Northern Lights #5 x Skunk #1) x Haze",
      "ucpc": "(VUJCJ4MPQ2000000000000000 x VUJCJY6ZUC000000000000000) x 9XVU7WJQCD000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJ4TYMG000000000000000/genetics"
    },
    "lineage": {
      "Afghanistan": "AF",
      "Colombia": "CO",
      "India": "IN",
      "Mexico": "MX",
      "Thailand": "TH"
    },
    "children": {
      "count": 94,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJ4TYMG000000000000000/children"
    },
    "reviews": {
      "count": 3,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJ4TYMG000000000000000/reviews"
    },
    "createdAt": {
      "datetime": "2008-08-15 19:20:00",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-03-11 23:10:50",
      "timezone": "UTC"
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

get

get

Get the user who added the strain to the database.

Get the user who added the strain to the database.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "nickname": "David",
    "link": "https://www.cannabisreports.com/api/v1.0/users/david",
    "tagline": "The Original Smoke Reporter",
    "url": "https://www.cannabisreports.com/user/profile/david",
    "slug": "david",
    "createdAt": {
      "datetime": "2008-08-15 16:20:00",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-05-06 22:10:18",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

get

get

Get the reviews for a cannabis strain.

Get the reviews for a cannabis strain.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "link": "https://www.cannabisreports.com/api/v1.0/reviews/323d4a3364f9d218ae13f71364b2297462878270",
      "url": "https://www.cannabisreports.com/smoke-reports/2010/11/06/323d4a3364f9d218ae13f71364b2297462878270/smokinmama",
      "euphoria": "7",
      "creativity": null,
      "pain_relief": null,
      "appetite_gain": "4",
      "calming": null,
      "anxiety": "3",
      "spicy": "7",
      "earthy": "7",
      "fruity": "2",
      "sour": "3",
      "dry_mouth": null,
      "createdAt": {
        "datetime": "2010-11-06 15:35:47",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-05-16 01:53:28",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 3,
      "count": 3,
      "per_page": 20,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

get

get

Get the average effects and flavors from reviews for this strain.

Get the average effects and flavors from reviews for this strain.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "euphoria": "8.3333",
    "creativity": "9.0000",
    "calming": "6.0000",
    "numbness": "7.6667",
    "appetite_gain": "5.0000",
    "dry_mouth": "5.0000",
    "fruity": "5.0000",
    "spicy": "5.5000",
    "earthy": "5.5000",
    "sour": "5.5000",
    "sweet": "7.0000",
    "pine": "4.0000",
    "anxiety": "3.5000",
    "reviews": 3
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

get

get

Get the seed company that was responsible for a cannabis strain.

Get the seed company that was responsible for a cannabis strain.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Sensi Seeds",
    "ucpc": "VUJCJ00000000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000",
    "qr": "https://www.cannabisreports.com/strain-reports/sensi-seeds/qr-code.svg",
    "url": "https://www.cannabisreports.com/strain-reports/sensi-seeds",
    "image": "https://www.cannabisreports.com/images/profile/1/full_15fda07a135540c1de6afbb38dafe2113a11a7a4.jpg",
    "lineage": {
      "Afghanistan": "AF",
      "Canada": "CA",
      "Colombia": "CO",
      "Hungary": "HU",
      "India": "IN",
      "Indonesia": "ID",
      "Jamaica": "JM",
      "Malawi": "MW",
      "Mexico": "MX",
      "Nepal": "NP",
      "Nigeria": "NG",
      "Pakistan": "PK",
      "Panama": "PA",
      "South Africa": "ZA",
      "Thailand": "TH",
      "United States": "US"
    },
    "strains": {
      "count": 63,
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000/strains"
    },
    "reviews": {
      "count": 25,
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000/reviews"
    },
    "createdAt": {
      "datetime": "2014-04-09 09:29:57",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-01-08 20:05:52",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

get

More information on how to read and understand cannabis genetics can be found in our FAQ:

https://www.cannabisreports.com/faq/cannabis-genetics/how-do-you-read-cannabis-genetics

This goes up the genetic family tree looking for the parents of the strain. If you'd like to check out the children of a strain, see the documentation for /strain/:ucpc/children.

get

Gets the strains that were the parent material for the strain with the given UCPC.

Gets the strains that were the parent material for the strain with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Afghani No. 1",
      "ucpc": "D4C6CMREWV000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/D4C6CMREWV000000000000000",
      "qr": "https://www.cannabisreports.com/strain-reports/sacred-seeds/afghani-no-1/qr-code.svg",
      "url": "https://www.cannabisreports.com/strain-reports/sacred-seeds/afghani-no-1",
      "image": "https://www.cannabisreports.com/images/strains/landraces/full-afghani-no-1.png",
      "seedCompany": {
        "name": "Sacred Seeds",
        "ucpc": "D4C6C00000000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/D4C6C00000000000000000000"
      },
      "genetics": {
        "names": "Landraces",
        "ucpc": "9XVU7R9C3R000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/D4C6CMREWV000000000000000/genetics"
      },
      "lineage": {
        "Afghanistan": "AF"
      },
      "children": {
        "count": 19,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/D4C6CMREWV000000000000000/children"
      },
      "reviews": {
        "count": 1,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/D4C6CMREWV000000000000000/reviews"
      },
      "createdAt": {
        "datetime": "2008-08-15 19:20:00",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-06-18 18:32:30",
        "timezone": "UTC"
      }
    },
    {...}
  ]
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

get

This will provide a paginated list of children that this strain was a parent of. Some strains have been bred into hundreds of other ones.

For the parents of this strain, check out the /strain/:ucpc/genetics documentation.

get

Get the child strains that this one has been bred into.

Get the child strains that this one has been bred into.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Jack Flash",
      "ucpc": "VUJCJEZHC6000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJEZHC6000000000000000",
      "qr": "https://www.cannabisreports.com/strain-reports/sensi-seeds/jack-flash/qr-code.svg",
      "url": "https://www.cannabisreports.com/strain-reports/sensi-seeds/jack-flash",
      "image": "https://www.cannabisreports.com/images/strains/5/full_5b7bacfc57a26d02ba3f7ee85c46d70f845868ee.jpg",
      "seedCompany": {
        "name": "Sensi Seeds",
        "ucpc": "VUJCJ00000000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000"
      },
      "genetics": {
        "names": "Jack Herer x (Super Skunk x Haze)",
        "ucpc": "VUJCJ4TYMG000000000000000 x (2NGAWPEK4A000000000000000 x 9XVU7WJQCD000000000000000)",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJEZHC6000000000000000/genetics"
      },
      "lineage": {
        "Afghanistan": "AF",
        "Colombia": "CO",
        "India": "IN",
        "Mexico": "MX",
        "Thailand": "TH"
      },
      "children": {
        "count": 3,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJEZHC6000000000000000/children"
      },
      "reviews": {
        "count": 0,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJEZHC6000000000000000/reviews"
      },
      "createdAt": {
        "datetime": "2008-08-15 19:20:00",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-06-07 13:04:14",
        "timezone": "UTC"
      }
    },
    { ... }
  ],
  "meta": {
    "pagination": {
      "total": 94,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 10,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJ4TYMG000000000000000/children?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

get

This will provide a paginated list of item summary objects for this particular strain.

get

Get information about the availability of a strain using latitude and longitude.

Get information about the availability of a strain using latitude and longitude.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis strain you want information about.

    Example:

    VUJCJ4TYMG000000000000000
  • lat: required (string)

    Latitude for the center of your availability search.

    Example:

    37.7749295
  • lng: required (string)

    Longitude for the center of your availability search.

    Example:

    -122.4194155
  • radius: required (integer)

    Radius to search for in miles, max 25.

    Example:

    10

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Jack Herer",
      "ucpc": "VUJCJ4TYMG000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJ4TYMG000000000000000",
      "type": "strain",
      "location": {
        "name": "Love Shack Cooperative",
        "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/love-shack-cooperative",
        "lat": "37.7681384",
        "lng": "-122.4246791"
      },
      "price": null,
      "price_half_gram": null,
      "price_gram": "10.00",
      "price_eighth": "35.00",
      "price_quarter": "70.00",
      "price_half_ounce": "135.00",
      "price_ounce": "265.00",
      "createdAt": {
        "datetime": "2014-05-20 18:31:40",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-05-21 04:56:23",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 10,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

Flowers

Flower object

Cannabis flowers in the Cannabis Reports system.

Cannabis flowers are distinct products that can be found on retailer menus. The Cannabis Reports system allows for specific batches of cannabis flowers to be linked directly to the cultivator that grew the plant, while still maintaining a connection to the original genetics of the strain. Designating flowers as distinct items improves our ability to discuss the variety of flower quality that can be produced from the same strain grown at different farms.

The main forms of flowers that Cannabis Reports recognizes are:

  • Flowers
  • Seeds
  • Clones
  • Shake

Producers measure the cannabinoid content of their flowers in many ways. Currently, Cannabis Reports allows producers to display the percentage of weight for THC and CBD.

NameTypeDescription

name

string

Name of the flower.

ucpc

string

UCPC code for this flower.

link

url

Link to the flower in the Cannabis Reports API.

qr

url

Link to the QR code for this flower.

barcode

url

Link to the barcode for this flower.

url

url

Link to the flower listing on the Cannabis Reports website.

image

url

Link to the full size image for this flower.

producer

object

Information about the producer that created the flower.

producer.name

string

Name of the producer of the flower.

producer.ucpc

string

UCPC for the producer.

producer.link

url

Link to the producer in the Cannabis Reports API.

type

string

Type of cannabis flower.

strain

object

Strain that was used for this flower.

strain.name

string

Name of the strain used for this flower.

strain.ucpc

string

UCPC of the strain used for this flower.

strain.link

url

Link to the strain used in this flower in the Cannabis Reports API.

labTest

url

Link to the PDF containing lab test information for this flower.

thc

string

Percentage of THC in this flower.

cbd

string

Percentage of CBD in this flower.

reviews

object

Object containing information on the reviews for the flower.

reviews.count

integer

Number of reviews for the flower.

reviews.link

url

Link to the reviews for the flower.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the flower was added.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the flower was updated.

Explore Flowers Endpoints

Here are some of the results available from the different flower endpoints:

EndpointResult

Gets a paginated list of flowers with optional sorting.

Gets a paginated list of products for a given type with optional sorting.

Gets an individual flower based on the UCPC.

Gets the reviews for a cannabis flower.

Gets the average effects and flavors from reviews for this flower.

Gets the producer for a given flower.

Gets the information about a strain for a flower with the given UCPC.

Get information about the availability of a flower using latitude and longitude.

get

get

Gets a paginated list of flowers with optional sorting.

get

get

Gets a paginated list of products for a given type with optional sorting.

Gets a paginated list of products for a given type with optional sorting.

URI Parameters

  • flowerType: required (string)

    The type of flowers you want to search through.

    Example:

    flowers

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Key Lime Pie - Flowers",
      "ucpc": "9XVU7FNY7ZMW2KZQTVNR00000",
      "link": "https://www.cannabisreports.com/api/v1.0/flowers/9XVU7FNY7ZMW2KZQTVNR00000",
      "qr": "https://www.cannabisreports.com/flower-reports/qr-code/elevate-cannabis-co/unknown-breeder/key-lime-pie/flowers.png",
      "barcode": "https://www.cannabisreports.com/flower-reports/barcode/elevate-cannabis-co/unknown-breeder/key-lime-pie/flowers.png",
      "url": "https://www.cannabisreports.com/flower-reports/elevate-cannabis-co/unknown-breeder/key-lime-pie/flowers",
      "image": "https://www.cannabisreports.com/images/flowers/d/full_d16466f2cf111e3d1ca524abd85e3e3eeeb51f1c.jpg",
      "producer": {
        "name": "Elevate Cannabis Co.",
        "ucpc": "0000000000MW2KZ0000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000MW2KZ0000000000"
      },
      "type": "flowers",
      "strain": {
        "name": "Key Lime Pie",
        "ucpc": "9XVU7FNY7Z000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7FNY7Z000000000000000"
      },
      "labTest": false,
      "thc": "22.23%",
      "cbd": "0.22%",
      "reviews": {
        "count": 0,
        "link": "https://www.cannabisreports.com/api/v1.0/flowers/9XVU7FNY7ZMW2KZQTVNR00000/reviews"
      },
      "createdAt": {
        "datetime": "2016-02-29 23:33:05",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2016-02-29 23:33:05",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 2288,
      "count": 10,
      "per_page": 10,
      "current_page": 3,
      "total_pages": 229,
      "links": {
        "previous": "https://www.cannabisreports.com/api/v1.0/flowers?sort=-updatedAt&page=2",
        "next": "https://www.cannabisreports.com/api/v1.0/flowers?sort=-updatedAt&page=4"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

get

get

Gets an individual flower based on the UCPC.

Gets an individual flower based on the UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis flower you want information about.

    Example:

    AHZ7H4N6467FVUDY3DAY00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "name": "Ogre Berry - Flowers",
  "ucpc": "AHZ7H4N6467FVUDY3DAY00000",
  "link": "https://www.cannabisreports.com/api/v1.0/flowers/AHZ7H4N6467FVUDY3DAY00000",
  "qr": "https://www.cannabisreports.com/flower-reports/qr-code/happyday-farms/happyday-farms/ogre-berry-4/flowers.png",
  "barcode": "https://www.cannabisreports.com/flower-reports/barcode/happyday-farms/happyday-farms/ogre-berry-4/flowers.png",
  "url": "https://www.cannabisreports.com/flower-reports/happyday-farms/happyday-farms/ogre-berry-4/flowers",
  "image": "https://www.cannabisreports.com/images/flowers/3/full_31ba360ff85eaa8b74e953a172c6408f6647abe2.jpg",
  "producer": {
    "name": "HappyDay Farms",
    "ucpc": "00000000007FVUD0000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/producers/00000000007FVUD0000000000"
  },
  "type": "flowers",
  "strain": {
    "name": "Ogre Berry",
    "ucpc": "9XVU74N646000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU74N646000000000000000"
  },
  "labTest": false,
  "thc": false,
  "cbd": false,
  "reviews": {
    "count": 1,
    "link": "https://www.cannabisreports.com/api/v1.0/flowers/AHZ7H4N6467FVUDY3DAY00000/reviews"
  },
  "createdAt": {
    "datetime": "2016-02-18 19:37:47",
    "timezone": "UTC"
  },
  "updatedAt": {
    "datetime": "2016-02-18 19:37:47",
    "timezone": "UTC"
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

get

get

Get the user who added the product to the database.

Get the user who added the product to the database.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis flower you want information about.

    Example:

    AHZ7H4N6467FVUDY3DAY00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "nickname": "jbcrockett",
    "link": "https://www.cannabisreports.com/api/v1.0/users/jbcrockett",
    "tagline": "Blazing the Alamo",
    "url": "https://www.cannabisreports.com/profile/jbcrockett",
    "slug": "jbcrockett",
    "createdAt": {
      "datetime": "2014-04-13 07:47:36",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2016-02-26 04:00:41",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a flower with that UCPC.",
  "status_code": 404
}

get

get

Get the reviews for a cannabis flower.

Get the reviews for a cannabis flower.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis flower you want information about.

    Example:

    AHZ7H4N6467FVUDY3DAY00000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "link": "https://www.cannabisreports.com/api/v1.0/reviews/cb17d26d7e877c5aa3060e285afbee22553a8119",
      "url": "https://www.cannabisreports.com/smoke-reports/2016/03/01/cb17d26d7e877c5aa3060e285afbee22553a8119/jbcrockett",
      "euphoria": "8",
      "creativity": "10",
      "pain_relief": null,
      "appetite_gain": "6",
      "calming": "4",
      "anxiety": null,
      "spicy": null,
      "earthy": "2",
      "fruity": "8",
      "sour": "6",
      "dry_mouth": null,
      "createdAt": {
        "datetime": "2016-03-01 23:36:32",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2016-03-01 23:36:32",
        "timezone": "UTC"
      }
    }
  ],
  "meta": {
    "pagination": {
      "total": 1,
      "count": 1,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a flower with that UCPC.",
  "status_code": 404
}

get

get

Get the average effects and flavors from reviews for this flower.

Get the average effects and flavors from reviews for this flower.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis flower you want information about.

    Example:

    AHZ7H4N6467FVUDY3DAY00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "euphoria": "8.0000",
    "creativity": "10.0000",
    "calming": "4.0000",
    "numbness": "4.0000",
    "appetite_gain": "6.0000",
    "dry_mouth": "6.0000",
    "fruity": "8.0000",
    "spicy": null,
    "earthy": "2.0000",
    "sour": "6.0000",
    "sweet": "6.0000",
    "pine": null,
    "anxiety": null,
    "reviews": 1
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a flower with that UCPC.",
  "status_code": 404
}

get

get

Gets the producer for a given flower.

Gets the producer for a given flower.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis flower you want information about.

    Example:

    AHZ7H4N6467FVUDY3DAY00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "HappyDay Farms",
    "ucpc": "00000000007FVUD0000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/producers/00000000007FVUD0000000000",
    "qr": "https://www.cannabisreports.com/producer-reports/happyday-farms/qr-code",
    "url": "https://www.cannabisreports.com/producer-reports/happyday-farms",
    "image": "https://www.cannabisreports.com/images/profile/4/full_4d36c17de8fbf6b27842e67ac36f6ff4ac60f6a0.jpg",
    "reviews": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/00000000007FVUD0000000000/reviews"
    },
    "extracts": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/00000000007FVUD0000000000/extracts"
    },
    "edibles": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/00000000007FVUD0000000000/edibles"
    },
    "products": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/00000000007FVUD0000000000/products"
    },
    "createdAt": {
      "datetime": "2016-02-18 19:36:19",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2016-02-18 19:36:47",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a flower with that UCPC.",
  "status_code": 404
}

get

get

Gets the information about a strain for a flower with the given UCPC.

Gets the information about a strain for a flower with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis flower you want information about.

    Example:

    AHZ7H4N6467FVUDY3DAY00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Ogre Berry",
    "ucpc": "9XVU74N646000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU74N646000000000000000",
    "qr": "https://www.cannabisreports.com/strain-reports/happyday-farms/ogre-berry-4/qr-code.svg",
    "url": "https://www.cannabisreports.com/strain-reports/happyday-farms/ogre-berry-4",
    "image": "https://www.cannabisreports.com/images/strains/8/full_8dd6dbd49b15125172a96219086f81246e1ae15b.jpg",
    "seedCompany": {
      "name": "HappyDay Farms",
      "ucpc": "AHZ7H00000000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/AHZ7H00000000000000000000"
    },
    "genetics": {
      "names": "Ogre x Island Mountain Strawberry Afghani",
      "ucpc": "9XVU7U9HUK000000000000000 x 9XVU7D492Z000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU74N646000000000000000/genetics"
    },
    "lineage": [],
    "children": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU74N646000000000000000/children"
    },
    "reviews": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU74N646000000000000000/reviews"
    },
    "createdAt": {
      "datetime": "2015-07-29 18:11:45",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-12-09 23:07:38",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a flower with that UCPC.",
  "status_code": 404
}

get

Get information about the availability of a product using latitude and longitude.

get

Get information about the availability of a strain using latitude and longitude.

Get information about the availability of a strain using latitude and longitude.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis flower you want information about.

    Example:

    AHZ7H4N6467FVUDY3DAY00000
  • lat: required (string)

    Latitude for the center of your availability search.

    Example:

    37.7749295
  • lng: required (string)

    Longitude for the center of your availability search.

    Example:

    -122.4194155
  • radius: required (integer)

    Radius to search for in miles, max 25.

    Example:

    10

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Jack Herer",
      "ucpc": "VUJCJ4TYMG000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJ4TYMG000000000000000",
      "type": "strain",
      "location": {
        "name": "Love Shack Cooperative",
        "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/love-shack-cooperative",
        "lat": "37.7681384",
        "lng": "-122.4246791"
      },
      "price": null,
      "price_half_gram": null,
      "price_gram": "10.00",
      "price_eighth": "35.00",
      "price_quarter": "70.00",
      "price_half_ounce": "135.00",
      "price_ounce": "265.00",
      "createdAt": {
        "datetime": "2014-05-20 18:31:40",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-05-21 04:56:23",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 10,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a strain with that UCPC.",
  "status_code": 404
}

Extracts

Extract Object

Cannabis extracts in the Cannabis Reports system.

Cannabis extracts are created from the flowers of the cannabis plant. Various methods for creating cannabis extracts have been perfected over thousands of years.

Cannabis Reports recognizes 10 main types of extracts:

  • Kief
  • Hash
  • Water-Hash
  • Oil
  • Wax
  • Crumble
  • Honeycomb
  • Shatter
  • Vaporizer-Disposable
  • Vaporizer-Cartridge

Each extract is tied to a strain and the producer who created it. For more information about cannabis extracts, check out our FAQ here:

https://www.cannabisreports.com/faq/typesconsumption/what-is-a-cannabis-extract

NameTypeDescription

name

string

Name of the extract including the name of the strain and the type of extract.

ucpc

string

UCPC code for this extract.

link

url

Link to the extract in the Cannabis Reports API.

qr

url

Link to the QR code for this extract.

barcode

url

Link to the barcode for this extract.

url

url

Link to the extract listing on the Cannabis Reports website.

image

url

Link to the full size image for this extract. If none has been uploaded, this links to a generic image for this type of extract.

producer

object

Information about the producer that created the extract.

producer.name

string

Name of the producer of the extract.

producer.ucpc

string

UCPC for the producer.

producer.link

url

Link to the producer in the Cannabis Reports API.

type

string

Type of cannabis extract.

strain

object

Strain that this extract comes from.

strain.name

string

Name of the strain this extract comes from.

strain.ucpc

string

UCPC of the strain this extract comes from.

strain.link

url

Link to the strain this extract comes from in the Cannabis Reports API.

labTest

url

Link to the PDF containing lab test information for this extract.

thc

string

Percentage of THC in this extract.

cbd

string

Percentage of CBD in this extract.

reviews

object

Object containing information on the reviews for the extract.

reviews.count

integer

Number of reviews for the extract.

reviews.link

url

Link to the reviews for the extract.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the extract was added.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the extract was updated.

Explore Extract Endpoints

Here are some of the results available from the different extract endpoints

EndpointResult

Gets a paginated list of extracts with optional sorting.

Gets a paginated list of extracts with optional sorting.

Gets an individual extract based on the UCPC.

Get the reviews for a cannabis extract.

Get the average effects and flavors from reviews for this extract.

Gets the producer for a given extract.

Gets the information about a strain for an extract with the given UCPC.

Get information about the availability of an extract using latitude and longitude.

get

get

Gets a paginated list of extracts with optional sorting.

get

get

Gets a paginated list of extracts with optional sorting.

Gets a paginated list of extracts with optional sorting.

URI Parameters

  • extractType: required (string)

    One of the various types of extracts you would like to filter by. Acceptable types are:

    • Kief
    • Hash
    • Water-Hash
    • Oil
    • Wax
    • Crumble
    • Honeycomb
    • Shatter
    • Vaporizer-Disposable
    • Vaporizer-Cartridge

    Example:

    shatter

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Sour Diesel - Shatter",
      "ucpc": "9XVU7KVPFZTMVC3L4Z4900000",
      "link": "https://www.cannabisreports.com/api/v1.0/extracts/9XVU7KVPFZTMVC3L4Z4900000",
      "qr": "https://www.cannabisreports.com/extract-reports/qr-code/flower-of-life-extracts/unknown-breeder/sour-diesel/shatter.png",
      "barcode": "https://www.cannabisreports.com/extract-reports/barcode/flower-of-life-extracts/unknown-breeder/sour-diesel/shatter.png",
      "url": "https://www.cannabisreports.com/extract-reports/flower-of-life-extracts/unknown-breeder/sour-diesel/shatter",
      "image": "https://www.cannabisreports.com/images/extracts/c/full_cfcf09cc1e10f751fa52226ac4a7a52f138459d4.jpg",
      "producer": {
        "name": "Flower of Life Extracts",
        "ucpc": "0000000000TMVC30000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000TMVC30000000000"
      },
      "type": "shatter",
      "strain": {
        "name": "Sour Diesel",
        "ucpc": "9XVU7KVPFZ000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7KVPFZ000000000000000"
      },
      "labTest": false,
      "thc": false,
      "cbd": false,
      "reviews": 0,
      "createdAt": {
        "datetime": "2015-05-06 18:08:22",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-05-06 18:08:22",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 909,
      "count": 10,
      "per_page": 10,
      "current_page": 3,
      "total_pages": 91,
      "links": {
        "previous": "https://www.cannabisreports.com/api/v1.0/extracts/type/shatter?sort=-updatedAt&page=2",
        "next": "https://www.cannabisreports.com/api/v1.0/extracts/type/shatter?sort=-updatedAt&page=4"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

get

get

Gets an individual extract based on the UCPC.

Gets an individual extract based on the UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis extract you want information about.

    Example:

    3CV7E33XLHTJT2XZ4GMD00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Jesus OG - Shatter",
    "ucpc": "3CV7E33XLHTJT2XZ4GMD00000",
    "link": "https://www.cannabisreports.com/api/v1.0/extracts/3CV7E33XLHTJT2XZ4GMD00000",
    "qr": "https://www.cannabisreports.com/extract-reports/qr-code/hgh-extractions/tga-seeds/jesus-og/shatter.png",
    "barcode": "https://www.cannabisreports.com/extract-reports/barcode/hgh-extractions/tga-seeds/jesus-og/shatter.png",
    "url": "https://www.cannabisreports.com/extract-reports/hgh-extractions/tga-seeds/jesus-og/shatter",
    "image": "https://www.cannabisreports.com/images/extracts/shatter.jpg",
    "producer": {
      "name": "HGH Extractions",
      "ucpc": "0000000000TJT2X0000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000TJT2X0000000000"
    },
    "type": "shatter",
    "strain": {
      "name": "Jesus OG",
      "ucpc": "3CV7E33XLH000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/3CV7E33XLH000000000000000"
    },
    "labTest": false,
    "thc": false,
    "cbd": false,
    "reviews": 0,
    "createdAt": {
      "datetime": "2015-04-22 22:43:07",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-04-22 22:43:08",
      "timezone": "UTC"
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

get

get

Get the user who added the extract to the database.

Get the user who added the extract to the database.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis extract you want information about.

    Example:

    3CV7E33XLHTJT2XZ4GMD00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "nickname": "Untamed Dame",
    "link": "https://www.cannabisreports.com/api/v1.0/users/untamed-dame",
    "tagline": "Let's get weird.",
    "url": "https://www.cannabisreports.com/user/profile/untamed-dame",
    "slug": "untamed-dame",
    "createdAt": {
      "datetime": "2014-12-07 23:30:37",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-04-22 18:24:18",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

get

get

Get the reviews for a cannabis extract.

Get the reviews for a cannabis extract.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis extract you want information about.

    Example:

    3CV7E33XLHTJT2XZ4GMD00000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "link": "https://www.cannabisreports.com/api/v1.0/reviews/2e417f316a1f1101c8eb9ba6f63c9f994e9436ac",
      "url": "https://www.cannabisreports.com/smoke-reports/2015/04/02/2e417f316a1f1101c8eb9ba6f63c9f994e9436ac/doc-chillington",
      "euphoria": "6",
      "creativity": "8",
      "pain_relief": null,
      "appetite_gain": "6",
      "calming": "4",
      "anxiety": null,
      "spicy": "2",
      "earthy": "6",
      "fruity": null,
      "sour": null,
      "dry_mouth": null,
      "createdAt": {
        "datetime": "2015-04-02 23:58:25",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-04-02 23:58:25",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 1,
      "count": 1,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

get

get

Get the average effects and flavors from reviews for this extract.

Get the average effects and flavors from reviews for this extract.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis extract you want information about.

    Example:

    3CV7E33XLHTJT2XZ4GMD00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "euphoria": "6.0000",
    "creativity": "8.0000",
    "calming": "4.0000",
    "numbness": "4.0000",
    "appetite_gain": "6.0000",
    "dry_mouth": "6.0000",
    "fruity": null,
    "spicy": "2.0000",
    "earthy": "6.0000",
    "sour": null,
    "sweet": null,
    "pine": null,
    "anxiety": null,
    "reviews": 1
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

get

Extracts in the Cannabis Reports system have a producer associated with them. Some dispensaries are not yet listing the company that produced their extracts for their menus. For those extracts, an "Unknown Producer" has been associated. Trying to get information about his producer will give you the UCPC and name with nothing more.

More information about the various fields for the producer can be found in the cannabis producer object definition section.

get

Gets the producer for a given extract.

Gets the producer for a given extract.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis extract you want information about.

    Example:

    3CV7E33XLHTJT2XZ4GMD00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "HGH Extractions",
    "ucpc": "0000000000TJT2X0000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000TJT2X0000000000",
    "qr": "https://www.cannabisreports.com/producer-reports/hgh-extractions/qr-code",
    "url": "https://www.cannabisreports.com/producer-reports/hgh-extractions",
    "image": "https://www.cannabisreports.com/images/profile/3/full_3726c52929c5e9424a0539c12ac215305b0d3cc2.jpg",
    "reviews": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000TJT2X0000000000/reviews"
    },
    "extracts": {
      "count": 88,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000TJT2X0000000000/extracts"
    },
    "edibles": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000TJT2X0000000000/edibles"
    },
    "products": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000TJT2X0000000000/products"
    },
    "createdAt": {
      "datetime": "2014-07-14 20:15:37",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2014-10-14 21:30:08",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

get

get

Gets the information about a strain for an extract with the given UCPC.

Gets the information about a strain for an extract with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis extract you want information about.

    Example:

    3CV7E33XLHTJT2XZ4GMD00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Blackwater OG",
    "ucpc": "QLG39RN2AF000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/strains/QLG39RN2AF000000000000000",
    "qr": "https://www.cannabisreports.com/strain-reports/the-cali-connection/blackwater/qr-code.svg",
    "url": "https://www.cannabisreports.com/strain-reports/the-cali-connection/blackwater",
    "image": "https://www.cannabisreports.com/images/strains/d/full_d638b0d93eed0eca94c0894cf4e9dc7bdd2f860c.jpg",
    "seedCompany": {
      "name": "The Cali Connection",
      "ucpc": "QLG3900000000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/QLG3900000000000000000000"
    },
    "genetics": {
      "names": "Mendo Purps x San Fernando Valley OG (SFV OG)",
      "ucpc": "9XVU7LXP9U000000000000000 x 9XVU7EYMZW000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/QLG39RN2AF000000000000000/genetics"
    },
    "lineage": {
      "Afghanistan": "AF"
    },
    "children": {
      "count": 2,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/QLG39RN2AF000000000000000/children"
    },
    "reviews": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/QLG39RN2AF000000000000000/reviews"
    },
    "createdAt": {
      "datetime": "2014-07-28 19:16:21",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2014-08-01 19:52:40",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

get

This will provide a paginated list of item summary objects for this particular strain.

get

Get information about the availability of an extract using latitude and longitude.

Get information about the availability of an extract using latitude and longitude.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis extract you want information about.

    Example:

    3CV7E33XLHTJT2XZ4GMD00000
  • lat: required (string)

    Latitude for the center of your availability search.

    Example:

    37.7749295
  • lng: required (string)

    Longitude for the center of your availability search.

    Example:

    -122.4194155
  • radius: required (integer)

    Radius to search for in miles, max 25.

    Example:

    10

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Cherry Pie (Cherry Kush) - Vaporizer Cartridge",
      "ucpc": "9XVU7ZCENQVU7TGRFHPC00000",
      "link": "https://www.cannabisreports.com/api/v1.0/extracts/9XVU7ZCENQVU7TGRFHPC00000",
      "type": "extract",
      "location": {
        "name": "SFFOGG",
        "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/sffogg",
        "lat": "37.7717311",
        "lng": "-122.4165409"
      },
      "price": null,
      "price_half_gram": "0.00",
      "price_gram": "40.00",
      "price_eighth": null,
      "price_quarter": null,
      "price_half_ounce": null,
      "price_ounce": null,
      "createdAt": {
        "datetime": "2014-05-20 21:29:37",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-05-21 04:53:05",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 16,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 2,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/extracts/9XVU7ZCENQVU7TGRFHPC00000/availability/geo/37.7749295/-122.4194155/25?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

Edibles

Edible Object

Cannabis edibles in the Cannabis Reports system.

Cannabis edibles cover a wide variety of consumable products that contain cannabis in various forms. From cotton candy, to tinctures, to dog treats, and everything in between. If it's a form of cannabis that is meant to be consumed, we categorize it as an edible.

The main forms of edibles that Cannabis Reports recognizes are:

  • Baked Goods
  • Candy
  • Treat
  • Chocolate
  • Snack
  • Beverage
  • Pill
  • Tincture

We also support "Other" types of edibles. Some examples are:

  • Butter
  • Honey
  • Breath Strips
  • Tea
  • Ice Cream

Producers measure the amount of cannabis in their edibles in a variety of ways. We recognize 4 ways for measuring the cannabis contents:

  • THC mg
  • CBD mg
  • Cannabis mg
  • Hash Oil mg

More information about cannabis edibles can be found in our FAQ here:

https://www.cannabisreports.com/faq/typesconsumption/what-is-a-cannabis-edible

NameTypeDescription

name

string

Name of the edible.

ucpc

string

UCPC code for this edible.

link

url

Link to the edible in the Cannabis Reports API.

qr

url

Link to the QR code for this edible.

barcode

url

Link to the barcode for this edible.

url

url

Link to the edible listing on the Cannabis Reports website.

image

url

Link to the full size image for this edible.

producer

object

Information about the producer that created the edible.

producer.name

string

Name of the producer of the edible.

producer.ucpc

string

UCPC for the producer.

producer.link

url

Link to the producer in the Cannabis Reports API.

type

string

Type of cannabis edible.

strain

object

Strain that was used in this edible.

strain.name

string

Name of the strain used in this edible.

strain.ucpc

string

UCPC of the strain used in this edible.

strain.link

url

Link to the strain used in this edible in the Cannabis Reports API.

labTest

url

Link to the PDF containing lab test information for this edible.

thc

string

Milligrams of THC in this edible.

cbd

string

Milligrams of CBD in this edible.

cannabis

string

Milligrams of cannabis in this edible.

hashOil

string

Milligrams of hash oil in this edible.

reviews

object

Object containing information on the reviews for the edible.

reviews.count

integer

Number of reviews for the edible.

reviews.link

url

Link to the reviews for the edible.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the edible was added.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the edible was updated.

Explore Edible Endpoints

Here are some of the results available from the different edible endpoints:

EndpointResult

Gets a paginated list of edibles with optional sorting.

Gets a paginated list of edibles for a given type with optional sorting.

Gets an individual edible based on the UCPC.

Get the reviews for a cannabis edible.

Get the average effects and flavors from reviews for this edible.

Gets the producer for a given edible.

Gets the information about a strain for an edible with the given UCPC.

Get information about the availability of an edible using latitude and longitude.

get

get

Gets a paginated list of edibles with optional sorting.

get

get

Gets a paginated list of edibles with optional sorting.

Gets a paginated list of edibles with optional sorting.

URI Parameters

  • edibleType: required (string)

    One of the various types of edibles you would like to filter by. See Cannabis Edibles object definition for valid types.

    Example:

    chocolate

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Terra Blueberry Bites",
      "ucpc": "0000000000L6M7ENLJVX00000",
      "link": "https://www.cannabisreports.com/api/v1.0/edibles/0000000000L6M7ENLJVX00000",
      "qr": "https://www.cannabisreports.com/edible-reports/qr-code/kiva/terra-blueberry-bites",
      "barcode": "https://www.cannabisreports.com/edible-reports/barcode/kiva/terra-blueberry-bites",
      "url": "https://www.cannabisreports.com/edible-reports/kiva/terra-blueberry-bites",
      "image": "https://www.cannabisreports.com/images/edibles/f/full_f29d34f36f40c96e26419caad6a668618bd417bb.jpg",
      "producer": {
        "name": "Kiva",
        "ucpc": "0000000000L6M7E0000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000"
      },
      "type": "chocolate",
      "strain": [],
      "labTest": false,
      "thc": "120mg",
      "cbd": false,
      "cannabis": false,
      "hashOil": false,
      "reviews": 2,
      "createdAt": {
        "datetime": "2015-03-12 21:02:48",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-03-12 21:02:48",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 354,
      "count": 10,
      "per_page": 10,
      "current_page": 3,
      "total_pages": 36,
      "links": {
        "previous": "https://www.cannabisreports.com/api/v1.0/edibles/type/chocolate?sort=-updatedAt&page=2",
        "next": "https://www.cannabisreports.com/api/v1.0/edibles/type/chocolate?sort=-updatedAt&page=4"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

get

get

Gets an individual edible based on the UCPC.

Gets an individual edible based on the UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis edible you want information about.

    Example:

    4KXM32V9YFC3G2EUNWP400000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Soda - Girl Scout Cookies and Cream",
    "ucpc": "4KXM32V9YFC3G2EUNWP400000",
    "link": "https://www.cannabisreports.com/api/v1.0/edibles/4KXM32V9YFC3G2EUNWP400000",
    "qr": "https://www.cannabisreports.com/edible-reports/qr-code/kushtown/soda-girl-scout-cookies-and-cream",
    "barcode": "https://www.cannabisreports.com/edible-reports/barcode/kushtown/soda-girl-scout-cookies-and-cream",
    "url": "https://www.cannabisreports.com/edible-reports/kushtown/soda-girl-scout-cookies-and-cream",
    "image": "https://www.cannabisreports.com/images/strains/no_image.png",
    "producer": {
      "name": "Kushtown",
      "ucpc": "0000000000C3G2E0000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000C3G2E0000000000"
    },
    "type": "beverage",
    "strain": {
      "name": "Girl Scout Cookies",
      "ucpc": "4KXM32V9YF000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/4KXM32V9YF000000000000000"
    },
    "labTest": false,
    "thc": "78mg",
    "cbd": false,
    "cannabis": false,
    "hashOil": false,
    "reviews": 0,
    "createdAt": {
      "datetime": "2015-04-20 08:13:34",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-04-20 15:43:59",
      "timezone": "UTC"
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an edible with that UCPC.",
  "status_code": 404
}

get

get

Get the user who added the edible to the database.

Get the user who added the edible to the database.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis edible you want information about.

    Example:

    4KXM32V9YFC3G2EUNWP400000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "nickname": "Untamed Dame",
    "link": "https://www.cannabisreports.com/api/v1.0/users/untamed-dame",
    "tagline": "Let's get weird.",
    "url": "https://www.cannabisreports.com/user/profile/untamed-dame",
    "slug": "untamed-dame",
    "createdAt": {
      "datetime": "2014-12-07 23:30:37",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-04-22 18:24:18",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an extract with that UCPC.",
  "status_code": 404
}

get

get

Get the reviews for a cannabis edible.

Get the reviews for a cannabis edible.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis edible you want information about.

    Example:

    4KXM32V9YFC3G2EUNWP400000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "link": "https://www.cannabisreports.com/api/v1.0/reviews/be1a9af83cd9766c4635d4aa3d21eb8c6ae787ed",
      "url": "https://www.cannabisreports.com/smoke-reports/2015/04/07/be1a9af83cd9766c4635d4aa3d21eb8c6ae787ed/david",
      "euphoria": "6",
      "creativity": "8",
      "pain_relief": null,
      "appetite_gain": "10",
      "calming": "6",
      "anxiety": null,
      "spicy": "4",
      "earthy": "4",
      "fruity": "8",
      "sour": null,
      "dry_mouth": null,
      "createdAt": {
        "datetime": "2015-04-07 00:20:31",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-04-07 00:20:31",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "count": 2,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an edible with that UCPC.",
  "status_code": 404
}

get

get

Get the average effects and flavors from reviews for this edible.

Get the average effects and flavors from reviews for this edible.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis edible you want information about.

    Example:

    4KXM32V9YFC3G2EUNWP400000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "euphoria": "6.0000",
    "creativity": "8.0000",
    "calming": "6.0000",
    "numbness": "8.0000",
    "appetite_gain": "10.0000",
    "dry_mouth": "4.5000",
    "fruity": "9.0000",
    "spicy": "4.0000",
    "earthy": "4.0000",
    "sour": null,
    "sweet": "9.0000",
    "pine": null,
    "anxiety": null,
    "reviews": 2
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an edible with that UCPC.",
  "status_code": 404
}

get

More information about the various fields for the producer can be found in the cannabis producer object definition section.

get

Gets the producer for a given edible.

Gets the producer for a given edible.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis edible you want information about.

    Example:

    4KXM32V9YFC3G2EUNWP400000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Kushtown",
    "ucpc": "0000000000C3G2E0000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000C3G2E0000000000",
    "qr": "https://www.cannabisreports.com/producer-reports/kushtown/qr-code",
    "url": "https://www.cannabisreports.com/producer-reports/kushtown",
    "image": "https://www.cannabisreports.com/images/profile/c/full_c2c46561e1edec61ea0ffdea01c94509abd5c010.jpg",
    "reviews": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000C3G2E0000000000/reviews"
    },
    "extracts": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000C3G2E0000000000/extracts"
    },
    "edibles": {
      "count": 44,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000C3G2E0000000000/edibles"
    },
    "products": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000C3G2E0000000000/products"
    },
    "createdAt": {
      "datetime": "2014-11-07 03:39:09",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2014-11-07 04:13:54",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an edible with that UCPC.",
  "status_code": 404
}

get

get

Gets the information about a strain for an edible with the given UCPC.

Gets the information about a strain for an edible with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis edible you want information about.

    Example:

    4KXM32V9YFC3G2EUNWP400000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Girl Scout Cookies",
    "ucpc": "4KXM32V9YF000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/strains/4KXM32V9YF000000000000000",
    "qr": "https://www.cannabisreports.com/strain-reports/cookie-family/girl-scout-cookies/qr-code.svg",
    "url": "https://www.cannabisreports.com/strain-reports/cookie-family/girl-scout-cookies",
    "image": "https://www.cannabisreports.com/images/strains/b/full_bb267b218903ded6aff0d4cf1ec6e911e22017e3.jpg",
    "seedCompany": {
      "name": "Cookie Family",
      "ucpc": "4KXM300000000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/4KXM300000000000000000000"
    },
    "genetics": {
      "names": "F1 / Durban Poison / OG Kush (Ogreskush)",
      "ucpc": "4KXM33PGZW000000000000000 / 9XVU7GD2AP000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/4KXM32V9YF000000000000000/genetics"
    },
    "lineage": {
      "Afghanistan": "AF",
      "South Africa": "ZA"
    },
    "children": {
      "count": 66,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/4KXM32V9YF000000000000000/children"
    },
    "reviews": {
      "count": 2,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/4KXM32V9YF000000000000000/reviews"
    },
    "createdAt": {
      "datetime": "2014-05-16 16:42:38",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2014-06-07 08:06:32",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an edible with that UCPC.",
  "status_code": 404
}

get

This will provide a paginated list of item summary objects for this particular edible.

get

Get information about the availability of an edible using latitude and longitude.

Get information about the availability of an edible using latitude and longitude.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis edible you want information about.

    Example:

    4KXM32V9YFC3G2EUNWP400000
  • lat: required (string)

    Latitude for the center of your availability search.

    Example:

    37.7749295
  • lng: required (string)

    Longitude for the center of your availability search.

    Example:

    -122.4194155
  • radius: required (integer)

    Radius to search for in miles, max 25.

    Example:

    10

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Chocolate Bar (180MG) - Vanilla Chai Milk Chocolate",
      "ucpc": "0000000000L6M7ECZEXH00000",
      "link": "https://www.cannabisreports.com/api/v1.0/edibles/0000000000L6M7ECZEXH00000",
      "type": "edible",
      "location": {
        "name": "SFFOGG",
        "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/sffogg",
        "lat": "37.7717311",
        "lng": "-122.4165409"
      },
      "price": "20.00",
      "price_half_gram": null,
      "price_gram": null,
      "price_eighth": null,
      "price_quarter": null,
      "price_half_ounce": null,
      "price_ounce": null,
      "createdAt": {
        "datetime": "2014-05-20 21:29:37",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-05-21 04:53:05",
        "timezone": "UTC"
      }
    },
    { ... }
  ],
  "meta": {
    "pagination": {
      "total": 35,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 4,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/edibles/0000000000L6M7ECZEXH00000/availability/geo/37.7749295/-122.4194155/25?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find an edible with that UCPC.",
  "status_code": 404
}

Products

Product Object

Cannabis products in the Cannabis Reports system.

Cannabis products cover a wide variety of additional products that contain cannabis. Anything that wouldn't be consumed like an edible or extract falls into this category. We also have pre-rolled cannabis in this category.

The main forms of products that Cannabis Reports recognizes are:

  • Bath
  • Topical
  • Skin Care
  • Pre-Roll

We also support "Other" types of products. Some examples are:

  • Lip Balm
  • Massage Oil
  • Personal Lubricant

Producers measure the amount of cannabis in their products in a variety of ways. We recognize 4 ways for measuring the cannabis contents:

  • THC mg
  • CBD mg
  • Cannabis mg
  • Hash Oil mg

More information about cannabis products can be found in our FAQ here:

https://www.cannabisreports.com/faq/typesconsumption/what-is-a-cannabis-product

NameTypeDescription

name

string

Name of the product.

ucpc

string

UCPC code for this product.

link

url

Link to the product in the Cannabis Reports API.

qr

url

Link to the QR code for this product.

barcode

url

Link to the barcode for this product.

url

url

Link to the product listing on the Cannabis Reports website.

image

url

Link to the full size image for this product.

producer

object

Information about the producer that created the product.

producer.name

string

Name of the producer of the product.

producer.ucpc

string

UCPC for the producer.

producer.link

url

Link to the producer in the Cannabis Reports API.

type

string

Type of cannabis product.

strain

object

Strain that was used in this product.

strain.name

string

Name of the strain used in this product.

strain.ucpc

string

UCPC of the strain used in this product.

strain.link

url

Link to the strain used in this product in the Cannabis Reports API.

labTest

url

Link to the PDF containing lab test information for this product.

thc

string

Milligrams of THC in this product.

cbd

string

Milligrams of CBD in this product.

cannabis

string

Milligrams of cannabis in this product.

hashOil

string

Milligrams of hash oil in this product.

reviews

object

Object containing information on the reviews for the product.

reviews.count

integer

Number of reviews for the product.

reviews.link

url

Link to the reviews for the product.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the product was added.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the product was updated.

Explore Product Endpoints

Here are some of the results available from the different product endpoints:

EndpointResult

Gets a paginated list of products with optional sorting.

Gets a paginated list of products for a given type with optional sorting.

Gets an individual product based on the UCPC.

Gets the reviews for a cannabis product.

Gets the average effects and flavors from reviews for this product.

Gets the producer for a given product.

Gets the information about a strain for a product with the given UCPC.

Get information about the availability of a product using latitude and longitude.

get

get

Gets a paginated list of edibles with optional sorting.

get

get

Gets a paginated list of products with optional sorting.

Gets a paginated list of products with optional sorting.

URI Parameters

  • productType: required (string)

    One of the various types of products you would like to filter by. See Cannabis Products object definition for valid types.

    Example:

    pre-roll

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "XJ-13 - Pre-roll",
      "ucpc": "9XVU7PU3PGGY79EP9XVP00000",
      "link": "https://www.cannabisreports.com/api/v1.0/products/9XVU7PU3PGGY79EP9XVP00000",
      "qr": "https://www.cannabisreports.com/product-reports/qr-code/vines/xj-13.png",
      "barcode": "https://www.cannabisreports.com/product-reports/barcode/vines/xj-13.png",
      "url": "https://www.cannabisreports.com/product-reports/vines/xj-13",
      "image": "https://www.cannabisreports.com/images/strains/no_image.png",
      "producer": {
        "name": "Vines",
        "ucpc": "0000000000GY79E0000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000GY79E0000000000"
      },
      "type": "pre-roll",
      "strain": {
        "name": "XJ-13",
        "ucpc": "9XVU7PU3PG000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7PU3PG000000000000000"
      },
      "labTest": false,
      "thc": false,
      "cbd": false,
      "cannabis": false,
      "hashOil": false,
      "reviews": 0,
      "createdAt": {
        "datetime": "2015-04-16 20:22:43",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-04-16 20:22:43",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 151,
      "count": 10,
      "per_page": 10,
      "current_page": 3,
      "total_pages": 16,
      "links": {
        "previous": "https://www.cannabisreports.com/api/v1.0/products/type/pre-roll?sort=-updatedAt&page=2",
        "next": "https://www.cannabisreports.com/api/v1.0/products/type/pre-roll?sort=-updatedAt&page=4"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

get

get

Gets an individual product based on the UCPC.

Gets an individual product based on the UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis product you want information about.

    Example:

    9XVU7NK3PEGLAJ372X4F00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Cherry Kola - Pre-roll",
    "ucpc": "9XVU7NK3PEGLAJ372X4F00000",
    "link": "https://www.cannabisreports.com/api/v1.0/products/9XVU7NK3PEGLAJ372X4F00000",
    "qr": "https://www.cannabisreports.com/product-reports/qr-code/emeralds/cherry-kola.png",
    "barcode": "https://www.cannabisreports.com/product-reports/barcode/emeralds/cherry-kola.png",
    "url": "https://www.cannabisreports.com/product-reports/emeralds/cherry-kola",
    "image": "https://www.cannabisreports.com/images/products/1/full_181ed48f2c03407f9ae23f6e520846755e678f04.jpg",
    "producer": {
      "name": "Emeralds",
      "ucpc": "0000000000GLAJ30000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000GLAJ30000000000"
    },
    "type": "pre-roll",
    "strain": {
      "name": "Cherry Kola",
      "ucpc": "9XVU7NK3PE000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7NK3PE000000000000000"
    },
    "labTest": false,
    "thc": false,
    "cbd": false,
    "cannabis": false,
    "hashOil": false,
    "reviews": 0,
    "createdAt": {
      "datetime": "2015-04-23 19:53:03",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-04-23 19:53:03",
      "timezone": "UTC"
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a product with that UCPC.",
  "status_code": 404
}

get

get

Get the user who added the product to the database.

Get the user who added the product to the database.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis product you want information about.

    Example:

    9XVU7NK3PEGLAJ372X4F00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "nickname": "Shelly",
    "link": "https://www.cannabisreports.com/api/v1.0/users/shelly",
    "tagline": "Smoke Reporter",
    "url": "https://www.cannabisreports.com/user/profile/shelly",
    "slug": "shelly",
    "createdAt": {
      "datetime": "2014-06-21 15:20:29",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-05-06 22:10:38",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a product with that UCPC.",
  "status_code": 404
}

get

get

Get the reviews for a cannabis product.

Get the reviews for a cannabis product.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis product you want information about.

    Example:

    9XVU7NK3PEGLAJ372X4F00000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "link": "https://www.cannabisreports.com/api/v1.0/reviews/4d5ade152bab3bb1ec0451e4dd942377ab0b0e98",
      "url": "https://www.cannabisreports.com/smoke-reports/2015/03/17/4d5ade152bab3bb1ec0451e4dd942377ab0b0e98/jbcrockett",
      "euphoria": null,
      "creativity": null,
      "pain_relief": null,
      "appetite_gain": null,
      "calming": "2",
      "anxiety": null,
      "spicy": null,
      "earthy": null,
      "fruity": null,
      "sour": null,
      "dry_mouth": null,
      "createdAt": {
        "datetime": "2015-03-17 00:22:42",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-03-17 00:22:42",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "count": 2,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a product with that UCPC.",
  "status_code": 404
}

get

get

Get the average effects and flavors from reviews for this product.

Get the average effects and flavors from reviews for this product.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis product you want information about.

    Example:

    9XVU7NK3PEGLAJ372X4F00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "euphoria": null,
    "creativity": null,
    "calming": "2.0000",
    "numbness": "4.0000",
    "appetite_gain": null,
    "dry_mouth": null,
    "fruity": null,
    "spicy": null,
    "earthy": null,
    "sour": null,
    "sweet": null,
    "pine": null,
    "anxiety": null,
    "reviews": 2
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a product with that UCPC.",
  "status_code": 404
}

get

More information about the various fields for the producer can be found in the cannabis producer object definition section.

get

Gets the producer for a given product.

Gets the producer for a given product.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis product you want information about.

    Example:

    9XVU7NK3PEGLAJ372X4F00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Emeralds",
    "ucpc": "0000000000GLAJ30000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000GLAJ30000000000",
    "qr": "https://www.cannabisreports.com/producer-reports/emeralds/qr-code",
    "url": "https://www.cannabisreports.com/producer-reports/emeralds",
    "image": "https://www.cannabisreports.com/images/profile/6/full_6b79645bfa75a564da1d842d5afdb283ef5b7992.jpg",
    "reviews": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000GLAJ30000000000/reviews"
    },
    "extracts": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000GLAJ30000000000/extracts"
    },
    "edibles": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000GLAJ30000000000/edibles"
    },
    "products": {
      "count": 36,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000GLAJ30000000000/products"
    },
    "createdAt": {
      "datetime": "2015-03-16 18:15:49",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-03-16 18:17:22",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a product with that UCPC.",
  "status_code": 404
}

get

get

Gets the information about a strain for a product with the given UCPC.

Gets the information about a strain for a product with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis product you want information about.

    Example:

    9XVU7NK3PEGLAJ372X4F00000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Cherry Kola",
    "ucpc": "9XVU7NK3PE000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7NK3PE000000000000000",
    "qr": "https://www.cannabisreports.com/strain-reports/unknown-breeder/cherry-kola/qr-code.svg",
    "url": "https://www.cannabisreports.com/strain-reports/unknown-breeder/cherry-kola",
    "image": "https://www.cannabisreports.com/images/strains/8/full_8a60c17d63915c5d20b0a874561042686a70b825.jpg",
    "seedCompany": {
      "name": "Unknown Breeder",
      "ucpc": "9XVU700000000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/9XVU700000000000000000000"
    },
    "genetics": {
      "names": false,
      "ucpc": false,
      "link": false
    },
    "lineage": [],
    "children": {
      "count": 1,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7NK3PE000000000000000/children"
    },
    "reviews": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7NK3PE000000000000000/reviews"
    },
    "createdAt": {
      "datetime": "2014-11-17 22:34:57",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2014-11-17 22:34:57",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a product with that UCPC.",
  "status_code": 404
}

get

This will provide a paginated list of item summary objects for this particular product.

get

Get information about the availability of a product using latitude and longitude.

Get information about the availability of a product using latitude and longitude.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis product you want information about.

    Example:

    9XVU7NK3PEGLAJ372X4F00000
  • lat: required (string)

    Latitude for the center of your availability search.

    Example:

    37.7749295
  • lng: required (string)

    Longitude for the center of your availability search.

    Example:

    -122.4194155
  • radius: required (integer)

    Radius to search for in miles, max 25.

    Example:

    10

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Blueberry - Pre-roll",
      "ucpc": "W74AFGH22ZWVWRKAKTRV00000",
      "link": "https://www.cannabisreports.com/api/v1.0/products/W74AFGH22ZWVWRKAKTRV00000",
      "type": "product",
      "location": {
        "name": "BASA, Bay Area Safe Alternatives Inc.",
        "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/basa-bay-area-safe-alternatives-inc",
        "lat": "37.7760758",
        "lng": "-122.4385182"
      },
      "price": "16.00",
      "price_half_gram": null,
      "price_gram": null,
      "price_eighth": null,
      "price_quarter": null,
      "price_half_ounce": null,
      "price_ounce": null,
      "createdAt": {
        "datetime": "2014-05-21 02:03:34",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-05-21 04:47:38",
        "timezone": "UTC"
      }
    },
    { ... }
  ],
  "meta": {
    "pagination": {
      "total": 9,
      "count": 9,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a product with that UCPC.",
  "status_code": 404
}

Producers

Product Object

Cannabis products in the Cannabis Reports system.

Cannabis products cover a wide variety of additional products that contain cannabis. Anything that wouldn't be consumed like an edible or extract falls into this category. We also have pre-rolled cannabis in this category.

The main forms of products that Cannabis Reports recognizes are:

  • Bath
  • Topical
  • Skin Care
  • Pre-Roll

We also support "Other" types of products. Some examples are:

  • Lip Balm
  • Massage Oil
  • Personal Lubricant

Producers measure the amount of cannabis in their products in a variety of ways. We recognize 4 ways for measuring the cannabis contents:

  • THC mg
  • CBD mg
  • Cannabis mg
  • Hash Oil mg

More information about cannabis products can be found in our FAQ here:

https://www.cannabisreports.com/faq/typesconsumption/what-is-a-cannabis-product

NameTypeDescription

name

string

Name of the product.

ucpc

string

UCPC code for this product.

link

url

Link to the product in the Cannabis Reports API.

qr

url

Link to the QR code for this product.

barcode

url

Link to the barcode for this product.

url

url

Link to the product listing on the Cannabis Reports website.

image

url

Link to the full size image for this product.

producer

object

Information about the producer that created the product.

producer.name

string

Name of the producer of the product.

producer.ucpc

string

UCPC for the producer.

producer.link

url

Link to the producer in the Cannabis Reports API.

type

string

Type of cannabis product.

strain

object

Strain that was used in this product.

strain.name

string

Name of the strain used in this product.

strain.ucpc

string

UCPC of the strain used in this product.

strain.link

url

Link to the strain used in this product in the Cannabis Reports API.

labTest

url

Link to the PDF containing lab test information for this product.

thc

string

Milligrams of THC in this product.

cbd

string

Milligrams of CBD in this product.

cannabis

string

Milligrams of cannabis in this product.

hashOil

string

Milligrams of hash oil in this product.

reviews

object

Object containing information on the reviews for the product.

reviews.count

integer

Number of reviews for the product.

reviews.link

url

Link to the reviews for the product.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the product was added.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the product was updated.

Explore Product Endpoints

Here are some of the results available from the different product endpoints:

EndpointResult

Gets a paginated list of products with optional sorting.

Gets a paginated list of products for a given type with optional sorting.

Gets an individual product based on the UCPC.

Gets the reviews for a cannabis product.

Gets the average effects and flavors from reviews for this product.

Gets the producer for a given product.

Gets the information about a strain for a product with the given UCPC.

Get information about the availability of a product using latitude and longitude.

get

get

Gets a paginated list of producers from the system.

get

get

Gets an individual producer based on the UCPC.

Gets an individual producer based on the UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC of the producer you want information about.

    Example:

    0000000000L6M7E0000000000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Kiva",
    "ucpc": "0000000000L6M7E0000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000",
    "qr": "https://www.cannabisreports.com/producer-reports/kiva/qr-code",
    "url": "https://www.cannabisreports.com/producer-reports/kiva",
    "image": "https://www.cannabisreports.com/images/profile/8/full_8b44ce75bfba676790018d8a1d275d4d736883a9.jpg",
    "reviews": {
      "count": 4,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000/reviews"
    },
    "extracts": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000/extracts"
    },
    "edibles": {
      "count": 16,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000/edibles"
    },
    "products": {
      "count": 0,
      "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000/products"
    },
    "createdAt": {
      "datetime": "2014-07-09 22:41:29",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-05-05 23:19:23",
      "timezone": "UTC"
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

get

get

Gets a paginated list of extracts for a producer with the given UCPC.

Gets a paginated list of extracts for a producer with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC of the producer you want information about.

    Example:

    0000000000L6M7E0000000000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Blackberry Kush - Oil",
      "ucpc": "9XVU79H97ZVU7TGC4LET00000",
      "link": "https://www.cannabisreports.com/api/v1.0/extracts/9XVU79H97ZVU7TGC4LET00000",
      "qr": "https://www.cannabisreports.com/extract-reports/qr-code/absolute-xtracts/unknown-breeder/blackberry-kush/oil.png",
      "barcode": "https://www.cannabisreports.com/extract-reports/barcode/absolute-xtracts/unknown-breeder/blackberry-kush/oil.png",
      "url": "https://www.cannabisreports.com/extract-reports/absolute-xtracts/unknown-breeder/blackberry-kush/oil",
      "image": "https://www.cannabisreports.com/images/extracts/oil.jpg",
      "producer": {
        "name": "Absolute Xtracts",
        "ucpc": "0000000000VU7TG0000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000VU7TG0000000000"
      },
      "type": "oil",
      "strain": {
        "name": "Blackberry Kush",
        "ucpc": "9XVU79H97Z000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU79H97Z000000000000000"
      },
      "labTest": false,
      "thc": false,
      "cbd": false,
      "reviews": 0,
      "createdAt": {
        "datetime": "2015-04-10 18:37:16",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-04-10 18:37:16",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 18,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 2,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/producers/0000000000VU7TG0000000000/extracts?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

get

get

Gets a paginated list of edibles for a producer with the given UCPC.

Gets a paginated list of edibles for a producer with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC of the producer you want information about.

    Example:

    0000000000L6M7E0000000000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Terra Blueberry Bites",
      "ucpc": "0000000000L6M7ENLJVX00000",
      "link": "https://www.cannabisreports.com/api/v1.0/edibles/0000000000L6M7ENLJVX00000",
      "qr": "https://www.cannabisreports.com/edible-reports/qr-code/kiva/terra-blueberry-bites",
      "barcode": "https://www.cannabisreports.com/edible-reports/barcode/kiva/terra-blueberry-bites",
      "url": "https://www.cannabisreports.com/edible-reports/kiva/terra-blueberry-bites",
      "image": "https://www.cannabisreports.com/images/edibles/f/full_f29d34f36f40c96e26419caad6a668618bd417bb.jpg",
      "producer": {
        "name": "Kiva",
        "ucpc": "0000000000L6M7E0000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000"
      },
      "type": "chocolate",
      "strain": [],
      "labTest": false,
      "thc": "120mg",
      "cbd": false,
      "cannabis": false,
      "hashOil": false,
      "reviews": 2,
      "createdAt": {
        "datetime": "2015-03-12 21:02:48",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-03-12 21:02:48",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 16,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 2,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/producers/0000000000L6M7E0000000000/edibles?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

get

get

Gets a paginated list of products for a producer with the given UCPC.

Gets a paginated list of products for a producer with the given UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC of the producer you want information about.

    Example:

    0000000000L6M7E0000000000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Herb Infused Joint - Lobelia - Pre-roll",
      "ucpc": "0000000000N4E9N9XFK900000",
      "link": "https://www.cannabisreports.com/api/v1.0/products/0000000000N4E9N9XFK900000",
      "qr": "https://www.cannabisreports.com/product-reports/qr-code/divine-remedies/herb-infused-joint-lobelia.png",
      "barcode": "https://www.cannabisreports.com/product-reports/barcode/divine-remedies/herb-infused-joint-lobelia.png",
      "url": "https://www.cannabisreports.com/product-reports/divine-remedies/herb-infused-joint-lobelia",
      "image": "https://www.cannabisreports.com/images/products/5/full_551aa62ec2dd145da3adc9eafe22ee4e4c331ee7.jpg",
      "producer": {
        "name": "Divine Remedies",
        "ucpc": "0000000000N4E9N0000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000N4E9N0000000000"
      },
      "type": "pre-roll",
      "strain": [],
      "labTest": false,
      "thc": false,
      "cbd": false,
      "cannabis": false,
      "hashOil": false,
      "reviews": 0,
      "createdAt": {
        "datetime": "2015-02-09 05:13:52",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-02-11 00:00:53",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 8,
      "count": 8,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 1,
      "links": []
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

get

This will provide a paginated list of item summary objects for all availability from this producer.

get

Get information about the availability of everything from a producer using latitude and longitude.

Get information about the availability of everything from a producer using latitude and longitude.

URI Parameters

  • ucpc: required (string)

    UCPC of the producer you want information about.

    Example:

    0000000000L6M7E0000000000
  • lat: required (string)

    Latitude for the center of your availability search.

    Example:

    37.7749295
  • lng: required (string)

    Longitude for the center of your availability search.

    Example:

    -122.4194155
  • radius: required (integer)

    Radius to search for in miles, max 25.

    Example:

    10

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Sour Diesel - Vaporizer Cartridge",
      "ucpc": "9XVU7KVPFZVU7TGTLXET00000",
      "link": "https://www.cannabisreports.com/api/v1.0/extracts/9XVU7KVPFZVU7TGTLXET00000",
      "type": "extract",
      "location": {
        "name": "SFFOGG",
        "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/sffogg",
        "lat": "37.7717311",
        "lng": "-122.4165409"
      },
      "price": null,
      "price_half_gram": "0.00",
      "price_gram": "40.00",
      "price_eighth": null,
      "price_quarter": null,
      "price_half_ounce": null,
      "price_ounce": null,
      "createdAt": {
        "datetime": "2014-11-24 22:46:52",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-05-06 16:47:46",
        "timezone": "UTC"
      }
    },
    { ... }
  ],
  "meta": {
    "pagination": {
      "total": 152,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 16,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/producers/0000000000VU7TG0000000000/availability/geo/37.7749295/-122.4194155/25?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

Dispensaries

Dispensary Object

Cannabis dispensaries, deliveries, and retailers in the Cannabis Reports system.

Cannabis Reports currently refers to all types of retailers in the API as a dispensary. Delivery services will not have an address associated with them, only a location. The dispensary menus are split into strains, extracts, edibles, and products.

NameTypeDescription

name

string

Name of the dispensary.

link

url

Link to the dispensary in the Cannabis Reports API.

qr

url

Link to the QR code for this dispensary.

url

url

Link to the dispensary listing on the Cannabis Reports website.

image

url

Link to the full size logo image for this dispensary.

state

string

Two character representation of the state this dispensary is in.

city

string

City this dispensary is in.

lat

string

Latitude of this dispensary.

lng

string

Longitude of this dispensary.

address

object

Object containing additional location information for this dispensary.

address.address1

string

Street address for this dispensary.

address.address2

string

Additional street address line for this dispensary.

address.zip

string

Zip Code for this dispensary.

slug

string

Identifier for this dispensary; a combination of city and state.

reviews

object

Object containing information about reviews for this dispensary.

reviews.count

integer

The number of reviews for items from this dispensary.

reviews.link

url

Link to the reviews for this dispensary in the Cannabis Reports API.

strains

object

Object containing information about strains available at this dispensary.

strains.count

integer

The number of flowers available from the dispensary.

strains.link

url

Link to flower menu items available from this dispensary.

extracts

object

Object containing information about extracts available at this dispensary.

extracts.count

integer

The number of extracts available at this dispensary.

extracts.link

url

Link to extracts menu items available from this dispensary.

edibles

object

Object containing information about edibles available at this dispensary.

edibles.count

integer

Number of edibles available at this dispensary.

edibles.link

url

Link to edible menu items available from this dispensary.

products

object

Object containing information about products available at this dispensary.

products.count

integer

The number of products available at this dispensary.

products.link

url

Link to product menu items available from this dispensary.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the dispensary was updated.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the dispensary was added.

Explore Dispensary Endpoints

Here are some of the results available from the different dispensary endpoints:

Gets a paginated list of dispensaries from the system.

Gets information about an individual dispensary based on the state, city, and slug.

Gets a paginated list of strains for a dispensary from the given information.

Gets a paginated list of extracts for a dispensary from the given information.

Gets a paginated list of edibles for a dispensary from the given information.

Gets a paginated list of products for a dispensary from the given information.

Menu items for dispensaries.

When getting menu items from dispensaries, the API will return an object containing strain, extract, edible, or product, as well as the pricing information for the item.

NameTypeDescription

name

string

Name of the item.

type

string

Type of item: strain, extract, edible, or product.

item

object

price

string

The price for the item. This is null for strains and extracts.

price_half_gram

string

Price for one half gram of the item. This is null for edibles and products.

price_gram

string

Price for one gram of this item. This is null for edibles and products.

price_eighth

string

Price for one eighth ounce of this item. This is null for edibles and products.

price_quarter

string

Price for one quarter ounce of this item. This is null for edibles and products.

price_half_ounce

string

Price for one half ounce of this item. This is null for edibles and products.

price_ounce

string

Price for one ounce of this item. This is null for edibles and products.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the dispensary was updated.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the dispensary was added.

Menu item summary for when it is known what the menu item is.

When getting menu item information about an already known item, like in many of our availability endpoints, the API will return pricing and location information.

NameTypeDescription

name

string

Name of the item.

ucpc

string

UCPC of the item.

type

string

The type of item this is: strain, extract, or product.

location

object

Object containing information about the location this item is at.

location.name

string

Name of the location this item is at.

location.link

url

Link to this dispensary in the Cannabis Reports API.

location.lat

string

Latitude of the dispensary this item is at.

location.lng

string

Longitude of the dispensary this item is at.

price

string

The price for the item. This is null for strains and extracts.

price_half_gram

string

Price for one half gram of the item. This is null for edibles and products.

price_gram

string

Price for one gram of this item. This is null for edibles and products.

price_eighth

string

Price for one eighth ounce of this item. This is null for edibles and products.

price_quarter

string

Price for one quarter ounce of this item. This is null for edibles and products.

price_half_ounce

string

Price for one half ounce of this item. This is null for edibles and products.

price_ounce

string

Price for one ounce of this item. This is null for edibles and products.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the dispensary was updated.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the dispensary was added.

get

get

Gets a paginated list of dispensaries from the system.

get

More information about the various fields can be found in the dispensary object section of the documentation.

get

Gets information about an individual dispensary based on the state, city, and slug.

Gets information about an individual dispensary based on the state, city, and slug.

URI Parameters

  • state: required (string)

    Two character state for the dispensary.

    Example:

    ca
  • city: required (string)

    City the dispensary is in.

    Example:

    san-francisco
  • slug: required (string)

    Slug for the name of the dispensary.

    Example:

    grass-roots

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Grass Roots",
    "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots",
    "qr": "https://www.cannabisreports.com/dispensary-reports/ca/san-francisco/grass-roots/qr-code",
    "url": "https://www.cannabisreports.com/dispensary-reports/ca/san-francisco/grass-roots",
    "image": "https://www.cannabisreports.com/images/profile/5/full_5720f041410b18488b6e4b92c0a3ce598bec3ea8.jpg",
    "state": "CA",
    "city": "San Francisco",
    "slug": "ca/san-francisco/grass-roots",
    "lat": "37.7866941",
    "lng": "-122.4194293",
    "address": {
      "address1": "1077 Post Street",
      "address2": "",
      "zip": "94109"
    },
    "reviews": {
      "count": 55,
      "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/reviews"
    },
    "strains": {
      "count": 39,
      "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/strains"
    },
    "extracts": {
      "count": 58,
      "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/extracts"
    },
    "edibles": {
      "count": 167,
      "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/edibles"
    },
    "products": {
      "count": 54,
      "link": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/products"
    },
    "createdAt": {
      "datetime": "2015-04-24 20:13:46",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-04-24 20:13:46",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a dispensary with that information.",
  "status_code": 404
}

get

This will return an array of dispensary menu items with strains for the items. More information about dispensary menu items can be found in the menu item object section of the documentation.

More information about the strain fields can be found in the strain object section of the documentation.

get

Get a paginated list of strains for a dispensary from the given information.

Get a paginated list of strains for a dispensary from the given information.

URI Parameters

  • state: required (string)

    Two character state for the dispensary.

    Example:

    ca
  • city: required (string)

    City the dispensary is in.

    Example:

    san-francisco
  • slug: required (string)

    Slug for the name of the dispensary.

    Example:

    grass-roots

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Blackberry Kush - Oil",
      "ucpc": "9XVU79H97ZVU7TGC4LET00000",
      "link": "https://www.cannabisreports.com/api/v1.0/extracts/9XVU79H97ZVU7TGC4LET00000",
      "qr": "https://www.cannabisreports.com/extract-reports/qr-code/absolute-xtracts/unknown-breeder/blackberry-kush/oil.png",
      "barcode": "https://www.cannabisreports.com/extract-reports/barcode/absolute-xtracts/unknown-breeder/blackberry-kush/oil.png",
      "url": "https://www.cannabisreports.com/extract-reports/absolute-xtracts/unknown-breeder/blackberry-kush/oil",
      "image": "https://www.cannabisreports.com/images/extracts/oil.jpg",
      "producer": {
        "name": "Absolute Xtracts",
        "ucpc": "0000000000VU7TG0000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000VU7TG0000000000"
      },
      "type": "oil",
      "strain": {
        "name": "Blackberry Kush",
        "ucpc": "9XVU79H97Z000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU79H97Z000000000000000"
      },
      "labTest": false,
      "thc": false,
      "cbd": false,
      "reviews": 0,
      "createdAt": {
        "datetime": "2015-04-10 18:37:16",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-04-10 18:37:16",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 18,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 2,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/producers/0000000000VU7TG0000000000/extracts?page=2"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

get

This will return an array of dispensary menu items with extracts for the items. More information about dispensary menu items can be found in the menu item object section of the documentation.

More information about the strain fields can be found in the strain object section of the documentation.

get

Get a paginated list of extracts for a dispensary from the given information.

Get a paginated list of extracts for a dispensary from the given information.

URI Parameters

  • state: required (string)

    Two character state for the dispensary.

    Example:

    ca
  • city: required (string)

    City the dispensary is in.

    Example:

    san-francisco
  • slug: required (string)

    Slug for the name of the dispensary.

    Example:

    grass-roots

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Bubblegum - Vaporizer Cartridge",
      "type": "extract",
      "item": {
        "name": "Bubblegum - Vaporizer Cartridge",
        "ucpc": "VRTEW9D296P93C7HHCVM00000",
        "link": "https://www.cannabisreports.com/api/v1.0/extracts/VRTEW9D296P93C7HHCVM00000",
        "qr": "https://www.cannabisreports.com/extract-reports/qr-code/gold-drop/thseeds/bubblegum/vaporizer-cartridge.png",
        "barcode": "https://www.cannabisreports.com/extract-reports/barcode/gold-drop/thseeds/bubblegum/vaporizer-cartridge.png",
        "url": "https://www.cannabisreports.com/extract-reports/gold-drop/thseeds/bubblegum/vaporizer-cartridge",
        "image": "https://www.cannabisreports.com/images/extracts/5/full_5dc14aff95a88e78e77fb4e9e28ff06584b8e174.jpg",
        "producer": {
          "name": "Gold Drop",
          "ucpc": "0000000000P93C70000000000",
          "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000P93C70000000000"
        },
        "type": "vaporizer cartridge",
        "strain": {
          "name": "Bubblegum",
          "ucpc": "VRTEW9D296000000000000000",
          "link": "https://www.cannabisreports.com/api/v1.0/strains/VRTEW9D296000000000000000"
        },
        "labTest": false,
        "thc": false,
        "cbd": false,
        "reviews": 0,
        "createdAt": {
          "datetime": "2015-03-10 04:57:00",
          "timezone": "UTC"
        },
        "updatedAt": {
          "datetime": "2015-03-16 22:52:20",
          "timezone": "UTC"
        }
      },
      "price": null,
      "price_half_gram": "30.00",
      "price_gram": "66.50",
      "price_eighth": null,
      "price_quarter": null,
      "price_half_ounce": null,
      "price_ounce": null,
      "createdAt": {
        "datetime": "2015-04-29 21:39:52",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-04-29 21:40:34",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 58,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 6,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/extracts?page=2"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

get

This will return an array of dispensary menu items with edibles for the items. More information about dispensary menu items can be found in the menu item object section of the documentation.

More information about the strain fields can be found in the strain object section of the documentation.

get

Get a paginated list of edibles for a dispensary from the given information.

Get a paginated list of edibles for a dispensary from the given information.

URI Parameters

  • state: required (string)

    Two character state for the dispensary.

    Example:

    ca
  • city: required (string)

    City the dispensary is in.

    Example:

    san-francisco
  • slug: required (string)

    Slug for the name of the dispensary.

    Example:

    grass-roots

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Ultra Potent Gingerbread",
      "type": "edible",
      "item": {
        "name": "Ultra Potent Gingerbread",
        "ucpc": "0000000000XUQ2T6XXYA00000",
        "link": "https://www.cannabisreports.com/api/v1.0/edibles/0000000000XUQ2T6XXYA00000",
        "qr": "https://www.cannabisreports.com/edible-reports/qr-code/on-the-rise/ultra-potent-gingerbread",
        "barcode": "https://www.cannabisreports.com/edible-reports/barcode/on-the-rise/ultra-potent-gingerbread",
        "url": "https://www.cannabisreports.com/edible-reports/on-the-rise/ultra-potent-gingerbread",
        "image": "https://www.cannabisreports.com/images/strains/no_image.png",
        "producer": {
          "name": "On The Rise",
          "ucpc": "0000000000XUQ2T0000000000",
          "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000XUQ2T0000000000"
        },
        "type": "baked good",
        "strain": [],
        "labTest": false,
        "thc": false,
        "cbd": false,
        "cannabis": "10,000mg",
        "hashOil": false,
        "reviews": 0,
        "createdAt": {
          "datetime": "2015-04-29 22:30:41",
          "timezone": "UTC"
        },
        "updatedAt": {
          "datetime": "2015-04-29 22:31:08",
          "timezone": "UTC"
        }
      },
      "price": "40.00",
      "price_half_gram": null,
      "price_gram": null,
      "price_eighth": null,
      "price_quarter": null,
      "price_half_ounce": null,
      "price_ounce": null,
      "createdAt": {
        "datetime": "2015-04-29 22:30:58",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2015-04-29 22:30:58",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 167,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 17,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/edibles?page=2"
      }
    }
  }
}

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

get

This will return an array of dispensary menu items with products for the items. More information about dispensary menu items can be found in the menu item object section of the documentation.

More information about the strain fields can be found in the strain object section of the documentation.

get

Get a paginated list of products for a dispensary from the given information.

Get a paginated list of products for a dispensary from the given information.

URI Parameters

  • state: required (string)

    Two character state for the dispensary.

    Example:

    ca
  • city: required (string)

    City the dispensary is in.

    Example:

    san-francisco
  • slug: required (string)

    Slug for the name of the dispensary.

    Example:

    grass-roots

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Purple Church - Pre-roll",
      {
        "data": [
          {
            "name": "Purple Church - Pre-roll",
            "type": "product",
            "item": {
              "name": "Purple Church - Pre-roll",
              "ucpc": "9XVU7AHUZ3C3T4JH3V2N00000",
              "link": "https://www.cannabisreports.com/api/v1.0/products/9XVU7AHUZ3C3T4JH3V2N00000",
              "qr": "https://www.cannabisreports.com/product-reports/qr-code/medi-cone/purple-church.png",
              "barcode": "https://www.cannabisreports.com/product-reports/barcode/medi-cone/purple-church.png",
              "url": "https://www.cannabisreports.com/product-reports/medi-cone/purple-church",
              "image": "https://www.cannabisreports.com/images/strains/no_image.png",
              "producer": {
                "name": "Medi Cone",
                "ucpc": "0000000000C3T4J0000000000",
                "link": "https://www.cannabisreports.com/api/v1.0/producers/0000000000C3T4J0000000000"
              },
              "type": "pre-roll",
              "strain": {
                "name": "Purple Church",
                "ucpc": "9XVU7AHUZ3000000000000000",
                "link": "https://www.cannabisreports.com/api/v1.0/strains/9XVU7AHUZ3000000000000000"
              },
              "labTest": false,
              "thc": false,
              "cbd": false,
              "cannabis": false,
              "hashOil": false,
              "reviews": 0,
              "createdAt": {
                "datetime": "2015-02-11 04:47:39",
                "timezone": "UTC"
              },
              "updatedAt": {
                "datetime": "2015-02-11 04:47:39",
                "timezone": "UTC"
              }
            },
            "price": "12.00",
            "price_half_gram": null,
            "price_gram": null,
            "price_eighth": null,
            "price_quarter": null,
            "price_half_ounce": null,
            "price_ounce": null,
            "createdAt": {
              "datetime": "2015-04-29 21:11:48",
              "timezone": "UTC"
            },
            "updatedAt": {
              "datetime": "2015-04-29 21:11:48",
              "timezone": "UTC"
            }
          },
          {...}
        ],
        "meta": {
          "pagination": {
            "total": 54,
            "count": 10,
            "per_page": 10,
            "current_page": 1,
            "total_pages": 6,
            "links": {
              "next": "https://www.cannabisreports.com/api/v1.0/dispensaries/ca/san-francisco/grass-roots/products?page=2"
            }
          }
        }
      }

HTTP status code 400

Body

Type: application/json

Example:

{
  "message": "Invalid sort. Please refer to the documentation for appropriate sorts.",
  "status_code": 400
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a producer with that UCPC.",
  "status_code": 404
}

Seed Companies

Seed Company Object

Seed Companies in the Cannabis Reports system.

Cannabis seed companies create the variety of strains available for growing and breeding.

Seed Company Attributes

name

string

Name of the cannabis seed company.

ucpc

string

UCPC code for this seed company.

link

url

Link to the seed company in the Cannabis Reports API.

qr

url

Link to the QR code for this seed company.

url

'url'

Link to the seed company on the Cannabis Reports website.

image

url

Link to the full size image for this seed company on Cannabis Reports.

lineage

object

Countries of origin for the genetics of the strains available from this seed company. Object keys are the country name and the values are two character country codes.

strains

object

Object containing information on the strains available from this seed company.

strains.count

integer

Number of strains available from this seed company.

strains.link

url

Link to the strains available from this seed company.

reviews

object

Object containing information on the reviews for all of the strains available from this seed company.

reviews.count

integer

The number of reviews for all of the strains available from this seed company.

reviews.link

url

Links to the reviews for all of the strains available from this seed company.

createdAt

object

Object containing two strings, "dateTime" and the "timezone" when the seed company was added.

updatedAt

object

Object containing two strings, "dateTime" and the "timezone" when the seed company was updated.

Explore Seed Company Endpoints

Here are some of the results available from the different seed company endpoints:

EndpointResult

Gets an individual seed company based on the UCPC.

Gets the information about the strains offered by the seed company.

Gets the reviews for the strains available from the seed company.

get

get

Gets an individual seed company based on the UCPC.

Gets an individual seed company based on the UCPC.

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis seed company you want information about.

    Example:

    VUJCJ00000000000000000000

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": {
    "name": "Sensi Seeds",
    "ucpc": "VUJCJ00000000000000000000",
    "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000",
    "qr": "https://www.cannabisreports.com/strain-reports/sensi-seeds/qr-code.svg",
    "url": "https://www.cannabisreports.com/strain-reports/sensi-seeds",
    "image": "https://www.cannabisreports.com/images/profile/1/full_15fda07a135540c1de6afbb38dafe2113a11a7a4.jpg",
    "lineage": {
      "Afghanistan": "AF",
      "Canada": "CA",
      "Colombia": "CO",
      "Hungary": "HU",
      "India": "IN",
      "Indonesia": "ID",
      "Jamaica": "JM",
      "Malawi": "MW",
      "Mexico": "MX",
      "Nepal": "NP",
      "Nigeria": "NG",
      "Pakistan": "PK",
      "Panama": "PA",
      "South Africa": "ZA",
      "Thailand": "TH",
      "United States": "US"
    },
    "strains": {
      "count": 63,
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000/strains"
    },
    "reviews": {
      "count": 25,
      "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000/reviews"
    },
    "createdAt": {
      "datetime": "2014-04-09 09:29:57",
      "timezone": "UTC"
    },
    "updatedAt": {
      "datetime": "2015-01-08 20:05:52",
      "timezone": "UTC"
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a seedc company with that UCPC.",
  "status_code": 404
}

get

Gets the information about the strains offered by the seed company.

get

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis seed company you want information about.

    Example:

    VUJCJ00000000000000000000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "name": "Black Domina",
      "ucpc": "VUJCJVRU4N000000000000000",
      "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJVRU4N000000000000000",
      "qr": "https://www.cannabisreports.com/strain-reports/sensi-seeds/black-domina/qr-code.svg",
      "url": "https://www.cannabisreports.com/strain-reports/sensi-seeds/black-domina",
      "image": "https://www.cannabisreports.com/images/strains/2/full_28da06cc8436f90fa2a70839331ed9debf417081.jpg",
      "seedCompany": {
        "name": "Sensi Seeds",
        "ucpc": "VUJCJ00000000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000"
      },
      "genetics": {
        "names": "Northern Lights / Ortega C99 / Hash Plant (Sensi) / Afghani Landrace",
        "ucpc": "2NGAWWTJNV000000000000000 / 3CV7EKUTCE000000000000000 / VUJCJZ9MNQ000000000000000 / 9XVU7HGAVW000000000000000",
        "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJVRU4N000000000000000/genetics"
      },
      "lineage": {
        "Afghanistan": "AF",
        "Colombia": "CO",
        "India": "IN",
        "Mexico": "MX",
        "Thailand": "TH"
      },
      "children": {
        "count": 22,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJVRU4N000000000000000/children"
      },
      "reviews": {
        "count": 3,
        "link": "https://www.cannabisreports.com/api/v1.0/strains/VUJCJVRU4N000000000000000/reviews"
      },
      "createdAt": {
        "datetime": "2008-08-15 19:20:00",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-06-25 23:05:43",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 63,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 7,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000/strains?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a seedc company with that UCPC.",
  "status_code": 404
}

get

Gets the reviews for the strains available from the seed company.

get

URI Parameters

  • ucpc: required (string)

    UCPC for the cannabis seed company you want information about.

    Example:

    VUJCJ00000000000000000000

Query Parameters

  • page: (integer)

    Which page of results you want.

    By default, Cannabis Reports will return 10 records at a time for the strains API. You can use the page argument to fetch the page of results you want.

    Check out the pagination section of this documentation for more information.

  • sort: (string)

    How you would like the results sorted.

    You can include a single sort option to get the records by when they were updated, created, or alphabetically.

    Sort OptionSort Direction
    createdAtOldest records.
    -createdAtNewest records.
    updatedAtOldest updated records
    -updatedAtNewly updated records.
    nameAlphabetically stating with numeric strains. 0-9, A-Z.
    -nameAlphabetically starting with Z and working back through numeric strains. Z-A, 9-0.

HTTP status code 200

Body

Type: application/json

Example:

{
  "data": [
    {
      "link": "https://www.cannabisreports.com/api/v1.0/reviews/8816186ce68961c874f0b92a487a2f38fc4acee0",
      "url": "https://www.cannabisreports.com/smoke-reports/2009/11/11/8816186ce68961c874f0b92a487a2f38fc4acee0/anonymous",
      "euphoria": "8",
      "creativity": null,
      "pain_relief": null,
      "appetite_gain": "6",
      "calming": null,
      "anxiety": "3",
      "spicy": "0",
      "earthy": "0",
      "fruity": "6",
      "sour": "2",
      "dry_mouth": null,
      "createdAt": {
        "datetime": "2009-11-11 02:40:05",
        "timezone": "UTC"
      },
      "updatedAt": {
        "datetime": "2014-05-16 03:20:38",
        "timezone": "UTC"
      }
    },
    {...}
  ],
  "meta": {
    "pagination": {
      "total": 25,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 3,
      "links": {
        "next": "https://www.cannabisreports.com/api/v1.0/seed-companies/VUJCJ00000000000000000000/reviews?page=2"
      }
    }
  }
}

HTTP status code 404

Body

Type: application/json

Example:

{
  "message": "Not found. Could not find a seedc company with that UCPC.",
  "status_code": 404
}