Look up a Catalog object

If you know the unique identifier for a specific Catalog object, you can perform a GET request to view that object’s details.

NOTE
When viewing specific objects, it is still best practice to filter by properties and return only the properties you are interested in.

API format

GET /{OBJECT_TYPE}/{OBJECT_ID}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
Parameter
Description
{OBJECT_TYPE}

The type of Catalog object to be retrieved. Valid objects are:

  • batches
  • dataSets
  • dataSetFiles
{OBJECT_ID}
The identifier of the specific object you want to retrieve.

Request

The following request retrieves a dataset by its ID, returning its name, description, tags, and files properties.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a?properties=name,description,tags,files' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Response

A successful response returns the specified dataset with only the requested properties in the body.

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset",
        "description": "Sample dataset containing important data.",
        "tags": {
            "adobe/pqs/table": [
                "sample_dataset"
            ]
        },
        "files": "@/dataSetFiles?dataSetId=5ba9452f7de80400007fc52a"
    }
}
NOTE
Properties whose values are prefixed with @ represent interrelated objects. See the appendix section on viewing interrelated objects for steps on how to view the details of these objects.
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676