Get lead filter metadata

Return filterable lead fields plus research tables/columns available for descriptors.

GET/api/leads/filters/metadata

HTTP referenceScope leads:readUpdated March 6, 2026

This page documents the canonical HTTP contract for this endpoint.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing leads:read scope.

Example

bash

curl -X GET "https://app.autotouch.ai/api/leads/filters/metadata" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
    "fields": [
      {
        "field": "lead_status",
        "operators": ["eq", "neq", "in", "nin"],
        "description": "Lead status"
      }
    ],
    "research_tables": [
      {
        "id": "tbl_123",
        "name": "ICP Prospects",
        "columns": [
          {
            "id": "col_456",
            "key": "pain_point",
            "name": "Pain Point",
            "operators": ["eq", "neq", "in", "nin", "contains", "starts_with", "ends_with", "is_empty", "is_not_empty"]
          }
        ]
      }
    ]
  }