Menu Feeds

Overview

POSaBIT provides a menu feed API that allows partners to pull product catalog data as JSON. Partners can use this to display menus on their platform and push orders back into the POSaBIT POS system.

Setup Steps

1 Create a Menu Feed

Follow the directions in Creating a POSaBIT Menu (steps 1–6) to create or reuse a menu feed for your partner.

2 Create an API Token

Follow the directions in Creating a POSaBIT Menu (steps 8–9) to generate an API token for the partner.

3 Share with the Partner

Provide the partner with:

API Token (e.g. 35uQ1SJ23YdvnBF_pLGUrt )
Menu feed key (e.g. 6854d0e3-bd04-47ae-9cbc-dbf21060fd38 )

Retrieving the Menu Feed

The menu feed is a single GET request that returns the full product catalog as JSON:

# Staging
curl -X GET "https://staging-app.posabit.com/api/v3/menu_feeds/{feed_key}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

# Production
curl -X GET "https://app.posabit.com/api/v3/menu_feeds/{feed_key}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Sandbox: You can test with the staging environment using feed key 9e9cbb53-348e-407c-a5cc-fca9a3e6c336 and API token 6gnUJZXgtQdXDZn97JkPyQ

Menu Feed Structure

The JSON response follows a hierarchical structure:

menu_feed

title , feed_key , description , feed_type
menu_groups[] — array of categories
- name , category_guid , description , image
- menu_items[] — array of products
  - id , name , brand , strain , flower_type , product_type
  - product_image , brand_logo — image URLs (og, lg, md, sm, thumb)
  - thc , cbd — potency with low/high/unit_type
  - prices[] — product variations
    - id (use for orders), name , price_cents , unit , unit_type , quantity_on_hand

Sending Orders

Partners can push orders into the POS using the incoming orders endpoint. Use the product

id from the menu feed prices array.

curl -X POST "https://app.posabit.com/api/v3/incoming_orders" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "incoming_order": {
    "order_type": "delivery",
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@example.com",
    "telephone": "2065551234",
    "address": "123 Main St",
    "city": "Seattle",
    "state_abbrev": "WA",
    "zipcode": "98033",
    "reference_no": "ORD-12345",
    "source": "partner_name",
    "order_items_attributes": [
      {
        "product_id": 900835,
        "product_name": "Product Name (3.5g)",
        "price": 4000,
        "quantity": 2
      }
    ]
  }
}'

Guides

Venue API

Vendor API