Catalog info

GET

/v2/catalog/info

Retrieves information about the Square Catalog API, such as batch size limits that can be used by the BatchUpsertCatalogObjects endpoint.

Permissions:ITEMS_READ

Try in API Explorer

Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Link to section

limits

Limits that apply to this API.

Link to section

standard_unit_description_group

Names and abbreviations for standard units.

Link to section

Examples

All versions ->

GET /v2/catalog/info

curl https://connect.squareup.com/v2/catalog/info \
  -H 'Square-Version: 2025-07-16' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Response JSON

{
  "limits": {
    "batch_upsert_max_objects_per_batch": 1000,
    "batch_upsert_max_total_objects": 10000,
    "batch_retrieve_max_object_ids": 1000,
    "search_max_page_limit": 1000,
    "batch_delete_max_object_ids": 200,
    "update_item_taxes_max_item_ids": 1000,
    "update_item_taxes_max_taxes_to_enable": 1000,
    "update_item_taxes_max_taxes_to_disable": 1000,
    "update_item_modifier_lists_max_item_ids": 1000,
    "update_item_modifier_lists_max_modifier_lists_to_enable": 1000,
    "update_item_modifier_lists_max_modifier_lists_to_disable": 1000
  }
}