Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

All versions ->

Copy link to request setupRun requestRun
POST/v2/catalog/search

Search catalog objects

Searches for CatalogObject of any type by matching supported search attribute values, excluding custom attribute values on items or item variations, against one or more of the specified query filters. API Reference ->

Sign in
SandboxProduction

Access Tokens

Sign in to populate your access tokens from the developer dashboard Sign in

Link to section

Body

begin_time

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

Generate

cursor

string

A string that contains no characters. In an API request this value will appear as ''. Can be used to remove a field's value.

include_category_path_to_root

boolean

include_deleted_objects

boolean

include_options

Beta

include_related_objects

boolean

limit

integer(32-bit)

object_types

query

POST /v2/catalog/search

Response

// No response received yet.