MMetadata /docs
⌘K
Docs/Tools/get_abm_account_lists

get_abm_account_lists

Get account lists from the Metadata ABM Lists library.

Read audiences

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Get account lists from the Metadata ABM Lists library.
                Retrieves uploaded CSV account lists, website retargeting lists, and their metadata.

                WHEN TO USE:
                - List all available account lists with pagination and filtering
                - Search for specific account lists by filename
                - Review account list details including status, type, and account counts
                - Find lists by type (CSV, WEBSITE_RETARGETING, etc.)
                - Check list readiness and report status

                PARAMETERS:
                - filename: Filter by filename (partial matching)
                - page: Page number (default: 0)
                - size: Results per page (default: 100, max: 100)
                - sort: Sort criteria (default: "createdDate,desc")
                - status: Filter by status (READY, PROCESSING, etc.)
                - type: Filter by type (CSV, WEBSITE_RETARGETING, etc.)

                RESPONSE INCLUDES:
                - List metadata (id, name, filename, status, type)
                - Account counts and audience associations
                - Creation dates and file hashes
                - Native targeting status
                - Account report status

                EXAMPLES:
                - get_abm_account_lists() - Get all account lists
                - get_abm_account_lists(filename="test_acl.csv") - Find specific list
                - get_abm_account_lists(type="CSV") - Get only CSV lists
                - get_abm_account_lists(status="READY") - Get ready lists

Arguments

ArgumentTypeNotes
filename string Filter by account list filename (supports partial matching)
page integer Page number for pagination (0-based)
size integer Number of results per page
sort string Sort criteria (e.g., 'createdDate,desc', 'name,asc', 'accountsCount,desc')
status string Filter by status (e.g., READY, PROCESSING, ERROR)
type string Filter by list type (e.g., CSV, WEBSITE_RETARGETING)

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_abm_account_lists","arguments":{}}}'

Response

Real, from the production server, in 704 ms. The full response was 65,765 bytes; this is the first part of it. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "totalElements": "[number redacted]",
 "totalPages": "[number redacted]",
 "data": [
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": 33,
   "audiences": 0,
   "createdDate": "2026-09-05T08:58:41.000Z",
   "type": "WEBSITE_RETARGETING",
   "nativeTargeting": true,
   "csvFile": null,
   "dynamicJobId": null
  },
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": 2025,
   "audiences": 0,
   "createdDate": "2026-09-05T08:42:45.000Z",
   "type": "WEBSITE_RETARGETING",
   "nativeTargeting": true,
   "csvFile": null,
   "dynamicJobId": null
  },
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": 5,
   "audiences": 0,
   "createdDate": "2026-09-05T08:42:33.000Z",
   "type": "WEBSITE_RETARGETING",
   "nativeTargeting": true,
   "csvFile": null,
   "dynamicJobId": null
  },
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": 5,
   "audiences": 0,
   "createdDate": "2026-09-05T08:42:33.000Z",
   "type": "WEBSITE_RETARGETING",
   "nativeTargeting": true,
   "csvFile": null,
   "dynamicJobId": null
  },
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": 5,
   "audiences": 0,
   "createdDate": "2026-09-05T08:42:32.000Z",
   "type": "WEBSITE_RETARGETING",
   "nativeTargeting": true,
   "csvFile": null,
   "dynamicJobId": null
  },
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": 5,
   "audiences": 0,
   "createdDate": "2026-09-05T08:42:32.000Z",
   "type": "WEBSITE_RETARGETING",
   "nativeTargeting": true,
   "csvFile": null,
   "dynamicJobId": null
  },
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": "[number redacted]",
   "audiences": 0,
   "createdDate": "2026-09-04T20:30:51.000Z",
   "type": "WEBSITE_RETARGETING",
   "nativeTargeting": true,
   "csvFile": null,
   "dynamicJobId": null
  },
  {
   "id": "[number redacted]",
   "abmSearchCriteriaId": null,
   "accountId": "[number redacted]",
   "name": "[name redacted]",
   "filename": "[filename redacted]",
   "status": "READY",
   "accountReportStatus": null,
   "subfolder": "[subfolder redacted]",
   "sha": "[sha redacted]",
   "accountsCount": "[number redacted]",
   "audiences": 0,
   "createdDate": "2026-09-04T20:30:41.000Z",
   "type": "WEBSITE_RETARGETING"
  … truncated

Other audiences tools:

All 160 tools · machine-readable index