LeafLink Products API

The products API from LeafLink — 4 operation(s) for products.

Operations 9

POST /products #
PUT /products/{id} #
PATCH /products/{id} #
DELETE /products/{id} #
GET /products/ List products #
POST /products/ Create a product #
GET /products/{id}/ Retrieve a product #
PATCH /products/{id}/ Update a product #
DELETE /products/{id}/ Archive a product #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/leaflink-products-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

leaflink-products-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Leaflink Products API
  contact:
    email: support@leaflink.com
  version: '1.0'
  description: 'Operations tagged products across 2 of this provider''s published API definitions: leaflink-api-openapi-original.yml, leaflink-marketplace-v2-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.leaflink.com
  description: LeafLink API production URL.
- url: https://staging-api.leaflink.com
  description: LeafLink API staging URL.
- url: https://app.leaflink.com/api/v2
tags:
- name: products
paths:
  /products:
    post:
      operationId: products_create
      description: LeafLink API for Marketplace products.
      tags:
      - products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnifiedProductRequest'
        required: true
      security:
      - bearerAuth: []
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedProduct'
          description: ''
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: The requests quota in the time window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: The remaining requests quota in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: The time remaining in the current window, specified in seconds.
            RateLimit-Policy:
              schema:
                type: string
              description: The quota policy information.
        '429':
          description: Rate Limit Error
          headers:
            Retry-After:
              schema:
                type: integer
              description: The time remaining before the rejected request can be tried again, specified in seconds.
    servers:
    - url: https://api.leaflink.com
      description: LeafLink API production URL.
    - url: https://staging-api.leaflink.com
      description: LeafLink API staging URL.
  /products/{id}:
    put:
      operationId: products_update
      description: LeafLink API for Marketplace products.
      parameters:
      - in: path
        name: id
        schema:
          type: integer
        description: A unique integer value identifying this product.
        required: true
      - name: LeafLink-Version
        description: '[API version docs](/api/getting-started/#versioning)'
        required: false
        in: header
        schema:
          type: string
          format: date
      tags:
      - products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UnifiedProductRequest'
        required: true
      security:
      - bearerAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedProduct'
          description: ''
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: The requests quota in the time window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: The remaining requests quota in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: The time remaining in the current window, specified in seconds.
            RateLimit-Policy:
              schema:
                type: string
              description: The quota policy information.
        '429':
          description: Rate Limit Error
          headers:
            Retry-After:
              schema:
                type: integer
              description: The time remaining before the rejected request can be tried again, specified in seconds.
    patch:
      operationId: products_partial_update
      description: LeafLink API for Marketplace products.
      parameters:
      - in: path
        name: id
        schema:
          type: integer
        description: A unique integer value identifying this product.
        required: true
      - name: LeafLink-Version
        description: '[API version docs](/api/getting-started/#versioning)'
        required: false
        in: header
        schema:
          type: string
          format: date
      tags:
      - products
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchedUnifiedProductRequest'
      security:
      - bearerAuth: []
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnifiedProduct'
          description: ''
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: The requests quota in the time window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: The remaining requests quota in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: The time remaining in the current window, specified in seconds.
            RateLimit-Policy:
              schema:
                type: string
              description: The quota policy information.
        '429':
          description: Rate Limit Error
          headers:
            Retry-After:
              schema:
                type: integer
              description: The time remaining before the rejected request can be tried again, specified in seconds.
    delete:
      operationId: products_destroy
      description: 'Perform a ''DELETE'' on a product. It will mark the specified product as Archived.


        Logic is put here as the ModelViewSet destroy function doesn''t use the serializer.'
      parameters:
      - in: path
        name: id
        schema:
          type: integer
        description: A unique integer value identifying this product.
        required: true
      - name: LeafLink-Version
        description: '[API version docs](/api/getting-started/#versioning)'
        required: false
        in: header
        schema:
          type: string
          format: date
      tags:
      - products
      security:
      - bearerAuth: []
      responses:
        '204':
          description: No response body
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: The requests quota in the time window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: The remaining requests quota in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: The time remaining in the current window, specified in seconds.
            RateLimit-Policy:
              schema:
                type: string
              description: The quota policy information.
        '429':
          description: Rate Limit Error
          headers:
            Retry-After:
              schema:
                type: integer
              description: The time remaining before the rejected request can be tried again, specified in seconds.
    servers:
    - url: https://api.leaflink.com
      description: LeafLink API production URL.
    - url: https://staging-api.leaflink.com
      description: LeafLink API staging URL.
  /products/:
    parameters: []
    get:
      operationId: products_list
      summary: List products
      description: List products for all active companies where the user has the Manage Inventory permission. <br /> <br />Products can also be retrieved by company via <b>/companies/{company_id}/products/</b> <br />or by parent product via <b>/products/{parent_product_id}/products/</b>
      parameters:
      - name: sku
        in: query
        description: Filter by one or more sku, separated by commas.
        schema:
          type: string
      - name: fields_include
        in: query
        description: Include only specific fields in the response, separated by commas.
        schema:
          type: string
      - name: fields_exclude
        in: query
        description: Exclude specific fields in the response, separated by commas.
        schema:
          type: string
      - name: include_children
        in: query
        description: Include additional fields in the response.  Available values include `images`, `volume_discounts`, and `strains`
        schema:
          type: string
      - name: modified__lt
        in: query
        description: Filter by the modified date, less than
        required: false
        schema:
          type: string
      - name: modified__lte
        in: query
        description: Filter by the modified date, less than or equal to
        required: false
        schema:
          type: string
      - name: modified__gt
        in: query
        description: Filter by the modified on date, greater than
        required: false
        schema:
          type: string
      - name: modified__gte
        in: query
        description: Filter by the modified date, greater than or equal to
        required: false
        schema:
          type: string
      - name: last_edit__lt
        in: query
        description: Filter by last edit date, less than
        required: false
        schema:
          type: string
      - name: last_edit__lte
        in: query
        description: Filter by last edit date, less than or equal to
        required: false
        schema:
          type: string
      - name: last_edit__gt
        in: query
        description: Filter by last edit date, greater than
        required: false
        schema:
          type: string
      - name: last_edit__gte
        in: query
        description: Filter by last edit date, greater than or equal to
        required: false
        schema:
          type: string
      - name: created_on__lt
        in: query
        description: Filter by created on date, less than
        required: false
        schema:
          type: string
      - name: created_on__lte
        in: query
        description: Filter by created on date, less than or equal to
        required: false
        schema:
          type: string
      - name: created_on__gt
        in: query
        description: Filter by created on date, greater than
        required: false
        schema:
          type: string
      - name: created_on__gte
        in: query
        description: Filter by created on date, greater than or equal to
        required: false
        schema:
          type: string
      - name: id
        in: query
        description: Filter by product id
        required: false
        schema:
          type: number
      - name: name
        in: query
        description: Filter by name, case insensitive
        required: false
        schema:
          type: string
      - name: search
        in: query
        description: Filter by a search term
        required: false
        schema:
          type: string
      - name: display_name
        in: query
        description: Filter by display name, case insensitive
        required: false
        schema:
          type: string
      - name: brand
        in: query
        description: Filter by brand.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: company
        in: query
        description: Filter by company id.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: has_children
        in: query
        description: Filter by whether or not products have children
        required: false
        schema:
          type: string
      - name: parent
        in: query
        description: Filter by parent product id.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: parent__isnull
        in: query
        description: Filter by whether or not products are parent products.  A null value for parent indicated a parent product.
        required: false
        schema:
          type: string
      - name: sub_category__isnull
        in: query
        description: Filter by whether or not products have sub-categories assigned. Values can be `true` or `false`
        required: false
        schema:
          type: string
      - name: product_line
        in: query
        description: Filter by product line id.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: strains
        in: query
        description: Filter by strain id.  Values available at the /strains/ endpoint.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: category
        in: query
        description: Filter by category id.  Values available at the /product-categories/ endpoint.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: sub_category
        in: query
        description: Filter by sub_category id.  Values available at the /product-subcategories/ endpoint.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: license
        in: query
        description: Filter by license id.  Values available at the /licenses/ endpoint.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: license__isnull
        in: query
        description: Filter by license__isnull
        required: false
        schema:
          type: string
      - name: license__type
        in: query
        description: Filter by license type display name.  Values available at /license-types/ endpoint.  Multiple values separated by commas.
        required: false
        schema:
          type: number
      - name: listing_state
        in: query
        description: Filter by listing state id.  Values available at /listing-states/ endpoint.  Multiple values separated by commas.
        required: false
        schema:
          type: string
      - name: archived
        in: query
        description: Filter by whether or not the product is archived
        required: false
        schema:
          type: string
      - name: buyer
        in: query
        description: Filter by id for a specific buyer, view the products available to this buyer and the unique price_schedule_price if applicable
        required: false
        schema:
          type: number
      - name: s2s_connected
        in: query
        description: Filter by s2s_connected
        required: false
        schema:
          type: string
      - name: company_slug
        in: query
        description: Filter by the seller company slug
        required: false
        schema:
          type: string
      - name: seller_internal_id
        in: query
        description: Filter by internal product ID
        required: false
        schema:
          type: string
      - name: limit
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      - name: offset
        in: query
        description: The initial index from which to return the results.
        required: false
        schema:
          type: integer
      - name: external_id_key
        in: query
        description: Filter for orders that match external_ids key:values.  Must be used with external_id_values.
        schema:
          type: string
      - name: external_id_values
        in: query
        description: Filter for orders that match external_ids key:values.  Multiple values separated by a comma.  Must be used with external_id_key.
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  count:
                    type: integer
                  next:
                    type:
                    - string
                    - 'null'
                    format: uri
                  previous:
                    type:
                    - string
                    - 'null'
                    format: uri
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/ProductResponse'
                example:
                  count: 2
                  next: null
                  previous: null
                  results:
                  - id: 2093
                    created_on: '2020-02-19T00:36:22.353448-06:00'
                    last_edit: '2020-04-27T07:41:29.797149-06:00'
                    drop_date: null
                    dropped: null
                    name: Swiss Masters Chocolate Bar (Dark)
                    sku: SWI-BAR-DAR-100
                    description: <p>Our premium Swiss Masters chocolate bars are bold, rich, and steeped in chocolate tradition.  The Swiss Master dark chocolate has 70% dark chocolate paired with 100mg THC.</p>
                    quantity: '800.0000'
                    reserved_qty: '120.0000'
                    display_name: Swiss Masters Chocolate Bar (Dark)
                    unit_multiplier: 12
                    retail_price:
                      amount: 18
                      currency: USD
                    wholesale_price:
                      amount: 108
                      currency: USD
                    sale_price:
                      amount: 0
                      currency: USD
                    minimum_order: '1.0000'
                    maximum_order: null
                    is_medical_line_item: false
                    AVAILABLE_FOR_SAMPLES: true
                    extern_acct_id: null
                    extern_income_acct_id: ''
                    featured: false
                    tagline: null
                    featured_on_deals: false
                    allow_fractional_quantities: false
                    parent: null
                    listing_state: Available
                    display_listing_state: Available
                    inventory_management: 1
                    unit_of_measure: Unit
                    sell_in_unit_of_measure: Case
                    unit_denomination:
                      id: 1
                      value: '1.00000'
                      name: One
                      label: '1'
                    category: 7
                    grow_type: null
                    seller: 3721
                    seller_internal_id: PROD-001
                    brand: 49
                    product_line: 164
                    manufacturer: 3721
                    strain_classification: na
                    license:
                      id: 2619
                      number: 404R-00000
                      type: Recreational
                      display_type: Adult Use
                      classification: MIPS
                    available_inventory: 680
                    children_count: 0
                    strains: []
                    price_schedule_price:
                      amount: 108
                      currency: USD
                    image_count: 1
                    is_ancillary: false
                    s2s_conversion_amount: '1.0000'
                    extern_sts_ids: null
                    strain_classification_display: N/A
                    modified: '2020-06-11T15:53:07.137980-06:00'
                    sub_category: 14
                    has_deals_eligible_children: false
                    discount_percent: 0
                    base_units_per_unit: null
                    external_ids:
                      system-name: '1234567890'
                    threshold_value: 0
                    threshold_action: unavailable
                    reverse_threshold_value: 1
                    reverse_threshold_action: available
                    show_quantity: false
                  - id: 2094
                    created_on: '2020-02-22T00:36:22.353448-06:00'
                    last_edit: '2020-04-10T07:41:29.797149-06:00'
                    drop_date: null
                    dropped: null
                    name: Great Heights Chocolate Bar (Milk)
                    sku: GRE-BAR-CHO-100
                    description: <p>Our Great Heights chocolate bars are delicious.  The milk chocolate contains 100mg THC.</p>
                    quantity: '400.0000'
                    reserved_qty: '90.0000'
                    display_name: Great Heights Chocolate Bar (Milk)
                    unit_multiplier: 12
                    retail_price:
                      amount: 14
                      currency: USD
                    wholesale_price:
                      amount: 100
                      currency: USD
                    sale_price:
                      amount: 0
                      currency: USD
                    minimum_order: '1.0000'
                    maximum_order: null
                    is_medical_line_item: false
                    AVAILABLE_FOR_SAMPLES: true
                    extern_acct_id: null
                    extern_income_acct_id: ''
                    featured: false
                    tagline: null
                    featured_on_deals: false
                    allow_fractional_quantities: false
                    parent: null
                    listing_state: Available
                    display_listing_state: Available
                    inventory_management: 1
                    unit_of_measure: Unit
                    sell_in_unit_of_measure: Case
                    unit_denomination:
                      id: 1
                      value: '1.00000'
                      name: One
                      label: '1'
                    category: 7
                    grow_type: null
                    seller: 3721
                    seller_internal_id: PROD-002
                    brand: 49
                    product_line: 164
                    manufacturer: 3721
                    strain_classification: na
                    license:
                      id: 2619
                      number: 404R-00000
                      type: Recreational
                      display_type: Adult Use
                      classification: MIPS
                    available_inventory: 310
                    children_count: 0
                    strains: []
                    price_schedule_price:
                      amount: 100
                      currency: USD
                    image_count: 1
                    is_ancillary: false
                    s2s_conversion_amount: '1.0000'
                    extern_sts_ids: null
                    strain_classification_display: N/A
                    modified: '2020-06-11T15:53:07.137980-06:00'
                    sub_category: 14
                    has_deals_eligible_children: false
                    discount_percent: 0
                    base_units_per_unit: null
                    external_ids: {}
                    threshold_value: 0
                    threshold_action: unavailable
                    reverse_threshold_value: 1
                    reverse_threshold_action: available
                    show_quantity: true
                    product_data_items: []
      tags:
      - products
      security:
      - Token: []
    post:
      operationId: products_create
      summary: Create a product
      description: Create a new product.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductCreate'
      responses:
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductResponse'
      tags:
      - products
      security:
      - Token: []
    servers:
    - url: https://app.leaflink.com/api/v2
  /products/{id}/:
    parameters:
    - name: id
      in: path
      description: The id for the product.
      required: true
      schema:
        type: integer
    get:
      operationId: products_read
      summary: Retrieve a product
      description: Retrieve an individual product.
      parameters:
      - name: fields_include
        in: query
        description: Include only specific fields in the response, separated by commas.
        schema:
          type: string
      - name: fields_exclude
        in: query
        description: Exclude specific fields in the response, separated by commas.
        schema:
          type: string
      - name: include_children
        in: query
        description: Include additional fields in the response.  Available values include `images`, `volume_discounts`, and `strains`
        schema:
          type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductResponse'
      tags:
      - products
      security:
      - Token: []
    patch:
      operationId: products_partial_update
      summary: Update a product
      description: Update an existing product.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductUpdate'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductUpdateResponse'
      tags:
      - products
      security:
      - Token: []
    delete:
      operationId: products_delete
      summary: Archive a product
      description: Archive a product.
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductArchiveResponse'
      tags:
      - products
      security:
      - Token: []
    servers:
    - url: https://app.leaflink.com/api/v2
components:
  schemas:
    ListingStateEnum:
      enum:
      - Available
      - Archived
      - Sample
      - Backorder
      - Internal
      - Unavailable
      type: string
    CustomMenuItemRequest:
      type: object
      description: A single custom menu (Price Schedule) price assignment for a product.
      properties:
        id:
          type: integer
          description: Custom Menu ID
        amount:
          type: string
          format: decimal
          pattern: ^-?\d{0,8}(?:\.\d{0,2})?$
          description: Custom price for the product on this custom menu
        currency:
          type: string
          minLength: 1
          description: ISO currency code. Defaults to the seller's currency.
      required:
      - amount
      - id
    UnifiedBrand:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          title: Brand Name
          description: Name of the Brand
          maxLength: 400
      required:
      - id
      - name
    PatchedUnifiedProductRequest:
      type: object
      description: Unified Product serializer.
      properties:
        name:
          type: string
          minLength: 1
          description: Product name
        description:
          type: string
          minLength: 1
          description: Product details
        category_id:
          type: integer
          writeOnly: true
          description: Product category ID for the product
        listing_state:
          allOf:
          - $ref: '#/components/schemas/ListingStateEnum'
          description: Product listing state. Values available at the /listing-states/ endpoint.
        wholesale_price:
          type: object
          properties:
            amount:
              type: number
            currency:
              type: string
          description: Wholesale price displayed in the LeafLink marketplace
        unit_multiplier:
          type: integer
          description: How many individual units are sold when compared to the assigned unit of measure
        unit_denomination:
          type: string
          format: decimal
          pattern: ^-?\d{0,5}(?:\.\d{0,5})?$
          title: Unit Denomination Value
          description: The amount of individual products in one sale unit
        sku:
          type:
          - string
          - 'null'
          minLength: 1
          description: Stock keeping unit for the product
          maxLength: 255
        brand_id:
          type: integer
          writeOnly: true
          description: Brand ID for the product
        manufacturer_id:
          type: integer
          writeOnly: true
          description: ID of the Company that manufactured the product
        seller_id:
          type: integer
          description: Company who is selling the Product
        unit_of_measure:
          type: string
          minLength: 1
          description: Base unit of measure for this product
        custom_menu:
          type: array
          items:
            $ref: '#/components/schemas/CustomMenuItemRequest'
          writeOnly: true
          description: Assign or update custom menu (Price Schedule) prices for this product. Custom menus not included here are left unchanged.
    UnifiedProductInventory:
      type: object
      description: Unified Product inventory serializer
      properties:
        total_qty:
          type: number
          format: double
          exclusiveMinimum: -1.0e+95
          exclusiveMaximum: 1.0e+95
        reserved_qty:
          type: number
          format: double
          readOnly: true
      required:
      - reserved_qty
      - total_qty
    UnifiedProduct:
      type: object
      description: Unified Product serializer.
      properties:
        id:
          type: integer
          readOnly: true
        created_date:
          type: string
          format: date-time
          readOnly: true
          description: Date and time the resource was created
        modified_date:
          type: string
          format: date-time
          readOnly: true
          description: Date and time of the last edit
        name:
          type: string
          description: Product name
        display_name:
          type: string
          readOnly: true
          description: product name that is displayed
        description:
          type: string
          description: Product details
        category:
          allOf:
          - $ref: '#/components/schemas/UnifiedProductCategory'
          readOnly: true
          description: Product category for the product
        listing_state:
          allOf:
          - $ref: '#/components/schemas/ListingStateEnum'
          description: Product listing state. Values available at the /listing-states/ endpoint.
        wholesale_price:
          type: object
          properties:
            amount:
              type: number
            currency:
              type: string
          description: Wholesale price displayed in the LeafLink marketplace
        unit_multiplier:
          type: integer
          description: How many individual units are sold when compared to the assigned unit of measure
        unit_denomination:
          type: string
          format: decimal
          pattern: ^-?\d{0,5}(?:\.\d{0,5})?$
          title: Unit Denomination Value
          description: The amount of individual products in one sale unit
        inventory:
          allOf:
          - $ref: '#/components/schemas/UnifiedProductInventory'
          readOnly: true
          description: Total and reserved inventory for product
        sku:
          type:
          - string
          - 'null'
          description: Stock keeping unit for the product
          maxLength: 255
        brand:
          allOf:
          - $ref: '#/components/schemas/UnifiedBrand'
          readOnly: true
          description: Brand of the product
        seller_id:
          type: integer
          description: Company who is selli

# --- truncated at 32 KB (96 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/leaflink/refs/heads/main/openapi/leaflink-products-api-openapi.yml