Square.Connect.Api.CatalogApi

All URIs are relative to https://connect.squareup.com

Method	HTTP request	Description
BatchDeleteCatalogObjects	POST /v2/catalog/batch-delete	BatchDeleteCatalogObjects
BatchRetrieveCatalogObjects	POST /v2/catalog/batch-retrieve	BatchRetrieveCatalogObjects
BatchUpsertCatalogObjects	POST /v2/catalog/batch-upsert	BatchUpsertCatalogObjects
CatalogInfo	GET /v2/catalog/info	CatalogInfo
DeleteCatalogObject	DELETE /v2/catalog/object/{object_id}	DeleteCatalogObject
ListCatalog	GET /v2/catalog/list	ListCatalog
RetrieveCatalogObject	GET /v2/catalog/object/{object_id}	RetrieveCatalogObject
SearchCatalogObjects	POST /v2/catalog/search	SearchCatalogObjects
UpdateItemModifierLists	POST /v2/catalog/update-item-modifier-lists	UpdateItemModifierLists
UpdateItemTaxes	POST /v2/catalog/update-item-taxes	UpdateItemTaxes
UpsertCatalogObject	POST /v2/catalog/object	UpsertCatalogObject

BatchDeleteCatalogObjects

BatchDeleteCatalogObjectsResponse BatchDeleteCatalogObjects (BatchDeleteCatalogObjectsRequest body)

BatchDeleteCatalogObjects

Deletes a set of CatalogItems based on the provided list of target IDs and returns a set of successfully deleted IDs in the response. Deletion is a cascading event such that all children of the targeted object are also deleted. For example, deleting a CatalogItem will also delete all of its CatalogItemVariation children. BatchDeleteCatalogObjects succeeds even if only a portion of the targeted IDs can be deleted. The response will only include IDs that were actually deleted.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class BatchDeleteCatalogObjectsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var body = new BatchDeleteCatalogObjectsRequest(); // BatchDeleteCatalogObjectsRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.

            try
            {
                // BatchDeleteCatalogObjects
                BatchDeleteCatalogObjectsResponse result = apiInstance.BatchDeleteCatalogObjects(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.BatchDeleteCatalogObjects: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
body	BatchDeleteCatalogObjectsRequest	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Return type

BatchDeleteCatalogObjectsResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

BatchRetrieveCatalogObjects

BatchRetrieveCatalogObjectsResponse BatchRetrieveCatalogObjects (BatchRetrieveCatalogObjectsRequest body)

BatchRetrieveCatalogObjects

Returns a set of objects based on the provided ID. Each CatalogItem returned in the set includes all of its child information including: all of its CatalogItemVariation objects, references to its CatalogModifierList objects, and the ids of any CatalogTax objects that apply to it.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class BatchRetrieveCatalogObjectsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var body = new BatchRetrieveCatalogObjectsRequest(); // BatchRetrieveCatalogObjectsRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.

            try
            {
                // BatchRetrieveCatalogObjects
                BatchRetrieveCatalogObjectsResponse result = apiInstance.BatchRetrieveCatalogObjects(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.BatchRetrieveCatalogObjects: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
body	BatchRetrieveCatalogObjectsRequest	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Return type

BatchRetrieveCatalogObjectsResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

BatchUpsertCatalogObjects

BatchUpsertCatalogObjectsResponse BatchUpsertCatalogObjects (BatchUpsertCatalogObjectsRequest body)

BatchUpsertCatalogObjects

Creates or updates up to 10,000 target objects based on the provided list of objects. The target objects are grouped into batches and each batch is inserted/updated in an all-or-nothing manner. If an object within a batch is malformed in some way, or violates a database constraint, the entire batch containing that item will be disregarded. However, other batches in the same request may still succeed. Each batch may contain up to 1,000 objects, and batches will be processed in order as long as the total object count for the request (items, variations, modifier lists, discounts, and taxes) is no more than 10,000.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class BatchUpsertCatalogObjectsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var body = new BatchUpsertCatalogObjectsRequest(); // BatchUpsertCatalogObjectsRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.

            try
            {
                // BatchUpsertCatalogObjects
                BatchUpsertCatalogObjectsResponse result = apiInstance.BatchUpsertCatalogObjects(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.BatchUpsertCatalogObjects: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
body	BatchUpsertCatalogObjectsRequest	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Return type

BatchUpsertCatalogObjectsResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

CatalogInfo

CatalogInfoResponse CatalogInfo ()

CatalogInfo

Returns information about the Square Catalog API, such as batch size limits for BatchUpsertCatalogObjects.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class CatalogInfoExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();

            try
            {
                // CatalogInfo
                CatalogInfoResponse result = apiInstance.CatalogInfo();
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.CatalogInfo: " + e.Message );
            }
        }
    }
}

Parameters

This endpoint does not need any parameter.

Return type

CatalogInfoResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

DeleteCatalogObject

DeleteCatalogObjectResponse DeleteCatalogObject (string objectId)

DeleteCatalogObject

Deletes a single CatalogObject based on the provided ID and returns the set of successfully deleted IDs in the response. Deletion is a cascading event such that all children of the targeted object are also deleted. For example, deleting a CatalogItem will also delete all of its CatalogItemVariation children.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class DeleteCatalogObjectExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var objectId = objectId_example;  // string | The ID of the catalog object to be deleted. When an object is deleted, other objects in the graph that depend on that object will be deleted as well (for example, deleting a catalog item will delete its catalog item variations).

            try
            {
                // DeleteCatalogObject
                DeleteCatalogObjectResponse result = apiInstance.DeleteCatalogObject(objectId);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.DeleteCatalogObject: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
objectId	string	The ID of the catalog object to be deleted. When an object is deleted, other objects in the graph that depend on that object will be deleted as well (for example, deleting a catalog item will delete its catalog item variations).

Return type

DeleteCatalogObjectResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

ListCatalog

ListCatalogResponse ListCatalog (string cursor = null, string types = null)

ListCatalog

Returns a list of CatalogObjects that includes all objects of a set of desired types (for example, all CatalogItem and CatalogTax objects) in the catalog. The types parameter is specified as a comma-separated list of valid CatalogObject types: ITEM, ITEM_VARIATION, MODIFIER, MODIFIER_LIST, CATEGORY, DISCOUNT, TAX, IMAGE. Important: ListCatalog does not return deleted catalog items. To retrieve deleted catalog items, use SearchCatalogObjects and set include_deleted_objects to true.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class ListCatalogExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var cursor = cursor_example;  // string | The pagination cursor returned in the previous response. Leave unset for an initial request. See [Pagination](https://developer.squareup.com/docs/basics/api101/pagination) for more information. (optional) 
            var types = types_example;  // string | An optional case-insensitive, comma-separated list of object types to retrieve, for example `ITEM,ITEM_VARIATION,CATEGORY,IMAGE`.  The legal values are taken from the CatalogObjectType enum: `ITEM`, `ITEM_VARIATION`, `CATEGORY`, `DISCOUNT`, `TAX`, `MODIFIER`, `MODIFIER_LIST`, or `IMAGE`. (optional) 

            try
            {
                // ListCatalog
                ListCatalogResponse result = apiInstance.ListCatalog(cursor, types);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.ListCatalog: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
cursor	string	The pagination cursor returned in the previous response. Leave unset for an initial request. See Pagination for more information.	[optional]
types	string	An optional case-insensitive, comma-separated list of object types to retrieve, for example `ITEM,ITEM_VARIATION,CATEGORY,IMAGE`. The legal values are taken from the CatalogObjectType enum: `ITEM`, `ITEM_VARIATION`, `CATEGORY`, `DISCOUNT`, `TAX`, `MODIFIER`, `MODIFIER_LIST`, or `IMAGE`.	[optional]

Return type

ListCatalogResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

RetrieveCatalogObject

RetrieveCatalogObjectResponse RetrieveCatalogObject (string objectId, bool? includeRelatedObjects = null)

RetrieveCatalogObject

Returns a single CatalogItem as a CatalogObject based on the provided ID. The returned object includes all of the relevant CatalogItem information including: CatalogItemVariation children, references to its CatalogModifierList objects, and the ids of any CatalogTax objects that apply to it.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class RetrieveCatalogObjectExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var objectId = objectId_example;  // string | The object ID of any type of catalog objects to be retrieved.
            var includeRelatedObjects = true;  // bool? | If `true`, the response will include additional objects that are related to the requested object, as follows:  If the `object` field of the response contains a CatalogItem, its associated CatalogCategory, CatalogTax objects, CatalogImages and CatalogModifierLists will be returned in the `related_objects` field of the response. If the `object` field of the response contains a CatalogItemVariation, its parent CatalogItem will be returned in the `related_objects` field of the response.  Default value: `false` (optional) 

            try
            {
                // RetrieveCatalogObject
                RetrieveCatalogObjectResponse result = apiInstance.RetrieveCatalogObject(objectId, includeRelatedObjects);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.RetrieveCatalogObject: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
objectId	string	The object ID of any type of catalog objects to be retrieved.
includeRelatedObjects	bool?	If `true`, the response will include additional objects that are related to the requested object, as follows: If the `object` field of the response contains a CatalogItem, its associated CatalogCategory, CatalogTax objects, CatalogImages and CatalogModifierLists will be returned in the `related_objects` field of the response. If the `object` field of the response contains a CatalogItemVariation, its parent CatalogItem will be returned in the `related_objects` field of the response. Default value: `false`	[optional]

Return type

RetrieveCatalogObjectResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

SearchCatalogObjects

SearchCatalogObjectsResponse SearchCatalogObjects (SearchCatalogObjectsRequest body)

SearchCatalogObjects

Queries the targeted catalog using a variety of query types: CatalogQuerySortedAttribute, CatalogQueryExact, CatalogQueryRange, CatalogQueryText, CatalogQueryItemsForTax, and CatalogQueryItemsForModifierList. - - - - Future end of the above comment: CatalogQueryItemsForTax, CatalogQueryItemsForModifierList, CatalogQueryItemsForItemOptions, and CatalogQueryItemVariationsForItemOptionValues.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class SearchCatalogObjectsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var body = new SearchCatalogObjectsRequest(); // SearchCatalogObjectsRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.

            try
            {
                // SearchCatalogObjects
                SearchCatalogObjectsResponse result = apiInstance.SearchCatalogObjects(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.SearchCatalogObjects: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
body	SearchCatalogObjectsRequest	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Return type

SearchCatalogObjectsResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateItemModifierLists

UpdateItemModifierListsResponse UpdateItemModifierLists (UpdateItemModifierListsRequest body)

UpdateItemModifierLists

Updates the CatalogModifierList objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class UpdateItemModifierListsExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var body = new UpdateItemModifierListsRequest(); // UpdateItemModifierListsRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.

            try
            {
                // UpdateItemModifierLists
                UpdateItemModifierListsResponse result = apiInstance.UpdateItemModifierLists(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.UpdateItemModifierLists: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
body	UpdateItemModifierListsRequest	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Return type

UpdateItemModifierListsResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpdateItemTaxes

UpdateItemTaxesResponse UpdateItemTaxes (UpdateItemTaxesRequest body)

UpdateItemTaxes

Updates the CatalogTax objects that apply to the targeted CatalogItem without having to perform an upsert on the entire item.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class UpdateItemTaxesExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var body = new UpdateItemTaxesRequest(); // UpdateItemTaxesRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.

            try
            {
                // UpdateItemTaxes
                UpdateItemTaxesResponse result = apiInstance.UpdateItemTaxes(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.UpdateItemTaxes: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
body	UpdateItemTaxesRequest	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Return type

UpdateItemTaxesResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

UpsertCatalogObject

UpsertCatalogObjectResponse UpsertCatalogObject (UpsertCatalogObjectRequest body)

UpsertCatalogObject

Creates or updates the target CatalogObject.

Example

using System;
using System.Diagnostics;
using Square.Connect.Api;
using Square.Connect.Client;
using Square.Connect.Model;

namespace Example
{
    public class UpsertCatalogObjectExample
    {
        public void main()
        {
            
            // Configure OAuth2 access token for authorization: oauth2
            Configuration.Default.AccessToken = "YOUR_ACCESS_TOKEN";

            var apiInstance = new CatalogApi();
            var body = new UpsertCatalogObjectRequest(); // UpsertCatalogObjectRequest | An object containing the fields to POST for the request.  See the corresponding object definition for field details.

            try
            {
                // UpsertCatalogObject
                UpsertCatalogObjectResponse result = apiInstance.UpsertCatalogObject(body);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling CatalogApi.UpsertCatalogObject: " + e.Message );
            }
        }
    }
}

Parameters

Name	Type	Description	Notes
body	UpsertCatalogObjectRequest	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Return type

UpsertCatalogObjectResponse

Authorization

oauth2

HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

Files

CatalogApi.md

Latest commit

History

CatalogApi.md

File metadata and controls

Square.Connect.Api.CatalogApi

BatchDeleteCatalogObjects

Example

Parameters

Return type

Authorization

HTTP request headers

BatchRetrieveCatalogObjects

Example

Parameters

Return type

Authorization

HTTP request headers

BatchUpsertCatalogObjects

Example

Parameters

Return type

Authorization

HTTP request headers

CatalogInfo

Example

Parameters

Return type

Authorization

HTTP request headers

DeleteCatalogObject

Example

Parameters

Return type

Authorization

HTTP request headers

ListCatalog

Example

Parameters

Return type

Authorization

HTTP request headers

RetrieveCatalogObject

Example

Parameters

Return type

Authorization

HTTP request headers

SearchCatalogObjects

Example

Parameters

Return type

Authorization

HTTP request headers

UpdateItemModifierLists

Example

Parameters

Return type

Authorization

HTTP request headers

UpdateItemTaxes

Example

Parameters

Return type

Authorization

HTTP request headers

UpsertCatalogObject

Example

Parameters

Return type

Authorization

HTTP request headers