# Metadata

The Metadata API provides a programmatic way to discover Zuora object metadata and schemas, so that you can retrieve, compare, and validate metadata across Zuora tenants.  It is intended for schema discovery of Zuora data domains and supports use cases such as listing available objects and retrieving the schema for a specific object. The Metadata object is in the **Early Availability** phase. We are actively soliciting feedback from a small set of early adopters before releasing it as generally available. If you are interested, please reach out to your CSM. 


## List available metadata objects

 - [GET /object-metadata](https://developer.zuora.com/v1-api-reference/api/metadata/listmetadataobjects.md): Returns all available objects for the specified metadata context.

Each object includes basic metadata such as object name, label, category,
custom field support indicator, and a link to retrieve the full object schema.

This list operation is supported only for Data Query(DQ) and Object Query(OQ) contexts.

For Data Source Export and Aggregate Query API contexts, this operation is not supported. To retrieve metadata for Data Source Export(DSE) or
Aggregate Query API(AQuA), use Retrieve metadata object schema with the required context.

## Retrieve metadata object schema

 - [GET /object-metadata/{objectName}](https://developer.zuora.com/v1-api-reference/api/metadata/retrievemetadataobjectschema.md): Returns the complete JSON Schema for the specified object.

The response includes standard JSON Schema properties and Zuora-specific
metadata extensions, including field types, constraints, relationships,
custom field indicators, and context-specific capabilities.

For Data Query(DQ) and Object Query(OQ) contexts, object name matching is case-insensitive. The
response uses the canonical object name returned by the upstream source.

For Data Source Export(DSE) or Aggregate Query API(AQuA) contexts, the response title and $id use the canonical object name returned by Billing.