{ "opencollection": "1.0.0", "info": { "name": "Square ApplePay Inventory API", "version": "2.0" }, "items": [ { "info": { "name": "Inventory", "type": "folder" }, "items": [ { "info": { "name": "Square Deprecated Retrieve Inventory Adjustment", "type": "http" }, "http": { "method": "GET", "url": "https://connect.squareup.com/v2/inventory/adjustment/:adjustment_id", "params": [ { "name": "adjustment_id", "value": "", "type": "path", "description": "ID of the [InventoryAdjustment](entity:InventoryAdjustment) to retrieve." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deprecated version of [RetrieveInventoryAdjustment](api-endpoint:Inventory-RetrieveInventoryAdjustment) after the endpoint URL\nis updated to conform to the standard convention." }, { "info": { "name": "Square Retrieve Inventory Adjustment", "type": "http" }, "http": { "method": "GET", "url": "https://connect.squareup.com/v2/inventory/adjustments/:adjustment_id", "params": [ { "name": "adjustment_id", "value": "", "type": "path", "description": "ID of the [InventoryAdjustment](entity:InventoryAdjustment) to retrieve." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Returns the [InventoryAdjustment](entity:InventoryAdjustment) object\nwith the provided `adjustment_id`." }, { "info": { "name": "Square Deprecated Batch Change Inventory", "type": "http" }, "http": { "method": "POST", "url": "https://connect.squareup.com/v2/inventory/batch-change", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deprecated version of [BatchChangeInventory](api-endpoint:Inventory-BatchChangeInventory) after the endpoint URL\nis updated to conform to the standard convention." }, { "info": { "name": "Square Deprecated Batch Retrieve Inventory Changes", "type": "http" }, "http": { "method": "POST", "url": "https://connect.squareup.com/v2/inventory/batch-retrieve-changes", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deprecated version of [BatchRetrieveInventoryChanges](api-endpoint:Inventory-BatchRetrieveInventoryChanges) after the endpoint URL\nis updated to conform to the standard convention." }, { "info": { "name": "Square Deprecated Batch Retrieve Inventory Counts", "type": "http" }, "http": { "method": "POST", "url": "https://connect.squareup.com/v2/inventory/batch-retrieve-counts", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deprecated version of [BatchRetrieveInventoryCounts](api-endpoint:Inventory-BatchRetrieveInventoryCounts) after the endpoint URL\nis updated to conform to the standard convention." }, { "info": { "name": "Square Batch Change Inventory", "type": "http" }, "http": { "method": "POST", "url": "https://connect.squareup.com/v2/inventory/changes/batch-create", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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." }, { "info": { "name": "Square Batch Retrieve Inventory Changes", "type": "http" }, "http": { "method": "POST", "url": "https://connect.squareup.com/v2/inventory/changes/batch-retrieve", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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." }, { "info": { "name": "Square Batch Retrieve Inventory Counts", "type": "http" }, "http": { "method": "POST", "url": "https://connect.squareup.com/v2/inventory/counts/batch-retrieve", "body": { "type": "json", "data": "{}" }, "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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 notifi" }, { "info": { "name": "Square Deprecated Retrieve Inventory Physical Count", "type": "http" }, "http": { "method": "GET", "url": "https://connect.squareup.com/v2/inventory/physical-count/:physical_count_id", "params": [ { "name": "physical_count_id", "value": "", "type": "path", "description": "ID of the\n[InventoryPhysicalCount](entity:InventoryPhysicalCount) to retrieve." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Deprecated version of [RetrieveInventoryPhysicalCount](api-endpoint:Inventory-RetrieveInventoryPhysicalCount) after the endpoint URL\nis updated to conform to the standard convention." }, { "info": { "name": "Square Retrieve Inventory Physical Count", "type": "http" }, "http": { "method": "GET", "url": "https://connect.squareup.com/v2/inventory/physical-counts/:physical_count_id", "params": [ { "name": "physical_count_id", "value": "", "type": "path", "description": "ID of the\n[InventoryPhysicalCount](entity:InventoryPhysicalCount) to retrieve." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Returns the [InventoryPhysicalCount](entity:InventoryPhysicalCount)\nobject with the provided `physical_count_id`." }, { "info": { "name": "Square Retrieve Inventory Transfer", "type": "http" }, "http": { "method": "GET", "url": "https://connect.squareup.com/v2/inventory/transfers/:transfer_id", "params": [ { "name": "transfer_id", "value": "", "type": "path", "description": "ID of the [InventoryTransfer](entity:InventoryTransfer) to retrieve." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "Returns the [InventoryTransfer](entity:InventoryTransfer) object\nwith the provided `transfer_id`." }, { "info": { "name": "Square Retrieve Inventory Count", "type": "http" }, "http": { "method": "GET", "url": "https://connect.squareup.com/v2/inventory/:catalog_object_id", "params": [ { "name": "catalog_object_id", "value": "", "type": "path", "description": "ID of the [CatalogObject](entity:CatalogObject) to retrieve." }, { "name": "location_ids", "value": "", "type": "query", "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations." }, { "name": "cursor", "value": "", "type": "query", "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." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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." }, { "info": { "name": "Square Retrieve Inventory Changes", "type": "http" }, "http": { "method": "GET", "url": "https://connect.squareup.com/v2/inventory/:catalog_object_id/changes", "params": [ { "name": "catalog_object_id", "value": "", "type": "path", "description": "ID of the [CatalogObject](entity:CatalogObject) to retrieve." }, { "name": "location_ids", "value": "", "type": "query", "description": "The [Location](entity:Location) IDs to look up as a comma-separated\nlist. An empty list queries all locations." }, { "name": "cursor", "value": "", "type": "query", "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." } ], "auth": { "type": "oauth2", "flow": "authorization_code", "authorizationUrl": "https://connect.squareup.com/oauth2/authorize", "accessTokenUrl": "https://connect.squareup.com/oauth2/token", "credentials": { "clientId": "{{clientId}}", "clientSecret": "{{clientSecret}}" } } }, "docs": "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\nTh" } ] } ], "bundled": true }