Venue API V1

This is a legacy API. V3 is the actively maintained version. New integrations should use Venue API V3 instead.

Authentication

Resources

Coupons 1 endpoints
Customers 1 endpoints
Employees 1 endpoints
Incoming Orders 2 endpoints
Incoming Quotes 4 endpoints
Info 1 endpoints
Inventories 1 endpoints
Manifest Items 1 endpoints
Menu Feeds 2 endpoints
Sales Histories 1 endpoints

Coupons

1 endpoints

Endpoints

GET /api/{token}/v1/coupons

GET /api/{token}/v1/coupons

Venue Coupons

Example

curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/coupons" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/coupons")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/YOUR_API_TOKEN/v1/coupons", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/coupons", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/coupons");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
400	Bad Request
422	Invalid parameters
500	Internal Server Error

Response Example

{
  "code": 1,
  "total_records": 111,
  "current_page": 1,
  "total_pages": 4,
  "per_page": 30,
  "coupons": [
    {
      "id": 47370,
      "name": "B - Student 5% Off",
      "display_name": "B - Student 5% Off",
      "kind": "discount",
      "amount": 500,
      "coupon_type": "percent",
      "applies_to": "order",
      "auto_apply": false,
      "customer_type": ""
    }
  ]
}

Customers

1 endpoints

POSaBIT offers custom profiles for each of your loyalty customers. With just the scan of the customer's ID, the point of sale pulls up the customer’s favorite types of products, displays their purchase history, shows their available loyalty points/rewards, and even has an area where you can easily make notes about the customer.

Endpoints

GET /api/v1/venue/customers

GET /api/v1/venue/customers

Get all customers for a venue

Parameters

Name	Type	In	Required	Description
`page`	integer	query	No	Page Number
`per_page`	integer	query	No	Results per page (default 1000)
`q[updated_at_gt]`	datestring	query	No	Filter results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01)

Example

curl -X GET "https://app.posabit.com/api/v1/venue/customers" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/v1/venue/customers")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/v1/venue/customers", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/v1/venue/customers", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/v1/venue/customers");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
401	Unauthorized

Response Example

{
  "total_records": 475,
  "current_page": 1,
  "total_pages": 475,
  "per_page": 1,
  "customers": [
    {
      "customerId": 279159,
      "firstName": "JANE",
      "created_at": "2019-10-21T20:21:19.000Z",
      "updated_at": "2021-10-05T19:31:24.000Z",
      "birthyear": 1992,
      "gender": "female",
      "phone": "5551111111"
    }
  ]
}

Employees

1 endpoints

Employee management through the POSaBIT web portal allows you to easily create and manage all employees. This includes creating or changing their employee PIN number or adjusting their access level. Using the employee groups feature you can easily specify exactly how much access each employee should be given in the web portal.

Endpoints

GET /api/v1/venue/employees

GET /api/v1/venue/employees

Get all users for a venue

Parameters

Name	Type	In	Required	Description
`page`	integer	query	No	Page Number
`per_page`	integer	query	No	Results per page (default 1000)
`q[updated_at_gt]`	datestring	query	No	Limit results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01)

Example

curl -X GET "https://app.posabit.com/api/v1/venue/employees" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/v1/venue/employees")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/v1/venue/employees", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/v1/venue/employees", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/v1/venue/employees");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
401	Unauthorized

Response Fields

Field	Type	Required	Description
`id`	integer	Yes	Employee Id
`first_name`	string	No	First Name
`created_at`	datetime	No	Created At
`updated_at`	datetime	No	Updated At

Response Example

{
  "total_records": 1,
  "current_page": 1,
  "total_pages": 1,
  "per_page": 1,
  "employees": [
    {
      "employeeId": 12998,
      "firstName": "Jane",
      "created_at": "2022-04-21T22:41:04.000Z",
      "updated_at": "2022-04-21T22:41:04.000Z"
    }
  ]
}

Incoming Orders

2 endpoints

The Online Orders page is where you can view and manage all of your incoming online orders. This page is designed to give you a better overview of all of your incoming orders in one place. You can easily see important information such as the order source, order status, and order details. Additionally, you can filter and sort through your orders to find exactly what you're looking for.

Endpoints

POST /api/{token}/v1/incoming_orders
GET /api/{token}/v1/incoming_orders/{id}

POST /api/{token}/v1/incoming_orders

Create an incoming order

Example

curl -X POST "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "incoming_order": {
    "order_type": "pickup",
    "first_name": "John",
    "last_name": "Doe",
    "email": "test@posabit.com",
    "telephone": "5551112222",
    "address": "",
    "city": "",
    "state_abbrev": "",
    "zipcode": "",
    "reference_no": "12345-86-123",
    "notes": "Gets free lighter",
    "requested_payment_method": "cash",
    "source": "online_store",
    "order_items_attributes": [
      {
        "product_parent_id": "Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)",
        "product_id": 808542,
        "quantity": 2
      }
    ]
  }
}'

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = {"incoming_order":{"order_type":"pickup","first_name":"John","last_name":"Doe","email":"test@posabit.com","telephone":"5551112222","address":"","city":"","state_abbrev":"","zipcode":"","reference_no":"12345-86-123","notes":"Gets free lighter","requested_payment_method":"cash","source":"online_store","order_items_attributes":[{"product_parent_id":"Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)","product_id":808542,"quantity":2}]}}.to_json

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json"
}

payload = {
      "incoming_order": {
        "order_type": "pickup",
        "first_name": "John",
        "last_name": "Doe",
        "email": "test@posabit.com",
        "telephone": "5551112222",
        "address": "",
        "city": "",
        "state_abbrev": "",
        "zipcode": "",
        "reference_no": "12345-86-123",
        "notes": "Gets free lighter",
        "requested_payment_method": "cash",
        "source": "online_store",
        "order_items_attributes": [
          {
            "product_parent_id": "Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)",
            "product_id": 808542,
            "quantity": 2
          }
        ]
      }
    }

response = requests.post("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders", headers=headers, json=payload)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
    "bytes"
)

func main() {
    body := []byte(`{"incoming_order":{"order_type":"pickup","first_name":"John","last_name":"Doe","email":"test@posabit.com","telephone":"5551112222","address":"","city":"","state_abbrev":"","zipcode":"","reference_no":"12345-86-123","notes":"Gets free lighter","requested_payment_method":"cash","source":"online_store","order_items_attributes":[{"product_parent_id":"Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)","product_id":808542,"quantity":2}]}}`)
    req, _ := http.NewRequest("POST", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders", bytes.NewBuffer(body))
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var json = @"{""incoming_order"":{""order_type"":""pickup"",""first_name"":""John"",""last_name"":""Doe"",""email"":""test@posabit.com"",""telephone"":""5551112222"",""address"":"""",""city"":"""",""state_abbrev"":"""",""zipcode"":"""",""reference_no"":""12345-86-123"",""notes"":""Gets free lighter"",""requested_payment_method"":""cash"",""source"":""online_store"",""order_items_attributes"":[{""product_parent_id"":""Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)"",""product_id"":808542,""quantity"":2}]}}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders", content);

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Request Body

{
  "incoming_order": {
    "order_type": "pickup",
    "first_name": "John",
    "last_name": "Doe",
    "email": "test@posabit.com",
    "telephone": "5551112222",
    "address": "",
    "city": "",
    "state_abbrev": "",
    "zipcode": "",
    "reference_no": "12345-86-123",
    "notes": "Gets free lighter",
    "requested_payment_method": "cash",
    "source": "online_store",
    "order_items_attributes": [
      {
        "product_parent_id": "Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)",
        "product_id": 808542,
        "quantity": 2
      }
    ]
  }
}

Responses

Status	Description
400	Bad Request
422	Invalid parameters
500	Internal Server Error

Response Example

{
  "code": 1,
  "incoming_order": {
    "id": 19800,
    "aasm_state": "pending",
    "reference_no": "12345-86-123",
    "first_name": "John",
    "last_name": "Doe",
    "source": "online_store",
    "order_type": "pickup",
    "notes": "Gets free lighter",
    "delivered_at": null,
    "requested_date": null,
    "requested_window_start_time": {},
    "requested_window_end_time": {},
    "requested_payment_method": "cash",
    "payment_verified": false,
    "curbside": false,
    "created_at": "2024-10-03T19:12:19.000Z",
    "updated_at": "2024-10-03T19:12:19.000Z"
  },
  "order_items": [
    {
      "item_id": 32744,
      "product_id": 808542,
      "sku_id": 115866,
      "manifest_item_id": null,
      "product_name": "Treehawk Farms - Wifi OG Pre-Roll 2pk (1g)",
      "product_brand": "Treehawk Farms",
      "product_strain": "Wifi OG",
      "weight": null,
      "quantity": 2,
      "unit_quantity": "2.0",
      "price": 1000,
      "discount": null,
      "tax": null,
      "tier_weight_id": null,
      "coupons": [],
      "taxes": [],
      "created_at": "2024-10-03T19:12:19.000Z",
      "updated_at": "2024-10-03T19:12:19.000Z"
    }
  ]
}

GET /api/{token}/v1/incoming_orders/{id}

Find an incoming order

Parameters

Name	Type	In	Required	Description
`id`	integer	path	Yes

Example

curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders/{id}" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders/{id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders/{id}", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders/{id}", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_orders/{id}");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
404	Requested reference number or id not found
422	Invalid parameters
500	Internal Server Error

Response Example

{
  "code": 1,
  "incoming_order": {
    "id": 19798,
    "aasm_state": "processing",
    "reference_no": "3221-1727814981-bb1314bf",
    "first_name": "A",
    "last_name": "A",
    "source": "posabit_v2",
    "order_type": "pickup",
    "notes": null,
    "delivered_at": null,
    "requested_date": null,
    "requested_window_start_time": {},
    "requested_window_end_time": {},
    "requested_payment_method": "cash",
    "payment_verified": false,
    "curbside": false,
    "created_at": "2024-10-01T20:39:23.000Z",
    "updated_at": "2024-10-01T20:41:19.000Z"
  },
  "order_items": [
    {
      "item_id": 32713,
      "product_id": 800583,
      "sku_id": 107907,
      "manifest_item_id": null,
      "product_name": "'oh' McDonald Farms - Nuken (1g)",
      "product_brand": "'oh' McDonald Farms",
      "product_strain": "Nuken",
      "weight": "1.1g",
      "quantity": 1,
      "unit_quantity": "1.1",
      "price": 1500,
      "discount": 0,
      "tax": 473,
      "tier_weight_id": null,
      "coupons": [],
      "taxes": [],
      "created_at": "2024-10-01T20:36:21.000Z",
      "updated_at": "2024-10-01T20:36:21.000Z"
    }
  ]
}

Incoming Quotes

4 endpoints

Endpoints

POST /api/{token}/v1/incoming_quotes
GET /api/{token}/v1/incoming_quotes/{id}
PATCH /api/{token}/v1/incoming_quotes/{id}
PUT /api/{token}/v1/incoming_quotes/{id}/finalize

POST /api/{token}/v1/incoming_quotes

Create an incoming quote

Example

curl -X POST "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "quote": {
    "incoming_order_id": null,
    "venue_id": 3221,
    "fulfillment": {
      "source": "posabit_v2",
      "order_type": "pickup",
      "requested_date": null,
      "requested_window_start_time": null,
      "requested_window_end_time": null,
      "tip_amount": 0,
      "tip_type": null,
      "processing_fee": 300,
      "tip_calculated": 0,
      "delivery_address": {
        "address": "",
        "city": "",
        "state_abbrev": "",
        "zipcode": ""
      }
    },
    "customer": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "test@posabit.com",
      "telephone": "5551112222",
      "customer_type": "recreational"
    },
    "payment": {
      "requested_payment_method": "cash"
    },
    "items": [
      {
        "sku_id": 107907,
        "quantity": 1,
        "product_id": 800583,
        "name": "'oh' McDonald Farms - Nuken (1g)",
        "unit_type": "g",
        "unit": "1.1",
        "variant_id": "k107907",
        "quantity_on_hand": 30,
        "test_results": {
          "thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "cbd": {
            "current": 10,
            "low": 10,
            "high": 10,
            "unit_type": "%"
          },
          "thca": null,
          "cbda": null,
          "total_thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "total_cbd": null,
          "thcv": null,
          "cbdv": null,
          "cbc": null,
          "cbca": null,
          "cbcv": null,
          "cbn": null,
          "cbg": null,
          "cbga": null,
          "cbgv": null
        },
        "terpene_results": [],
        "product_image": {
          "is_product_specific_image": true,
          "lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
          "md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
        },
        "discount": 0,
        "price": 1500,
        "discount_ids": []
      }
    ]
  }
}'

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request["Accept"] = "application/json"
request["Content-Type"] = "application/json"
request.body = {"quote":{"incoming_order_id":null,"venue_id":3221,"fulfillment":{"source":"posabit_v2","order_type":"pickup","requested_date":null,"requested_window_start_time":null,"requested_window_end_time":null,"tip_amount":0,"tip_type":null,"processing_fee":300,"tip_calculated":0,"delivery_address":{"address":"","city":"","state_abbrev":"","zipcode":""}},"customer":{"first_name":"Jane","last_name":"Doe","email":"test@posabit.com","telephone":"5551112222","customer_type":"recreational"},"payment":{"requested_payment_method":"cash"},"items":[{"sku_id":107907,"quantity":1,"product_id":800583,"name":"'oh' McDonald Farms - Nuken (1g)","unit_type":"g","unit":"1.1","variant_id":"k107907","quantity_on_hand":30,"test_results":{"thc":{"current":4.2,"low":4.2,"high":4.2,"unit_type":"%"},"cbd":{"current":10,"low":10,"high":10,"unit_type":"%"},"thca":null,"cbda":null,"total_thc":{"current":4.2,"low":4.2,"high":4.2,"unit_type":"%"},"total_cbd":null,"thcv":null,"cbdv":null,"cbc":null,"cbca":null,"cbcv":null,"cbn":null,"cbg":null,"cbga":null,"cbgv":null},"terpene_results":[],"product_image":{"is_product_specific_image":true,"lg":"https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg","md":"https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"},"discount":0,"price":1500,"discount_ids":[]}]}}.to_json

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json"
}

payload = {
      "quote": {
        "incoming_order_id": null,
        "venue_id": 3221,
        "fulfillment": {
          "source": "posabit_v2",
          "order_type": "pickup",
          "requested_date": null,
          "requested_window_start_time": null,
          "requested_window_end_time": null,
          "tip_amount": 0,
          "tip_type": null,
          "processing_fee": 300,
          "tip_calculated": 0,
          "delivery_address": {
            "address": "",
            "city": "",
            "state_abbrev": "",
            "zipcode": ""
          }
        },
        "customer": {
          "first_name": "Jane",
          "last_name": "Doe",
          "email": "test@posabit.com",
          "telephone": "5551112222",
          "customer_type": "recreational"
        },
        "payment": {
          "requested_payment_method": "cash"
        },
        "items": [
          {
            "sku_id": 107907,
            "quantity": 1,
            "product_id": 800583,
            "name": "'oh' McDonald Farms - Nuken (1g)",
            "unit_type": "g",
            "unit": "1.1",
            "variant_id": "k107907",
            "quantity_on_hand": 30,
            "test_results": {
              "thc": {
                "current": 4.2,
                "low": 4.2,
                "high": 4.2,
                "unit_type": "%"
              },
              "cbd": {
                "current": 10,
                "low": 10,
                "high": 10,
                "unit_type": "%"
              },
              "thca": null,
              "cbda": null,
              "total_thc": {
                "current": 4.2,
                "low": 4.2,
                "high": 4.2,
                "unit_type": "%"
              },
              "total_cbd": null,
              "thcv": null,
              "cbdv": null,
              "cbc": null,
              "cbca": null,
              "cbcv": null,
              "cbn": null,
              "cbg": null,
              "cbga": null,
              "cbgv": null
            },
            "terpene_results": [],
            "product_image": {
              "is_product_specific_image": true,
              "lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
              "md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
            },
            "discount": 0,
            "price": 1500,
            "discount_ids": []
          }
        ]
      }
    }

response = requests.post("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes", headers=headers, json=payload)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
    "bytes"
)

func main() {
    body := []byte(`{"quote":{"incoming_order_id":null,"venue_id":3221,"fulfillment":{"source":"posabit_v2","order_type":"pickup","requested_date":null,"requested_window_start_time":null,"requested_window_end_time":null,"tip_amount":0,"tip_type":null,"processing_fee":300,"tip_calculated":0,"delivery_address":{"address":"","city":"","state_abbrev":"","zipcode":""}},"customer":{"first_name":"Jane","last_name":"Doe","email":"test@posabit.com","telephone":"5551112222","customer_type":"recreational"},"payment":{"requested_payment_method":"cash"},"items":[{"sku_id":107907,"quantity":1,"product_id":800583,"name":"'oh' McDonald Farms - Nuken (1g)","unit_type":"g","unit":"1.1","variant_id":"k107907","quantity_on_hand":30,"test_results":{"thc":{"current":4.2,"low":4.2,"high":4.2,"unit_type":"%"},"cbd":{"current":10,"low":10,"high":10,"unit_type":"%"},"thca":null,"cbda":null,"total_thc":{"current":4.2,"low":4.2,"high":4.2,"unit_type":"%"},"total_cbd":null,"thcv":null,"cbdv":null,"cbc":null,"cbca":null,"cbcv":null,"cbn":null,"cbg":null,"cbga":null,"cbgv":null},"terpene_results":[],"product_image":{"is_product_specific_image":true,"lg":"https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg","md":"https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"},"discount":0,"price":1500,"discount_ids":[]}]}}`)
    req, _ := http.NewRequest("POST", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes", bytes.NewBuffer(body))
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var json = @"{""quote"":{""incoming_order_id"":null,""venue_id"":3221,""fulfillment"":{""source"":""posabit_v2"",""order_type"":""pickup"",""requested_date"":null,""requested_window_start_time"":null,""requested_window_end_time"":null,""tip_amount"":0,""tip_type"":null,""processing_fee"":300,""tip_calculated"":0,""delivery_address"":{""address"":"""",""city"":"""",""state_abbrev"":"""",""zipcode"":""""}},""customer"":{""first_name"":""Jane"",""last_name"":""Doe"",""email"":""test@posabit.com"",""telephone"":""5551112222"",""customer_type"":""recreational""},""payment"":{""requested_payment_method"":""cash""},""items"":[{""sku_id"":107907,""quantity"":1,""product_id"":800583,""name"":""'oh' McDonald Farms - Nuken (1g)"",""unit_type"":""g"",""unit"":""1.1"",""variant_id"":""k107907"",""quantity_on_hand"":30,""test_results"":{""thc"":{""current"":4.2,""low"":4.2,""high"":4.2,""unit_type"":""%""},""cbd"":{""current"":10,""low"":10,""high"":10,""unit_type"":""%""},""thca"":null,""cbda"":null,""total_thc"":{""current"":4.2,""low"":4.2,""high"":4.2,""unit_type"":""%""},""total_cbd"":null,""thcv"":null,""cbdv"":null,""cbc"":null,""cbca"":null,""cbcv"":null,""cbn"":null,""cbg"":null,""cbga"":null,""cbgv"":null},""terpene_results"":[],""product_image"":{""is_product_specific_image"":true,""lg"":""https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg"",""md"":""https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg""},""discount"":0,""price"":1500,""discount_ids"":[]}]}}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes", content);

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Request Body

{
  "quote": {
    "incoming_order_id": null,
    "venue_id": 3221,
    "fulfillment": {
      "source": "posabit_v2",
      "order_type": "pickup",
      "requested_date": null,
      "requested_window_start_time": null,
      "requested_window_end_time": null,
      "tip_amount": 0,
      "tip_type": null,
      "processing_fee": 300,
      "tip_calculated": 0,
      "delivery_address": {
        "address": "",
        "city": "",
        "state_abbrev": "",
        "zipcode": ""
      }
    },
    "customer": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "test@posabit.com",
      "telephone": "5551112222",
      "customer_type": "recreational"
    },
    "payment": {
      "requested_payment_method": "cash"
    },
    "items": [
      {
        "sku_id": 107907,
        "quantity": 1,
        "product_id": 800583,
        "name": "'oh' McDonald Farms - Nuken (1g)",
        "unit_type": "g",
        "unit": "1.1",
        "variant_id": "k107907",
        "quantity_on_hand": 30,
        "test_results": {
          "thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "cbd": {
            "current": 10,
            "low": 10,
            "high": 10,
            "unit_type": "%"
          },
          "thca": null,
          "cbda": null,
          "total_thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "total_cbd": null,
          "thcv": null,
          "cbdv": null,
          "cbc": null,
          "cbca": null,
          "cbcv": null,
          "cbn": null,
          "cbg": null,
          "cbga": null,
          "cbgv": null
        },
        "terpene_results": [],
        "product_image": {
          "is_product_specific_image": true,
          "lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
          "md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
        },
        "discount": 0,
        "price": 1500,
        "discount_ids": []
      }
    ]
  }
}

Responses

Status	Description
400	Bad Request
422	Invalid parameters
500	Internal Server Error

Response Example

{
  "code": 1,
  "quote": {
    "reference_no": "3221-1727982977-3f59c5f1",
    "incoming_order_id": null,
    "venue_id": 3221,
    "fulfillment": {
      "source": "posabit_v2",
      "order_type": "pickup",
      "requested_date": null,
      "requested_window_start_time": null,
      "requested_window_end_time": null,
      "tip_amount": 0,
      "tip_type": null,
      "processing_fee": 300,
      "tip_calculated": 0,
      "delivery_address": {
        "address": "",
        "city": "",
        "state_abbrev": "",
        "zipcode": ""
      }
    },
    "customer": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "test@posabit.com",
      "telephone": "5551112222",
      "customer_type": "recreational"
    },
    "payment": {
      "requested_payment_method": "cash"
    },
    "items": [
      {
        "sku_id": 107907,
        "quantity": 1,
        "product_id": 800583,
        "name": "'oh' McDonald Farms - Nuken (1g)",
        "unit_type": "g",
        "unit": "1.1",
        "variant_id": "k107907",
        "quantity_on_hand": 30,
        "test_results": {
          "thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "cbd": {
            "current": 10,
            "low": 10,
            "high": 10,
            "unit_type": "%"
          },
          "thca": null,
          "cbda": null,
          "total_thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "total_cbd": null,
          "thcv": null,
          "cbdv": null,
          "cbc": null,
          "cbca": null,
          "cbcv": null,
          "cbn": null,
          "cbg": null,
          "cbga": null,
          "cbgv": null
        },
        "terpene_results": [],
        "product_image": {
          "is_product_specific_image": true,
          "lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
          "md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
        },
        "discount": 0,
        "price": 1500,
        "discount_ids": []
      }
    ],
    "taxes": [
      {
        "tax_id": 4286,
        "name": "Bellingham, WA",
        "price_included": true,
        "amount": 93,
        "tax_rate": "9.0"
      },
      {
        "tax_id": 4285,
        "name": "Cannabis Tax",
        "price_included": true,
        "amount": 380,
        "tax_rate": "37.0"
      }
    ],
    "totals": {
      "discount_ids": [],
      "subtotal": 1500,
      "discount": 0,
      "tax": 473,
      "total": 1500
    },
    "limits": {
      "exceeded_limits": [],
      "sum_per_limit": {
        "recreational_flower": 1.1
      }
    }
  }
}

GET /api/{token}/v1/incoming_quotes/{id}

Find an incoming quote

Parameters

Name	Type	In	Required	Description
`id`	integer	path	Yes

Example

curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
404	Requested reference number or id not found
422	Invalid parameters
500	Internal Server Error

Response Example

{
  "code": 1,
  "quote": {
    "reference_no": "3221-1727814981-bb1314bf",
    "incoming_order_id": null,
    "venue_id": 3221,
    "fulfillment": {
      "source": "posabit_v2",
      "order_type": "pickup",
      "requested_date": null,
      "requested_window_start_time": null,
      "requested_window_end_time": null,
      "tip_amount": 0,
      "tip_type": null,
      "processing_fee": 300,
      "tip_calculated": 0,
      "delivery_address": {
        "address": "",
        "city": "",
        "state_abbrev": "",
        "zipcode": ""
      }
    },
    "customer": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "test@posabit.com",
      "telephone": "5551111111",
      "customer_type": "recreational"
    },
    "payment": {
      "requested_payment_method": "cash"
    },
    "items": [
      {
        "sku_id": 107907,
        "quantity": 1,
        "product_id": 800583,
        "name": "'oh' McDonald Farms - Nuken (1g)",
        "unit_type": "g",
        "unit": "1.1",
        "variant_id": "k107907",
        "quantity_on_hand": 30,
        "test_results": {
          "thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "cbd": {
            "current": 10,
            "low": 10,
            "high": 10,
            "unit_type": "%"
          },
          "thca": null,
          "cbda": null,
          "total_thc": {
            "current": 4.2,
            "low": 4.2,
            "high": 4.2,
            "unit_type": "%"
          },
          "total_cbd": null,
          "thcv": null,
          "cbdv": null,
          "cbc": null,
          "cbca": null,
          "cbcv": null,
          "cbn": null,
          "cbg": null,
          "cbga": null,
          "cbgv": null
        },
        "terpene_results": [],
        "product_image": {
          "is_product_specific_image": true,
          "lg": "https://pbit-staging.s3.amazonaws.com/images/image/210/large_image.jpg",
          "md": "https://pbit-staging.s3.amazonaws.com/images/image/210/medium_image.jpg"
        },
        "discount": 0,
        "price": 1500,
        "discount_ids": []
      }
    ],
    "taxes": [],
    "totals": {
      "discount_ids": [],
      "subtotal": 1500,
      "discount": 0,
      "tax": 473,
      "total": 1500
    },
    "limits": {
      "exceeded_limits": [],
      "sum_per_limit": {
        "recreational_flower": 1.1
      }
    }
  }
}

PATCH /api/{token}/v1/incoming_quotes/{id}

["Update an incoming quote", "Update an incoming quote items"]

Parameters

Name	Type	In	Required	Description
`id`	integer	path	Yes
`id`	integer	path	Yes

Example

curl -X PATCH "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{...}'

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.patch("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("PATCH", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}", nil)
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var json = @"{...}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PatchAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}", content);

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
204	Record not found
400	Bad Request
200	Success
204	Record not found
400	Bad Request

PUT /api/{token}/v1/incoming_quotes/{id}/finalize

Finalize an incoming quote. Submits an Order.

Parameters

Name	Type	In	Required	Description
`id`	integer	path	Yes

Example

curl -X PUT "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}/finalize" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{...}'

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}/finalize")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Put.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.put("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}/finalize", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("PUT", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}/finalize", nil)
    req.Header.Set("Accept", "application/json")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var json = @"{...}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PutAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/incoming_quotes/{id}/finalize", content);

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
204	Record not found
400	Bad Request

Info

1 endpoints

Endpoints

GET /api/{token}/v1/info

GET /api/{token}/v1/info

Venue Info

Example

curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/info" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/info")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/YOUR_API_TOKEN/v1/info", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/info", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/info");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
400	Bad Request
422	Invalid parameters
500	Internal Server Error

Response Example

{
  "code": 1,
  "name": "The Bong Marché",
  "license": "C11-0001157-LIC",
  "region": "Washington State",
  "locale": "en-US",
  "vertical": "dispensaries",
  "logo_thumb": "https://pbit-qa.s3.amazonaws.com/logos/Venue/thumb_3221_logo.png",
  "logo_medium": "https://pbit-qa.s3.amazonaws.com/logos/Venue/medium_3221_logo.png",
  "telephone": "5556543211",
  "address": "1128 8th St, Kirkland, WA",
  "street_address_line_1": "1128 8th St",
  "city": "Kirkland",
  "state": "WA",
  "zip_code": "98000",
  "country": "USA",
  "timezone": "Pacific Time (US & Canada)",
  "latitude": "48.7382",
  "longitude": "-122.47",
  "domains": [],
  "tax_rates": [
    {
      "id": 4285,
      "name": "Cannabis Tax",
      "rate": 1000,
      "tax_rate": "10.0",
      "price_included": true
    },
    {
      "id": 4286,
      "name": "Bellingham, WA",
      "rate": 837,
      "tax_rate": "8.375",
      "price_included": true
    },
    {
      "id": 4415,
      "name": "Excise tax",
      "rate": 1500,
      "tax_rate": "15.0",
      "price_included": true
    }
  ],
  "payment_methods": [
    "Cash",
    "POSaBIT Pay",
    "Debit Card",
    "Other"
  ],
  "venue_settings": {
    "online_order_curbside": "1",
    "online_order_delivery": "0"
  }
}

Inventories

1 endpoints

The default view of the inventory page will show you all of your active inventory, from lowest to highest number of units (or grams) on hand - this is so you can easily see which products are running low. Using the filters on the left side of the page, you can narrow down your search results by a particular product type, brand, supplier, etc.

Endpoints

GET /api/v1/venue/inventories

GET /api/v1/venue/inventories

Get all inventories for a venue

Parameters

Name	Type	In	Required	Description
`page`	integer	query	No	Page Number
`per_page`	integer	query	No	Results per page (default 100, max 100)
`q[updated_at_gt]`	datestring	query	No	Limit results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01)

Example

curl -X GET "https://app.posabit.com/api/v1/venue/inventories" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/v1/venue/inventories")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/v1/venue/inventories", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/v1/venue/inventories", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/v1/venue/inventories");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
401	Unauthorized

Response Example

{
  "total_records": 1182,
  "current_page": 1,
  "total_pages": 1182,
  "per_page": 1,
  "products": [
    {
      "productId": 210111,
      "internal_product_identifier": "800566",
      "name": "High Five Farms - Ghost Train Haze",
      "display_name": "Ghost Train Haze",
      "unit": "280.0 gm",
      "price": 1300,
      "quantityInStock": "0.0",
      "vendor": "High Five Farms",
      "vendor_license": null,
      "brand": "High Five Farms",
      "category": "Bulk Flower",
      "flowertype": "hybrid",
      "concentratetype": null,
      "producttype": "hybrid",
      "productfamily": "Flower",
      "tags": [
        "Test Tag",
        "Sale Day"
      ],
      "description": "Conducive to concentration and creativity, this sati...",
      "image": [
        null
      ],
      "active": false,
      "bulkitem": true,
      "strain": "Ghost Train Haze",
      "thcMeasure": "0.0%",
      "cbdMeasure": "0.0%",
      "sku": "3264-902427",
      "discountable": true,
      "tier_name": "Top Tier",
      "doh_compliant": false,
      "effects": [
        "Relaxed",
        "Creative"
      ],
      "flavors": [
        "Flowery"
      ],
      "rooms": [],
      "created_at": "2019-10-16T20:37:49.000Z",
      "updated_at": "2022-06-14T19:37:38.000Z"
    }
  ]
}

Manifest Items

1 endpoints

Endpoints

GET /api/v1/venue/manifest_items

GET /api/v1/venue/manifest_items

Get all manifest items for a venue

Parameters

Name	Type	In	Required	Description
`page`	integer	query	No	Page Number
`per_page`	integer	query	No	Results per page (default 100, max 100)
`q[updated_at_gt]`	datestring	query	No	Limit results using ransack syntax (e.g. q[updated_at_gt]='2019-07-01' would return employees updated since 2019-07-01)

Example

curl -X GET "https://app.posabit.com/api/v1/venue/manifest_items" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/v1/venue/manifest_items")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/v1/venue/manifest_items", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/v1/venue/manifest_items", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/v1/venue/manifest_items");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
401	Unauthorized

Response Example

{
  "total_records": 1325,
  "current_page": 1,
  "total_pages": 1325,
  "per_page": 1,
  "restocks": [
    {
      "restockId": 261876,
      "parent_id": null,
      "utcDate": "2019-10-16T20:37:49.000Z",
      "quantity": "396.0",
      "quantityInStock": "-1755.422",
      "costPerUnit": 275,
      "productId": 210111,
      "inventoryId": "WAR414871.IN5SAJM",
      "thcMeasure": "19.2%",
      "cbdMeasure": "0.0%",
      "created_at": "2019-10-16T20:37:49.000Z",
      "updated_at": "2022-06-14T19:37:31.000Z"
    }
  ]
}

Menu Feeds

2 endpoints

Endpoints

GET /api/{token}/v1/menu_feeds/{id}
GET /api/{token}/v1/menu_feeds/{menu_feed_id}/options

GET /api/{token}/v1/menu_feeds/{id}

Show a Menu Feed

Parameters

Name	Type	In	Required	Description
`id`	integer	path	Yes	Feed Key

Example

curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{id}" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{id}", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{id}", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{id}");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
400	Bad Request
422	Invalid parameters
500	Internal Server Error

GET /api/{token}/v1/menu_feeds/{menu_feed_id}/options

Check that a feed key is valid and authorized

Returns an empty object. This is a reachability and authorization check: 200 when the feed key resolves for the authenticated venue, 404 when it does not. It previously returned menu widget display settings (theme, fonts, colors, allow_orders and so on). Those columns were removed in 2019 and the values now reach the widget through the embed snippet the venue pastes into their site, not through this endpoint, so the body has been emptied rather than left raising. Despite the name this is a GET, and it has no role in CORS -- browser preflight is answered by the CORS middleware before routing.

Parameters

Name	Type	In	Required	Description
`menu_feed_id`	integer	path	Yes	Feed Key

Example

curl -X GET "https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{menu_feed_id}/options" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{menu_feed_id}/options")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{menu_feed_id}/options", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{menu_feed_id}/options", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/YOUR_API_TOKEN/v1/menu_feeds/{menu_feed_id}/options");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
400	Bad Request
404	Could not find menu feed
422	Invalid parameters
500	Internal Server Error

Sales Histories

1 endpoints

The Sales window, is where you can see and sort through all of your previous transactions. Use the filters on the left side of the page to sort the transactions however you'd like. You can use this tab when looking for a return or if you'd like to dive into the details of a specific transaction.

Endpoints

GET /api/v1/venue/sales_histories

GET /api/v1/venue/sales_histories

Get all sales histories for a venue

When no filters are provided, results are limited to sales ordered since the start of day (venue-local) two days ago. The applied ordered_at_gt value is echoed in the response along with default_filter_applied.

Parameters

Name	Type	In	Required	Description
`page`	integer	query	No	Page Number
`per_page`	integer	query	No	Results per page (default 1000)
`q[ordered_at_gt]`	datestring	query	No	Limit results to sales ordered after this time (defaults to the start of day, venue-local, two days ago when no other filters are given)

Example

curl -X GET "https://app.posabit.com/api/v1/venue/sales_histories" \
  -H "Accept: application/json"

require 'net/http'
require 'json'

uri = URI("https://app.posabit.com/api/v1/venue/sales_histories")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Accept"] = "application/json"

response = http.request(request)
puts JSON.parse(response.body)

import requests

headers = {
    "Accept": "application/json",
}

response = requests.get("https://app.posabit.com/api/v1/venue/sales_histories", headers=headers)
print(response.json())

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://app.posabit.com/api/v1/venue/sales_histories", nil)
    req.Header.Set("Accept", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    data, _ := io.ReadAll(resp.Body)
    fmt.Println(string(data))
}

using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");

var response = await client.GetAsync("https://app.posabit.com/api/v1/venue/sales_histories");

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Responses

Status	Description
200	Success
401	Unauthorized

Response Example

{
  "total_records": 197,
  "current_page": 1,
  "total_pages": 197,
  "per_page": 1,
  "tickets": [
    {
      "ticketId": 49052949,
      "isMedical": true,
      "utcDate": "2022-01-14T23:52:34.000Z",
      "localTime": "2022-01-14T15:52:34.000-08:00",
      "ticketType": "sale",
      "customerId": 279560,
      "employeeId": 12777,
      "paymentType": "",
      "subTotal": 9498,
      "discount": 1900,
      "tax": 0,
      "total": 7857,
      "items": [
        {
          "ticketItemId": 91311967,
          "ticketId": 49052949,
          "productId": 318604,
          "inventoryId": "WAR421642.INOLNTM",
          "quantity": 1,
          "weight": "1.0",
          "cost": 800,
          "subTotal": 2500,
          "tax": 0,
          "discount": 500,
          "discountList": [
            {
              "couponId": 47831,
              "couponName": "buy more than $30 of whatever"
            }
          ],
          "total": 2000
        }
      ],
      "created_at": "2022-01-14T23:52:36.000Z",
      "updated_at": "2022-01-14T23:52:36.000Z"
    }
  ]
}

Guides

Venue API

Vendor API

Venue API V1

Authentication

Resources

Coupons

Endpoints

Example

Responses

Response Example

Customers

Endpoints

Parameters

Example

Responses

Response Example

Employees

Endpoints

Parameters

Example

Responses

Response Fields

Response Example

Incoming Orders

Endpoints

Example

Request Body

Responses

Response Example

Parameters

Example

Responses

Response Example

Incoming Quotes

Endpoints

Example

Request Body

Responses

Response Example

Parameters

Example

Responses

Response Example

Parameters

Example

Responses

Parameters

Example

Responses

Info

Endpoints

Example

Responses

Response Example

Inventories

Endpoints

Parameters

Example

Responses

Response Example

Manifest Items

Endpoints

Parameters

Example

Responses

Response Example

Menu Feeds

Endpoints

Parameters

Example

Responses

Parameters

Example

Responses

Sales Histories

Endpoints

Parameters

Example

Responses