---
cuppy_hub: salesforce
cuppy_path: reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-metadata-api.md
cuppy_section: docs
cuppy_doc: SG01-HC5Q
cuppy_doc_uuid: 600a60cf-37cd-44c7-a150-f30b537654e7
cuppy_permalink: https://cuppy.io/salesforce/d/SG01-HC5Q
cuppy_version: 1
cuppy_updated: 2026-10-23T16:16:52.575Z
cuppy_canonical: https://cuppy.io/salesforce/docs/reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-metadata-api
cuppy_mcp: https://cuppy.io/mcp
cuppy_body_sha256: 82106f896f70b04f07b5db713b08c399ec1259aac3c18f9896b32554a8f6ad6c
# cuppy_body_sha256 is over the document body ALONE, excluding both generated blocks.
---

> Mirror of <https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-metadata-api.html> (Salesforce, Data 360 Query Guide), read 2026-10-23. Salesforce's own page is the authority; this copy exists because that site refuses non-browser readers.

Retrieves metadata about all entities, including Calculated Insights, Engagement, Profile, and other entities, and their relationships to other objects. For Data Lake Objects and Data Model Objects, the API response includes information about key qualifier fields. For each field, the API response includes the name of the associated key qualifier field.

*   **HTTP Method**: GET
*   **Availability**: Data 360 v1.0, Salesforce API version 51.0 and later
*   **Format**: REST
*   **URI**: `/api/v1/metadata/`

| Parameter | Type | Description |
| --- | --- | --- |
| entityType | string | The requested metadata entity type. By default, this parameter includes all of the available types. Acceptable values: DataLakeObject, DataModelObject, and CalculatedInsight |
| entityCategory | string | The requested metadata entity category. By default, this parameter includes all of the available categories. It isn’t applicable for Calculated Insight entities. Acceptable values: Profile, Engagement, and Related |
| entityName | string | The name of the requested metadata entity. By default, this parameter includes all of the available categories and an exhaustive list of entities. Example: UnifiedIndividual__dlm |

The response includes:

*   `metadata`: Array of entity objects containing: 
    *   `fields`: Array of field objects with: 
        *   `name`: Field name
        *   `displayName`: Human-readable field name
        *   `type`: Field data type
        *   `keyQualifier`: Associated key qualifier field (if applicable)

    *   `indexes`: Array of index objects
    *   `category`: Entity category
    *   `name`: Entity name
    *   `displayName`: Human-readable entity name
    *   `relationships`: Array of relationship objects
    *   `primaryKeys`: Array of primary key objects

*   The API follows REST standards for consistency
*   All responses are in JSON format
*   Error responses include detailed error messages
*   The API supports filtering by entity type, category, and name
*   Key qualifier fields are included for Data Lake Objects and Data Model Objects


---
<!-- cuppy -->
You are reading one file. The same content is free over MCP at https://cuppy.io/mcp with no signup: ranked search across all 376 documents in this hub, the merged view when you work in a layer, known workarounds matched to the error you hit, and depth control so you spend tokens on what you need. Start with the `_hello` tool. How to connect: https://cuppy.io/salesforce/ Something wrong in this document? Report it with the `session feedback` tool on the same endpoint.
<!-- /cuppy -->