Skip to content
Ads API •References / measurement-datasets / Get Datasets for Ad Account

Get Datasets for Ad Account

Get all Datasets delegated to an Ad Account

Request

  • business_id
    string [uuid]
    Required

    A unique identifier for the entity.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • ad_account_id
    string [uuid]
    Required

    A unique identifier for an Ad Account.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a

Response

Datasets response.

    • page_size
      integer [int32]
    • total_results
      integer [int32]
    • offset
      integer [int32]
    • current_page
      integer [int32]
    • id
      string [uuid]
      Read only

      A unique identifier for the dataset.

      Supported content-type(s): Example: "0d86b9e9-70f0-4700-a725-3417ba8786f6"
    • name
      string

      The name of the dataset.

      Example: "US Advertising"
      • id
        string
        Read only

        A unique identifier for a pixel.

        Supported content-type(s): Example: "cd2f1480ba3d4f9b9c5a39893c0def91"
      • integration_id
        string [uuid]
        Read only

        A unique identifier for the integration.

        Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
      • domain
        string [uri]

        The URL you would like to track

        Example: "https://www.spotify.com"
      • name
        string

        The name of the pixel.

        Example: "Spotify"
      • created_at
        string [date-time]
        Read only

        Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

        Supported content-type(s): Example: "2026-01-23T04:56:07Z"
      • Read only
        • id
          string
          Read only

          A unique identifier for an event.

          Supported content-type(s): Example: "23815327f0c64cf9811516c53c465f37"
        • type
          string

          The type of event.

          Allowed values: "PAGE_VIEW", "LEAD", "PURCHASE", "ADD_TO_CART"Example: "LEAD"
        • created_at
          string [date-time]
          Read only

          Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

          Supported content-type(s): Example: "2026-01-23T04:56:07Z"
        • last_activity_at
          string [date-time]
          Read only

          Date the event was last used. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

          Example: "2021-01-23T04:56:07Z"
      • Read only
        • type
          string

          The type of event.

          Allowed values: "PAGE_VIEW", "LEAD", "PURCHASE", "ADD_TO_CART"Example: "LEAD"
        • hour_partition
          string [date-time]
          Read only

          The hour the event counts pertain to, in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

          Example: "2023-08-02T10:00:00Z"
        • count
          integer
          Read only

          Count of historical events, aggregated for the hour.

          Example: 42
      • dataset_id
        string [uuid]

        A unique identifier for the dataset.

        Example: "0d86b9e9-70f0-4700-a725-3417ba8786f6"
      • capi_connection_id
        string [uuid]
        Read only

        A unique identifier for the CAPI integration.

        Supported content-type(s): Example: "2fd920ed-a111-43d4-bee2-74d078c479a5"
      • integration_id
        string [uuid]
        Read only

        A unique identifier for the integration.

        Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
      • name
        string

        The name of the CAPI integration.

        Example: "Retail Sales"
      • dataset_id
        string [uuid]

        A unique identifier for the dataset.

        Example: "0d86b9e9-70f0-4700-a725-3417ba8786f6"
    • ad_set_count
      integer

      The number of active or scheduled ad sets using the dataset.

      Example: 0
    • is_archived
      boolean

      Whether the dataset has been archived.

      Default: false
    • is_receiving_events
      boolean

      Whether any integrations in the dataset are currently sending events.

      Default: false

    • An ad account a dataset has been shared to.

      • id
        string [uuid]

        A unique identifier for an Ad Account.

        Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
      • name
        string

        Name of the Ad Account.

        Example: "Spotify"

Response sample

{  "paging": {    "page_size": 0,    "total_results": 0,    "offset": 0,    "current_page": 0  },  "datasets": [    {      "id": "0d86b9e9-70f0-4700-a725-3417ba8786f6",      "name": "US Advertising",      "pixel": {        "id": "cd2f1480ba3d4f9b9c5a39893c0def91",        "integration_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",        "domain": "https://www.spotify.com",        "name": "Spotify",        "created_at": "2026-01-23T04:56:07Z",        "events": [          {            "id": "23815327f0c64cf9811516c53c465f37",            "type": "LEAD",            "created_at": "2026-01-23T04:56:07Z",            "last_activity_at": "2021-01-23T04:56:07Z"          }        ],        "historical_events": [          {            "type": "LEAD",            "hour_partition": "2023-08-02T10:00:00Z",            "count": 42          }        ],        "dataset_id": "0d86b9e9-70f0-4700-a725-3417ba8786f6"      },      "capi_integration": {        "capi_connection_id": "2fd920ed-a111-43d4-bee2-74d078c479a5",        "integration_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",        "name": "Retail Sales",        "dataset_id": "0d86b9e9-70f0-4700-a725-3417ba8786f6"      },      "ad_set_count": 0,      "is_archived": false,      "is_receiving_events": false,      "shared_ad_accounts": [        {          "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a",          "name": "Spotify"        }      ]    }  ]}