{ "info": { "_postman_id": "5fa2b09c-1703-4c68-8741-ef07fe4a3b99", "name": "Square ApplePay Inventory API", "description": "Supercharge Square for sellers of every size. Our entire connected commerce platform from elegant hardware to a rich suite of Square APIs is yours to build with. Whether youre developing an app or composing a bespoke solution, this is the place to make it happen. \n\nContact Support:\n Name: Square Developer Platform\n Email: developers@squareup.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "lastUpdatedBy": "35240", "uid": "35240-5fa2b09c-1703-4c68-8741-ef07fe4a3b99" }, "item": [ { "name": "v2", "item": [ { "name": "inventory", "item": [ { "name": "adjustment", "item": [ { "name": "{adjustment_id}", "item": [ { "name": "Square Deprecated Retrieve Inventory Adjustment", "id": "e00abbbb-1459-4252-8ee2-f810262df112", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/adjustment/:adjustment_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "adjustment", ":adjustment_id" ], "variable": [ { "id": "22b765af-3fc8-42e3-85bb-addd1f0d4335", "key": "adjustment_id", "value": "", "description": "(Required) ID of the [InventoryAdjustment](entity:InventoryAdjustment) to retrieve." } ] }, "description": "Deprecated version of [RetrieveInventoryAdjustment](api-endpoint:Inventory-RetrieveInventoryAdjustment) after the endpoint URL\nis updated to conform to the standard convention." }, "response": [ { "id": "fff90b28-dd99-4dd9-8d52-8639a77b5c4a", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/adjustment/:adjustment_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "adjustment", ":adjustment_id" ], "variable": [ { "key": "adjustment_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"EXTERNAL_VENDOR_ERROR\",\n \"code\": \"ADDRESS_VERIFICATION_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"NONE\",\n \"to_state\": \"ORDERED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"PGK\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"APPOINTMENTS\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"to_state\": \"NONE\"\n }\n }\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-fff90b28-dd99-4dd9-8d52-8639a77b5c4a" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-e00abbbb-1459-4252-8ee2-f810262df112" } ], "id": "dc95d8e9-2ef3-4cc7-962c-e03da75ee9dd", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-dc95d8e9-2ef3-4cc7-962c-e03da75ee9dd" } ], "id": "f03ccc04-ec9e-4507-baff-1daf7c27d3b4", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-f03ccc04-ec9e-4507-baff-1daf7c27d3b4" }, { "name": "adjustments", "item": [ { "name": "{adjustment_id}", "item": [ { "name": "Square Retrieve Inventory Adjustment", "id": "541a082c-2c26-479f-a6b0-3b7d26a7f8d3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/adjustments/:adjustment_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "adjustments", ":adjustment_id" ], "variable": [ { "id": "a9610028-eb2d-4f98-826c-1862a57dfa4d", "key": "adjustment_id", "value": "", "description": "(Required) ID of the [InventoryAdjustment](entity:InventoryAdjustment) to retrieve." } ] }, "description": "Returns the [InventoryAdjustment](entity:InventoryAdjustment) object\nwith the provided `adjustment_id`." }, "response": [ { "id": "543ad5dd-b6b2-4091-a716-565c8a5ff18c", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/adjustments/:adjustment_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "adjustments", ":adjustment_id" ], "variable": [ { "key": "adjustment_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"EXTERNAL_VENDOR_ERROR\",\n \"code\": \"ADDRESS_VERIFICATION_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"NONE\",\n \"to_state\": \"ORDERED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"PGK\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"APPOINTMENTS\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"to_state\": \"NONE\"\n }\n }\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-543ad5dd-b6b2-4091-a716-565c8a5ff18c" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-541a082c-2c26-479f-a6b0-3b7d26a7f8d3" } ], "id": "40a81a67-89eb-49ee-b425-2563d9245f55", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-40a81a67-89eb-49ee-b425-2563d9245f55" } ], "id": "7409a464-8b6d-48dd-800a-56f4f3534543", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-7409a464-8b6d-48dd-800a-56f4f3534543" }, { "name": "batch-change", "item": [ { "name": "Square Deprecated Batch Change Inventory", "id": "a893f4e3-97f6-4551-90f3-831d78657c21", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"idempotency_key\": \"\",\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"DASHBOARD\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"CUSTOM\",\n \"to_state\": \"RECEIVED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"XDR\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"PAYROLL\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"WASTE\",\n \"to_state\": \"NONE\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"WASTE\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"BILLING\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_SQUARE_FOOT\",\n \"length_unit\": \"METRIC_MILLIMETER\",\n \"volume_unit\": \"GENERIC_FLUID_OUNCE\",\n \"weight_unit\": \"IMPERIAL_POUND\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_SECOND\",\n \"type\": \"TYPE_WEIGHT\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ],\n \"ignore_unchanged_counts\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/batch-change", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "batch-change" ] }, "description": "Deprecated version of [BatchChangeInventory](api-endpoint:Inventory-BatchChangeInventory) after the endpoint URL\nis updated to conform to the standard convention." }, "response": [ { "id": "ecf09df0-a53e-4d41-8039-b5cf37df45e1", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"idempotency_key\": \"\",\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"DASHBOARD\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"CUSTOM\",\n \"to_state\": \"RECEIVED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"XDR\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"PAYROLL\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"WASTE\",\n \"to_state\": \"NONE\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"WASTE\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"BILLING\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_SQUARE_FOOT\",\n \"length_unit\": \"METRIC_MILLIMETER\",\n \"volume_unit\": \"GENERIC_FLUID_OUNCE\",\n \"weight_unit\": \"IMPERIAL_POUND\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_SECOND\",\n \"type\": \"TYPE_WEIGHT\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ],\n \"ignore_unchanged_counts\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/batch-change", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "batch-change" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"ACCOUNT_UNUSABLE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"counts\": [\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n }\n ],\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"COMPOSED\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"BILLING\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"COMPOSED\",\n \"to_state\": \"COMPOSED\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"HRK\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"EXTERNAL_API\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"RESERVED_FOR_SALE\",\n \"to_state\": \"WASTE\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"IN_TRANSIT\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"INVOICES\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_ACRE\",\n \"length_unit\": \"IMPERIAL_INCH\",\n \"volume_unit\": \"GENERIC_PINT\",\n \"weight_unit\": \"METRIC_GRAM\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_MILLISECOND\",\n \"type\": \"TYPE_CUSTOM\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-ecf09df0-a53e-4d41-8039-b5cf37df45e1" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-a893f4e3-97f6-4551-90f3-831d78657c21" } ], "id": "8e979878-f851-4fe9-91cd-8a3e20a02581", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-8e979878-f851-4fe9-91cd-8a3e20a02581" }, { "name": "batch-retrieve-changes", "item": [ { "name": "Square Deprecated Batch Retrieve Inventory Changes", "id": "9b4a96da-5172-4927-bc2c-62f04b44e2cb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"types\": [\n \"PHYSICAL_COUNT\",\n \"PHYSICAL_COUNT\"\n ],\n \"states\": [\n \"CUSTOM\",\n \"RESERVED_FOR_SALE\"\n ],\n \"updated_after\": \"\",\n \"updated_before\": \"\",\n \"cursor\": \"\",\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/batch-retrieve-changes", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "batch-retrieve-changes" ] }, "description": "Deprecated version of [BatchRetrieveInventoryChanges](api-endpoint:Inventory-BatchRetrieveInventoryChanges) after the endpoint URL\nis updated to conform to the standard convention." }, "response": [ { "id": "118d89f6-8eb0-4e85-8d43-7d444265552d", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"types\": [\n \"PHYSICAL_COUNT\",\n \"PHYSICAL_COUNT\"\n ],\n \"states\": [\n \"CUSTOM\",\n \"RESERVED_FOR_SALE\"\n ],\n \"updated_after\": \"\",\n \"updated_before\": \"\",\n \"cursor\": \"\",\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/batch-retrieve-changes", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "batch-retrieve-changes" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"REFUND_ALREADY_PENDING\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"IN_TRANSIT_TO\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"ITEM_LIBRARY_IMPORT\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"SOLD_ONLINE\",\n \"to_state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"HUF\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"INVOICES\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"IN_STOCK\",\n \"to_state\": \"RECEIVED_FROM_VENDOR\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"INVOICES\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_SQUARE_MILE\",\n \"length_unit\": \"METRIC_MILLIMETER\",\n \"volume_unit\": \"IMPERIAL_CUBIC_FOOT\",\n \"weight_unit\": \"IMPERIAL_STONE\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_HOUR\",\n \"type\": \"TYPE_LENGTH\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-118d89f6-8eb0-4e85-8d43-7d444265552d" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-9b4a96da-5172-4927-bc2c-62f04b44e2cb" } ], "id": "058bf921-18bd-4166-8ee3-01f7d50bbab6", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-058bf921-18bd-4166-8ee3-01f7d50bbab6" }, { "name": "batch-retrieve-counts", "item": [ { "name": "Square Deprecated Batch Retrieve Inventory Counts", "id": "f776701e-d819-4e8d-bc93-8626706cdca1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"updated_after\": \"\",\n \"cursor\": \"\",\n \"states\": [\n \"IN_STOCK\",\n \"COMPOSED\"\n ],\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/batch-retrieve-counts", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "batch-retrieve-counts" ] }, "description": "Deprecated version of [BatchRetrieveInventoryCounts](api-endpoint:Inventory-BatchRetrieveInventoryCounts) after the endpoint URL\nis updated to conform to the standard convention." }, "response": [ { "id": "066c8856-f20d-4c07-939d-3da28bd0b41e", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"updated_after\": \"\",\n \"cursor\": \"\",\n \"states\": [\n \"IN_STOCK\",\n \"COMPOSED\"\n ],\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/batch-retrieve-counts", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "batch-retrieve-counts" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"API_ERROR\",\n \"code\": \"VERIFY_AVS_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"METHOD_NOT_ALLOWED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"counts\": [\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"ORDERED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n },\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"CUSTOM\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-066c8856-f20d-4c07-939d-3da28bd0b41e" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-f776701e-d819-4e8d-bc93-8626706cdca1" } ], "id": "195b51b9-2f6d-44f4-8a64-efc78ac71b2b", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-195b51b9-2f6d-44f4-8a64-efc78ac71b2b" }, { "name": "changes", "item": [ { "name": "batch-create", "item": [ { "name": "Square Batch Change Inventory", "id": "f205d90b-6238-4a9b-a575-dce10aad90ee", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"idempotency_key\": \"\",\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"DASHBOARD\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"CUSTOM\",\n \"to_state\": \"RECEIVED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"XDR\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"PAYROLL\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"WASTE\",\n \"to_state\": \"NONE\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"WASTE\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"BILLING\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_SQUARE_FOOT\",\n \"length_unit\": \"METRIC_MILLIMETER\",\n \"volume_unit\": \"GENERIC_FLUID_OUNCE\",\n \"weight_unit\": \"IMPERIAL_POUND\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_SECOND\",\n \"type\": \"TYPE_WEIGHT\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ],\n \"ignore_unchanged_counts\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/changes/batch-create", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "changes", "batch-create" ] }, "description": "Applies adjustments and counts to the provided item quantities.\n\nOn success: returns the current calculated counts for all objects\nreferenced in the request.\nOn failure: returns a list of related errors." }, "response": [ { "id": "4fec6f5e-c19e-45d1-b271-04060d566ff3", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"idempotency_key\": \"\",\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"DASHBOARD\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"CUSTOM\",\n \"to_state\": \"RECEIVED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"XDR\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"PAYROLL\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"WASTE\",\n \"to_state\": \"NONE\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"WASTE\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"BILLING\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_SQUARE_FOOT\",\n \"length_unit\": \"METRIC_MILLIMETER\",\n \"volume_unit\": \"GENERIC_FLUID_OUNCE\",\n \"weight_unit\": \"IMPERIAL_POUND\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_SECOND\",\n \"type\": \"TYPE_WEIGHT\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ],\n \"ignore_unchanged_counts\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/changes/batch-create", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "changes", "batch-create" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"ACCOUNT_UNUSABLE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"counts\": [\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n }\n ],\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"COMPOSED\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"BILLING\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"COMPOSED\",\n \"to_state\": \"COMPOSED\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"HRK\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"EXTERNAL_API\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"RESERVED_FOR_SALE\",\n \"to_state\": \"WASTE\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"IN_TRANSIT\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"INVOICES\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_ACRE\",\n \"length_unit\": \"IMPERIAL_INCH\",\n \"volume_unit\": \"GENERIC_PINT\",\n \"weight_unit\": \"METRIC_GRAM\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_MILLISECOND\",\n \"type\": \"TYPE_CUSTOM\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-4fec6f5e-c19e-45d1-b271-04060d566ff3" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-f205d90b-6238-4a9b-a575-dce10aad90ee" } ], "id": "f2a591dc-73e0-4a90-9c08-57afc72686dc", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-f2a591dc-73e0-4a90-9c08-57afc72686dc" }, { "name": "batch-retrieve", "item": [ { "name": "Square Batch Retrieve Inventory Changes", "id": "a8934c99-2242-4238-bc5e-27a185755070", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"types\": [\n \"PHYSICAL_COUNT\",\n \"PHYSICAL_COUNT\"\n ],\n \"states\": [\n \"CUSTOM\",\n \"RESERVED_FOR_SALE\"\n ],\n \"updated_after\": \"\",\n \"updated_before\": \"\",\n \"cursor\": \"\",\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/changes/batch-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "changes", "batch-retrieve" ] }, "description": "Returns historical physical counts and adjustments based on the\nprovided filter criteria.\n\nResults are paginated and sorted in ascending order according their\n`occurred_at` timestamp (oldest first).\n\nBatchRetrieveInventoryChanges is a catch-all query endpoint for queries\nthat cannot be handled by other, simpler endpoints." }, "response": [ { "id": "2111b6ee-1827-46f5-a7fe-6535ce2ae591", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"types\": [\n \"PHYSICAL_COUNT\",\n \"PHYSICAL_COUNT\"\n ],\n \"states\": [\n \"CUSTOM\",\n \"RESERVED_FOR_SALE\"\n ],\n \"updated_after\": \"\",\n \"updated_before\": \"\",\n \"cursor\": \"\",\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/changes/batch-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "changes", "batch-retrieve" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"REFUND_ALREADY_PENDING\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"IN_TRANSIT_TO\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"ITEM_LIBRARY_IMPORT\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"SOLD_ONLINE\",\n \"to_state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"HUF\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"INVOICES\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"IN_STOCK\",\n \"to_state\": \"RECEIVED_FROM_VENDOR\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"SUPPORTED_BY_NEWER_VERSION\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"INVOICES\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_SQUARE_MILE\",\n \"length_unit\": \"METRIC_MILLIMETER\",\n \"volume_unit\": \"IMPERIAL_CUBIC_FOOT\",\n \"weight_unit\": \"IMPERIAL_STONE\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_HOUR\",\n \"type\": \"TYPE_LENGTH\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-2111b6ee-1827-46f5-a7fe-6535ce2ae591" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-a8934c99-2242-4238-bc5e-27a185755070" } ], "id": "9b6678d1-e0b3-4117-9fce-a7a1ff8af5a0", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-9b6678d1-e0b3-4117-9fce-a7a1ff8af5a0" } ], "id": "57da74c7-9704-4b2a-ad23-540e1634ecc8", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-57da74c7-9704-4b2a-ad23-540e1634ecc8" }, { "name": "counts", "item": [ { "name": "batch-retrieve", "item": [ { "name": "Square Batch Retrieve Inventory Counts", "id": "949c83d7-02cb-4dc8-88bb-e24937e4fd0d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"updated_after\": \"\",\n \"cursor\": \"\",\n \"states\": [\n \"IN_STOCK\",\n \"COMPOSED\"\n ],\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/counts/batch-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "counts", "batch-retrieve" ] }, "description": "Returns current counts for the provided\n[CatalogObject](entity:CatalogObject)s at the requested\n[Location](entity:Location)s.\n\nResults are paginated and sorted in descending order according to their\n`calculated_at` timestamp (newest first).\n\nWhen `updated_after` is specified, only counts that have changed since that\ntime (based on the server timestamp for the most recent change) are\nreturned. This allows clients to perform a \"sync\" operation, for example\nin response to receiving a Webhook notification." }, "response": [ { "id": "231d074f-2513-41b6-a017-4c406d57f10b", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"catalog_object_ids\": [\n \"\",\n \"\"\n ],\n \"location_ids\": [\n \"\",\n \"\"\n ],\n \"updated_after\": \"\",\n \"cursor\": \"\",\n \"states\": [\n \"IN_STOCK\",\n \"COMPOSED\"\n ],\n \"limit\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v2/inventory/counts/batch-retrieve", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "counts", "batch-retrieve" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"API_ERROR\",\n \"code\": \"VERIFY_AVS_FAILURE\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"REFUND_ERROR\",\n \"code\": \"METHOD_NOT_ALLOWED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"counts\": [\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"ORDERED_FROM_VENDOR\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n },\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"CUSTOM\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-231d074f-2513-41b6-a017-4c406d57f10b" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-949c83d7-02cb-4dc8-88bb-e24937e4fd0d" } ], "id": "54b55777-7029-42a1-aa6b-0ff09859d004", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-54b55777-7029-42a1-aa6b-0ff09859d004" } ], "id": "65d00493-98f9-42f3-8199-9ef5d57a0d53", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-65d00493-98f9-42f3-8199-9ef5d57a0d53" }, { "name": "physical-count", "item": [ { "name": "{physical_count_id}", "item": [ { "name": "Square Deprecated Retrieve Inventory Physical Count", "id": "df9b4723-988d-4003-8d3c-eaf53dac9e12", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/physical-count/:physical_count_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "physical-count", ":physical_count_id" ], "variable": [ { "id": "202d11bd-929e-4dc7-b805-ba97007c917e", "key": "physical_count_id", "value": "", "description": "(Required) ID of the\n[InventoryPhysicalCount](entity:InventoryPhysicalCount) to retrieve." } ] }, "description": "Deprecated version of [RetrieveInventoryPhysicalCount](api-endpoint:Inventory-RetrieveInventoryPhysicalCount) after the endpoint URL\nis updated to conform to the standard convention." }, "response": [ { "id": "9b43baa1-6563-457a-afc6-8434158d58f5", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/physical-count/:physical_count_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "physical-count", ":physical_count_id" ], "variable": [ { "key": "physical_count_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"PLAID_ERROR_RATE_LIMIT\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"GENERIC_DECLINE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"WASTE\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"DASHBOARD\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n }\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-9b43baa1-6563-457a-afc6-8434158d58f5" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-df9b4723-988d-4003-8d3c-eaf53dac9e12" } ], "id": "16e195df-b6f7-47c8-a7d5-ae542517ddc5", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-16e195df-b6f7-47c8-a7d5-ae542517ddc5" } ], "id": "7cb21794-9875-4ea3-8097-951becf6ce36", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-7cb21794-9875-4ea3-8097-951becf6ce36" }, { "name": "physical-counts", "item": [ { "name": "{physical_count_id}", "item": [ { "name": "Square Retrieve Inventory Physical Count", "id": "b0593fb7-a7d5-431a-bbfa-0e5cf2fc7459", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/physical-counts/:physical_count_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "physical-counts", ":physical_count_id" ], "variable": [ { "id": "e5449446-abdc-49f0-99ab-f224b51aa551", "key": "physical_count_id", "value": "", "description": "(Required) ID of the\n[InventoryPhysicalCount](entity:InventoryPhysicalCount) to retrieve." } ] }, "description": "Returns the [InventoryPhysicalCount](entity:InventoryPhysicalCount)\nobject with the provided `physical_count_id`." }, "response": [ { "id": "4008a731-6e60-4ae2-bae8-6384577e33d3", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/physical-counts/:physical_count_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "physical-counts", ":physical_count_id" ], "variable": [ { "key": "physical_count_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"PLAID_ERROR_RATE_LIMIT\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"INVALID_REQUEST_ERROR\",\n \"code\": \"GENERIC_DECLINE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"WASTE\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"DASHBOARD\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n }\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-4008a731-6e60-4ae2-bae8-6384577e33d3" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-b0593fb7-a7d5-431a-bbfa-0e5cf2fc7459" } ], "id": "5739bdec-e342-4cd1-8b5c-a8212c522797", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-5739bdec-e342-4cd1-8b5c-a8212c522797" } ], "id": "cf08aaa5-ef1b-4ab7-9cfd-a719718c8294", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-cf08aaa5-ef1b-4ab7-9cfd-a719718c8294" }, { "name": "transfers", "item": [ { "name": "{transfer_id}", "item": [ { "name": "Square Retrieve Inventory Transfer", "id": "ae186ea3-0641-48ef-bf7f-e0ecd8102003", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/transfers/:transfer_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "transfers", ":transfer_id" ], "variable": [ { "id": "c34476aa-a968-4bab-a79b-56bc3aab97a5", "key": "transfer_id", "value": "", "description": "(Required) ID of the [InventoryTransfer](entity:InventoryTransfer) to retrieve." } ] }, "description": "Returns the [InventoryTransfer](entity:InventoryTransfer) object\nwith the provided `transfer_id`." }, "response": [ { "id": "87e12218-000e-48e6-beed-6c484a3a9805", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/transfers/:transfer_id", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", "transfers", ":transfer_id" ], "variable": [ { "key": "transfer_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"INVALID_CURSOR\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"EXTERNAL_VENDOR_ERROR\",\n \"code\": \"NOT_IMPLEMENTED\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"SOLD\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"SQUARE_POS\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n }\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-87e12218-000e-48e6-beed-6c484a3a9805" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-ae186ea3-0641-48ef-bf7f-e0ecd8102003" } ], "id": "6f357375-8039-4501-935d-512255ac8f9d", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-6f357375-8039-4501-935d-512255ac8f9d" } ], "id": "d1dc3b0d-a917-429a-af99-eb561f9aa8a3", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-d1dc3b0d-a917-429a-af99-eb561f9aa8a3" }, { "name": "{catalog_object_id}", "item": [ { "name": "changes", "item": [ { "name": "Square Retrieve Inventory Changes", "id": "c990d247-7257-40d2-bf3b-d76dacce59b1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/:catalog_object_id/changes?location_ids=&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", ":catalog_object_id", "changes" ], "query": [ { "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations.", "key": "location_ids", "value": "" }, { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for the original query.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.", "key": "cursor", "value": "" } ], "variable": [ { "id": "5a058edd-9363-4955-8aea-e9baf56aa204", "key": "catalog_object_id", "value": "", "description": "(Required) ID of the [CatalogObject](entity:CatalogObject) to retrieve." } ] }, "description": "Returns a set of physical counts and inventory adjustments for the\nprovided [CatalogObject](entity:CatalogObject) at the requested\n[Location](entity:Location)s.\n\nYou can achieve the same result by calling [BatchRetrieveInventoryChanges](api-endpoint:Inventory-BatchRetrieveInventoryChanges)\nand having the `catalog_object_ids` list contain a single element of the `CatalogObject` ID.\n\nResults are paginated and sorted in descending order according to their\n`occurred_at` timestamp (newest first).\n\nThere are no limits on how far back the caller can page. This endpoint can be\nused to display recent changes for a specific item. For more\nsophisticated queries, use a batch endpoint." }, "response": [ { "id": "eb07bc98-0d22-42da-a4de-bdf276e80a3c", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/:catalog_object_id/changes?location_ids=&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", ":catalog_object_id", "changes" ], "query": [ { "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations.", "key": "location_ids", "value": "" }, { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for the original query.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.", "key": "cursor", "value": "" } ], "variable": [ { "key": "catalog_object_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"MERCHANT_SUBSCRIPTION_ERROR\",\n \"code\": \"EXPECTED_INTEGER\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"changes\": [\n {\n \"type\": \"TRANSFER\",\n \"physical_count\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"IN_TRANSIT\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"source\": {\n \"product\": \"APPOINTMENTS\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\"\n },\n \"adjustment\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"from_state\": \"ORDERED_FROM_VENDOR\",\n \"to_state\": \"SOLD\",\n \"location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"total_price_money\": {\n \"amount\": \"\",\n \"currency\": \"IRR\"\n },\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"OTHER\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\",\n \"transaction_id\": \"\",\n \"refund_id\": \"\",\n \"purchase_order_id\": \"\",\n \"goods_receipt_id\": \"\",\n \"adjustment_group\": {\n \"id\": \"\",\n \"root_adjustment_id\": \"\",\n \"from_state\": \"DECOMPOSED\",\n \"to_state\": \"SOLD_ONLINE\"\n }\n },\n \"transfer\": {\n \"id\": \"\",\n \"reference_id\": \"\",\n \"state\": \"SOLD_ONLINE\",\n \"from_location_id\": \"\",\n \"to_location_id\": \"\",\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"quantity\": \"\",\n \"occurred_at\": \"\",\n \"created_at\": \"\",\n \"source\": {\n \"product\": \"PAYROLL\",\n \"application_id\": \"\",\n \"name\": \"\"\n },\n \"employee_id\": \"\",\n \"team_member_id\": \"\"\n },\n \"measurement_unit\": {\n \"measurement_unit\": {\n \"custom_unit\": {\n \"name\": \"\",\n \"abbreviation\": \"\"\n },\n \"area_unit\": \"IMPERIAL_SQUARE_FOOT\",\n \"length_unit\": \"IMPERIAL_INCH\",\n \"volume_unit\": \"IMPERIAL_CUBIC_YARD\",\n \"weight_unit\": \"IMPERIAL_POUND\",\n \"generic_unit\": \"UNIT\",\n \"time_unit\": \"GENERIC_HOUR\",\n \"type\": \"TYPE_VOLUME\"\n },\n \"precision\": \"\"\n },\n \"measurement_unit_id\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-eb07bc98-0d22-42da-a4de-bdf276e80a3c" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-c990d247-7257-40d2-bf3b-d76dacce59b1" } ], "id": "f95e9e35-ac13-45f0-9d6f-fd52d7aa5006", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-f95e9e35-ac13-45f0-9d6f-fd52d7aa5006" }, { "name": "Square Retrieve Inventory Count", "id": "51b8bee5-53cb-41f8-8a86-730690e89ace", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "ADDON_CONFIGURATIONS_READ ADDON_CONFIGURATIONS_WRITE APPOINTMENTS_ALL_READ APPOINTMENTS_ALL_WRITE APPOINTMENTS_BUSINESS_SETTINGS_READ APPOINTMENTS_READ APPOINTMENTS_WRITE BANK_ACCOUNTS_READ CASH_DRAWER_READ CHANNELS_CREATE CHANNELS_READ CHANNELS_UPDATE CUSTOMERS_READ CUSTOMERS_WRITE DEVICES_READ DEVICE_CREDENTIAL_MANAGEMENT DISPUTES_READ DISPUTES_WRITE EMPLOYEES_READ EMPLOYEES_WRITE GIFTCARDS_READ GIFTCARDS_WRITE INVENTORY_READ INVENTORY_WRITE INVOICES_READ INVOICES_WRITE ITEMS_READ ITEMS_WRITE LOYALTY_READ LOYALTY_WRITE MERCHANT_PROFILE_READ MERCHANT_PROFILE_WRITE ONLINE_STORE_SITE_READ ONLINE_STORE_SNIPPETS_READ ONLINE_STORE_SNIPPETS_WRITE ORDERS_READ ORDERS_WRITE PAYMENTS_READ PAYMENTS_WRITE PAYMENTS_WRITE_ADDITIONAL_RECIPIENTS PAYMENTS_WRITE_IN_PERSON PAYMENTS_WRITE_SHARED_ONFILE PAYOUTS_READ PERMISSION_SETS_READ PERMISSION_SETS_WRITE RESERVATIONS_READ RESERVATIONS_WRITE RESTAURANT_CHECKS_READ SETTLEMENTS_READ SUBSCRIPTIONS_READ SUBSCRIPTIONS_WRITE TIMECARDS_READ TIMECARDS_SETTINGS_READ TIMECARDS_SETTINGS_WRITE TIMECARDS_WRITE VENDOR_READ VENDOR_WRITE", "type": "string" }, { "key": "accessTokenUrl", "value": "https://connect.squareup.com/oauth2/token", "type": "string" }, { "key": "authUrl", "value": "https://connect.squareup.com/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/:catalog_object_id?location_ids=&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", ":catalog_object_id" ], "query": [ { "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations.", "key": "location_ids", "value": "" }, { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for the original query.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.", "key": "cursor", "value": "" } ], "variable": [ { "id": "75d36e27-7abf-4385-a66b-6ccf38dd491b", "key": "catalog_object_id", "value": "", "description": "(Required) ID of the [CatalogObject](entity:CatalogObject) to retrieve." } ] }, "description": "Retrieves the current calculated stock count for a given\n[CatalogObject](entity:CatalogObject) at a given set of\n[Location](entity:Location)s. Responses are paginated and unsorted.\nFor more sophisticated queries, use a batch endpoint." }, "response": [ { "id": "9ddbddb9-94fe-41a5-b12e-db5b030512fa", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/v2/inventory/:catalog_object_id?location_ids=&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v2", "inventory", ":catalog_object_id" ], "query": [ { "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations.", "key": "location_ids", "value": "" }, { "description": "A pagination cursor returned by a previous call to this endpoint.\nProvide this to retrieve the next set of results for the original query.\n\nSee the [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination) guide for more information.", "key": "cursor", "value": "" } ], "variable": [ { "key": "catalog_object_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"category\": \"AUTHENTICATION_ERROR\",\n \"code\": \"UNSUPPORTED_CURRENCY\",\n \"detail\": \"\",\n \"field\": \"\"\n },\n {\n \"category\": \"API_ERROR\",\n \"code\": \"INVALID_ARRAY_VALUE\",\n \"detail\": \"\",\n \"field\": \"\"\n }\n ],\n \"counts\": [\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"IN_STOCK\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n },\n {\n \"catalog_object_id\": \"\",\n \"catalog_object_type\": \"\",\n \"state\": \"RETURNED_BY_CUSTOMER\",\n \"location_id\": \"\",\n \"quantity\": \"\",\n \"calculated_at\": \"\",\n \"is_estimated\": \"\"\n }\n ],\n \"cursor\": \"\"\n}", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-9ddbddb9-94fe-41a5-b12e-db5b030512fa" } ], "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-51b8bee5-53cb-41f8-8a86-730690e89ace" } ], "id": "942f05b5-1f53-43e9-9eec-5672b33ee8b0", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-942f05b5-1f53-43e9-9eec-5672b33ee8b0" } ], "id": "455c78fc-a08d-4b85-9a60-8f791e3224f1", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-455c78fc-a08d-4b85-9a60-8f791e3224f1" } ], "id": "4e54e1b3-5ff6-4f57-98e5-a06f322c00c5", "createdAt": "2026-07-28T03:03:52.000Z", "updatedAt": "2026-07-28T03:03:52.000Z", "uid": "35240-4e54e1b3-5ff6-4f57-98e5-a06f322c00c5" } ], "variable": [ { "key": "baseUrl", "value": "https://connect.squareup.com" } ] }