---
title: "CatalogInfo"
method: GET
path: "/v2/catalog/info"
tags: ["Catalog"]
---

# CatalogInfo

`GET /v2/catalog/info`

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

## Response `200`

Success

- CatalogInfoResponse
  - `errors` Error[] — Any errors that occurred during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.
  - `limits` CatalogInfoResponseLimits
    - `batch_delete_max_object_ids` integer — The maximum number of object IDs that may be included in a single `/v2/catalog/batch-delete` request.
    - `batch_retrieve_max_object_ids` integer — The maximum number of object IDs that may appear in a `/v2/catalog/batch-retrieve` request.
    - `batch_upsert_max_objects_per_batch` integer — The maximum number of objects that may appear within a single batch in a `/v2/catalog/batch-upsert` request.
    - `batch_upsert_max_total_objects` integer — The maximum number of objects that may appear across all batches in a `/v2/catalog/batch-upsert` request.
    - `search_max_page_limit` integer — The maximum number of results that may be returned in a page of a `/v2/catalog/search` response.
    - `update_item_modifier_lists_max_item_ids` integer — The maximum number of item IDs that may be included in a single `/v2/catalog/update-item-modifier-lists` request.
    - `update_item_modifier_lists_max_modifier_lists_to_disable` integer — The maximum number of modifier list IDs to be disabled that may be included in a single `/v2/catalog/update-item-modifier-lists` request.
    - `update_item_modifier_lists_max_modifier_lists_to_enable` integer — The maximum number of modifier list IDs to be enabled that may be included in a single `/v2/catalog/update-item-modifier-lists` request.
    - `update_item_taxes_max_item_ids` integer — The maximum number of item IDs that may be included in a single `/v2/catalog/update-item-taxes` request.
    - `update_item_taxes_max_taxes_to_disable` integer — The maximum number of tax IDs to be disabled that may be included in a single `/v2/catalog/update-item-taxes` request.
    - `update_item_taxes_max_taxes_to_enable` integer — The maximum number of tax IDs to be enabled that may be included in a single `/v2/catalog/update-item-taxes` request.
  - `standard_unit_description_group` StandardUnitDescriptionGroup — Group of standard measurement units.
    - `language_code` string — IETF language tag.
    - `standard_unit_descriptions` StandardUnitDescription[] — List of standard (non-custom) measurement units in this description group.
      - `abbreviation` string — UI display abbreviation for the measurement unit. For example, 'lb'.
      - `name` string — UI display name of the measurement unit. For example, 'Pound'.
      - `unit` MeasurementUnit — Represents a unit of measurement to use with a quantity, such as ounces or inches. Exactly one of the following fields are required: `custom_unit`, `area_unit`, `length_unit`, `volume_unit`, and `weight_unit`.
        - `area_unit` string — Represents a standard area unit.
        - `custom_unit` MeasurementUnitCustom — The information needed to define a custom unit, provided by the seller.
          - `abbreviation` string, required — The abbreviation of the custom unit, such as "bsh" (bushel). This appears in the cart for the Point of Sale app, and in reports.
          - `name` string, required — The name of the custom unit, for example "bushel".
        - `generic_unit` string — Reserved for API integrations that lack the ability to specify a real measurement unit
        - `length_unit` string — Represents a standard length unit.
        - `time_unit` string — Represents a standard unit of time.
        - `type` string — Represents the type of the measurement unit.
        - `volume_unit` string — Represents a standard volume unit.
        - `weight_unit` string — Represents a standard unit of weight or mass.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/versions/8d95e3639487/schema)