Sample code for 30+ languages & platforms
Lua

Square API - Retrieve Catalog Object

See more Square Examples

Returns a single CatalogItem as a CatalogObject based on the provided ID.

Chilkat Lua Downloads

Lua
local chilkat = require("chilkat")

-- This example assumes the Chilkat API to have been previously unlocked.
-- See Global Unlock Sample for sample code.

local http = chilkat.Http.new()

-- Implements the following CURL command:

-- curl https://connect.squareup.com/v2/catalog/object/W62UWFY35CWMYGVWK6TWJDNI?include_related_objects=true \
--   -H 'Square-Version: 2020-07-22' \
--   -H 'Authorization: Bearer ACCESS_TOKEN' \
--   -H 'Content-Type: application/json'

-- Use the following online tool to generate HTTP code from a CURL command
-- Convert a cURL Command to HTTP Source Code

-- Adds the "Authorization: Bearer ACCESS_TOKEN" header.
http.auth_token = "ACCESS_TOKEN"
http:set_request_header("Square-Version", "2020-07-22")
http:set_request_header("Content-Type", "application/json")

http:set_url_var("id", "2PTZYUOFGGDMT75UZLHQAPAC")

-- This example uses the sandbox: connect.squareupsandbox.com
-- Production should use connect.squareup.com
local sbResponseBody = chilkat.StringBuilder.new()
local success = http:quick_get_sb("https://connect.squareupsandbox.com/v2/catalog/object/{$id}?include_related_objects=true", sbResponseBody)
if not success then
    print(http.last_error_text)
    return
end

local jResp = chilkat.JsonObject.new()
jResp:load_sb(sbResponseBody)
jResp.emit_compact = false

print("Response Body:")
print(jResp:emit())

local respStatusCode = http.last_status
print("Response Status Code = " .. respStatusCode)
if respStatusCode >= 400 then
    print("Response Header:")
    print(http.last_header)
    print("Failed.")
    return
end

-- Sample JSON response:
-- (Sample code for parsing the JSON response is shown below)

-- {
--   "object": {
--     "type": "ITEM",
--     "id": "W62UWFY35CWMYGVWK6TWJDNI",
--     "updated_at": "2016-11-16T22:25:24.878Z",
--     "version": 1479335124878,
--     "is_deleted": false,
--     "present_at_all_locations": true,
--     "item_data": {
--       "name": "Tea",
--       "description": "Hot Leaf Juice",
--       "category_id": "BJNQCF2FJ6S6UIDT65ABHLRX",
--       "tax_ids": [
--         "HURXQOOAIC4IZSI2BEXQRYFY"
--       ],
--       "variations": [
--         {
--           "type": "ITEM_VARIATION",
--           "id": "2TZFAOHWGG7PAK2QEXWYPZSP",
--           "updated_at": "2016-11-16T22:25:24.878Z",
--           "version": 1479335124878,
--           "is_deleted": false,
--           "present_at_all_locations": true,
--           "item_variation_data": {
--             "item_id": "W62UWFY35CWMYGVWK6TWJDNI",
--             "name": "Mug",
--             "ordinal": 0,
--             "pricing_type": "FIXED_PRICING",
--             "price_money": {
--               "amount": 150,
--               "currency": "USD"
--             }
--           }
--         }
--       ]
--     }
--   },
--   "related_objects": [
--     {
--       "type": "CATEGORY",
--       "id": "BJNQCF2FJ6S6UIDT65ABHLRX",
--       "updated_at": "2016-11-16T22:25:24.878Z",
--       "version": 1479335124878,
--       "is_deleted": false,
--       "present_at_all_locations": true,
--       "category_data": {
--         "name": "Beverages"
--       }
--     },
--     {
--       "type": "TAX",
--       "id": "HURXQOOAIC4IZSI2BEXQRYFY",
--       "updated_at": "2016-11-16T22:25:24.878Z",
--       "version": 1479335124878,
--       "is_deleted": false,
--       "present_at_all_locations": true,
--       "tax_data": {
--         "name": "Sales Tax",
--         "calculation_phase": "TAX_SUBTOTAL_PHASE",
--         "inclusion_type": "ADDITIVE",
--         "percentage": "5.0",
--         "enabled": true
--       }
--     }
--   ]
-- }

-- Sample code for parsing the JSON response...
-- Use the following online tool to generate parsing code from sample JSON:
-- Generate Parsing Code from JSON

local strVal = ""
local v_type = ""
local id = ""
local updated_at = ""
local version = 0
local is_deleted = false
local present_at_all_locations = false
local item_variation_dataItem_id = ""
local item_variation_dataName = ""
local item_variation_dataOrdinal = 0
local item_variation_dataPricing_type = ""
local item_variation_dataPrice_moneyAmount = 0
local item_variation_dataPrice_moneyCurrency = ""
local category_dataName = ""
local tax_dataName = ""
local tax_dataCalculation_phase = ""
local tax_dataInclusion_type = ""
local tax_dataPercentage = ""
local tax_dataEnabled = false

local objectType = jResp:string_of("object.type")
local objectId = jResp:string_of("object.id")
local objectUpdated_at = jResp:string_of("object.updated_at")
local objectVersion = jResp:int_of("object.version")
local objectIs_deleted = jResp:bool_of("object.is_deleted")
local objectPresent_at_all_locations = jResp:bool_of("object.present_at_all_locations")
local objectItem_dataName = jResp:string_of("object.item_data.name")
local objectItem_dataDescription = jResp:string_of("object.item_data.description")
local objectItem_dataCategory_id = jResp:string_of("object.item_data.category_id")
local i = 0
local count_i = jResp:size_of_array("object.item_data.tax_ids")
while i < count_i do
    jResp.i = i
    strVal = jResp:string_of("object.item_data.tax_ids[i]")
    i = i + 1
end

i = 0
count_i = jResp:size_of_array("object.item_data.variations")
while i < count_i do
    jResp.i = i
    v_type = jResp:string_of("object.item_data.variations[i].type")
    id = jResp:string_of("object.item_data.variations[i].id")
    updated_at = jResp:string_of("object.item_data.variations[i].updated_at")
    version = jResp:int_of("object.item_data.variations[i].version")
    is_deleted = jResp:bool_of("object.item_data.variations[i].is_deleted")
    present_at_all_locations = jResp:bool_of("object.item_data.variations[i].present_at_all_locations")
    item_variation_dataItem_id = jResp:string_of("object.item_data.variations[i].item_variation_data.item_id")
    item_variation_dataName = jResp:string_of("object.item_data.variations[i].item_variation_data.name")
    item_variation_dataOrdinal = jResp:int_of("object.item_data.variations[i].item_variation_data.ordinal")
    item_variation_dataPricing_type = jResp:string_of("object.item_data.variations[i].item_variation_data.pricing_type")
    item_variation_dataPrice_moneyAmount = jResp:int_of("object.item_data.variations[i].item_variation_data.price_money.amount")
    item_variation_dataPrice_moneyCurrency = jResp:string_of("object.item_data.variations[i].item_variation_data.price_money.currency")
    i = i + 1
end

i = 0
count_i = jResp:size_of_array("related_objects")
while i < count_i do
    jResp.i = i
    v_type = jResp:string_of("related_objects[i].type")
    id = jResp:string_of("related_objects[i].id")
    updated_at = jResp:string_of("related_objects[i].updated_at")
    version = jResp:int_of("related_objects[i].version")
    is_deleted = jResp:bool_of("related_objects[i].is_deleted")
    present_at_all_locations = jResp:bool_of("related_objects[i].present_at_all_locations")
    category_dataName = jResp:string_of("related_objects[i].category_data.name")
    tax_dataName = jResp:string_of("related_objects[i].tax_data.name")
    tax_dataCalculation_phase = jResp:string_of("related_objects[i].tax_data.calculation_phase")
    tax_dataInclusion_type = jResp:string_of("related_objects[i].tax_data.inclusion_type")
    tax_dataPercentage = jResp:string_of("related_objects[i].tax_data.percentage")
    tax_dataEnabled = jResp:bool_of("related_objects[i].tax_data.enabled")
    i = i + 1
end