The definitive source for the current schema is the /v1/meta endpoint. Always use schema discovery to:
- Get the latest schema - New measures and dimensions are added over time
- Validate your queries - Ensure measures and dimensions exist before querying
- Discover data freshness - Check refresh intervals for each cube
- Find available segments - Use predefined filters for common scenarios
For a complete guide to metadata structure, parsing, and caching strategies, see Metadata Discovery.
curl -X GET "https://connect.squareup.com/reporting/v1/meta" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" | jq '.cubes[] | {name, type}'
curl -X GET "https://connect.squareup.com/reporting/v1/meta" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" | \ jq '.cubes[] | select(.name == "Orders")'
curl -X GET "https://connect.squareup.com/reporting/v1/meta" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" | \ jq '.cubes[] | select(.name == "Orders") | .measures[] | {name, title, aggType, description}'
curl -X GET "https://connect.squareup.com/reporting/v1/meta" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" | \ jq '.cubes[] | select(.name == "Orders") | .segments[] | {name, title, description}'
For interactive browsing and exploration, use the Schema Explorer.