# List

Launch stage: Public Preview

`GET /api/2.0/lineage-tracking/external-metadata`

Gets an array of external metadata objects in the metastore.
 If the caller is the metastore admin, all external metadata objects will be retrieved.
 Otherwise, only external metadata objects that the caller has **BROWSE** on will be retrieved.
 There is no guarantee of a specific ordering of the elements in the array.

API scopes: unity-catalog

## Query parameters

- `page_size` (int32, optional)
  Specifies the maximum number of external metadata objects to return in a single response.
   The value must be less than or equal to 1000.
- `page_token` (string, optional)
  Opaque pagination token to go to next page based on previous query.

## Returns

Returns a list of ExternalMetadata objects.

## Response

```json
{
  "external_metadata": [
    {
      "columns": [
        "type",
        "message",
        "details",
        "date",
        "time"
      ],
      "create_time": 1715802661000,
      "created_by": "john.doe@company.com",
      "description": "A stream of security related events in the critical services.",
      "entity_type": "Topic",
      "id": "12345678-abcd-4ef5-9012-3456789abcdf",
      "metastore_id": "12345678-abcd-4ef5-9012-3456789abcde",
      "name": "security_events_stream",
      "owner": "data-team@company.com",
      "properties": {
        "compression.enabled": "true",
        "compression.format": "zstd",
        "topic": "prod.security.events.raw"
      },
      "system_type": "KAFKA",
      "update_time": 1715802661000,
      "updated_by": "john.doe@company.com",
      "url": "https://kafka.com/12345"
    },
    {
      "columns": [
        "customer_id",
        "age_group",
        "location",
        "segment"
      ],
      "create_time": 1715889061000,
      "created_by": "alice.johnson@company.com",
      "description": "Customer analysis report with demographics",
      "entity_type": "Report",
      "id": "87654321-dcba-4ef5-9012-3456789abcde",
      "metastore_id": "12345678-abcd-4ef5-9012-3456789abcde",
      "name": "customer_report",
      "owner": "analytics-team@company.com",
      "properties": {
        "data_source": "warehouse",
        "refresh_enabled": "false"
      },
      "system_type": "TABLEAU",
      "update_time": 1716148261000,
      "updated_by": "bob.wilson@company.com",
      "url": "https://tableau.company.com/reports/customer-analysis"
    },
    {
      "columns": [
        "product_id",
        "quantity",
        "location",
        "last_updated"
      ],
      "create_time": 1716234661000,
      "created_by": "charlie.brown@company.com",
      "description": "Inventory tracking model for warehouse management",
      "entity_type": "Model",
      "id": "abcdef12-3456-7890-abcd-ef1234567890",
      "metastore_id": "12345678-abcd-4ef5-9012-3456789abcde",
      "name": "inventory_model",
      "owner": "operations-team@company.com",
      "properties": {
        "model_type": "dimensional",
        "refresh_enabled": "true",
        "refresh_frequency": "real-time"
      },
      "system_type": "LOOKER",
      "update_time": 1716234661000,
      "updated_by": "charlie.brown@company.com",
      "url": "https://looker.company.com/models/inventory"
    }
  ],
  "next_page_token": "eyJwYWdlX251bWJlciI6Mn0="
}
```