Catalog
The Catalog API provides read-only access to Hall Leonard’s complete digital asset catalog. Use it to discover available assets, explore rich metadata, and build catalog browsing or search experiences in your application.
The catalog is optimized for incremental loading and large datasets, making it suitable for storefronts, back-office tools, and automated ingestion pipelines.
What you can do
With the Catalog API you can:
- Retrieve a paginated list of digital assets
- Access complete asset metadata in a single response
- Incrementally load large catalogs using cursor-based pagination
- Build deterministic, cache-friendly catalog syncs
Asset metadata
Each asset contains rich, structured metadata, including:
- Asset identifiers and basic descriptive fields
- Available formats and delivery options
- Pricing information
- Contributors and rights holders
- Categories and instruments
- Related media and additional attributes
All fields are returned in a consistent schema, allowing you to map catalog data directly into your internal models.
Typical use cases
- Building a product catalog or storefront
- Syncing assets into a local database
Environment-specific catalog
The catalog is environment-aware.
When a request is executed in a specific environment, the API returns only the assets available in that environment.
- Sandbox requests return a limited subset of assets enabled for testing
- Live requests return the full production catalog
This allows you to safely develop and test integrations without exposing or relying on production-only assets.
The environment is determined by the access token used for the request and is reflected
in the X-Environment response header.