Get reachable audience count

Count confirmed and sendable subscribers on an owned list, applying workspace suppression. Imported contacts never become sponsor leads through this operation.

GET/api/v1/audience/lists/{listId}/count

Authentication

Send your workspace key as xi-api-key or Authorization: Bearer.

audience:readread

Parameters

Named placeholders belong in the path. Other arguments use query parameters.

listIdRequired: integerRange: any to 2147483647

Response

JSON response with status 200.

Requests and errors →

Illustrative arguments

{
  "listId": 1
}

Input schema

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 2147483647
    }
  },
  "required": [
    "listId"
  ],
  "additionalProperties": false
}

Response schema

{
  "type": "object",
  "properties": {
    "confirmedReachable": {
      "type": "number"
    },
    "sendable": {
      "type": "number"
    }
  },
  "required": [
    "confirmedReachable",
    "sendable"
  ],
  "additionalProperties": false
}