Channel99

Channel99 Pulsar Reporting API

Channel99's Bulk Data Transfer REST API. Seventeen operations giving programmatic access to the account-resolved marketing facts behind the platform - website visits, pageviews, ad impressions and buyer-intent signals - plus the ad, audience, company, channel and vendor dimensions needed to join them, and a separately-permissioned IP-to-company resolution route. Authentication is an M2M client_credentials exchange returning a one-hour Stytch-issued JWT that must be paired with a matching x-client-id header. Lists are cursor-paginated (limit default 200, maximum 1000) with a deepObject filter[field][op] syntax and single-field sort.

GitHub OpenAPI

Documentation

📖
Documentation
https://support.channel99.com/hc/en-us/articles/49766041989787-Channel99-Reporting-API-Developer-Guide
📖
APIReference
https://pulsar.channel99.com/docs/#/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/authentication/channel99-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/rate-limits/channel99-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/openapi/channel99-pulsar-openapi.json

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/overlays/channel99-pulsar-overlay.yaml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/conventions/channel99-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/data-model/channel99-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/errors/channel99-problem-types.yml
🔗
AgentSkill
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/skills/_index.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/apis.yml

OpenAPI Specification

channel99-pulsar-openapi.json Raw ↑ 
{
  "openapi": "3.0.3",
  "info": {
    "title": "Pulsar API",
    "description": "Channel99 Bulk Data Transfer REST API",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "/"
    }
  ],
  "tags": [
    {
      "name": "Auth",
      "description": "Token issuance \u2014 `POST /auth/token`"
    },
    {
      "name": "Health",
      "description": "Service health check"
    },
    {
      "name": "Impressions",
      "description": "Ad impression events \u2014 `GET /events/impressions`"
    },
    {
      "name": "Intents",
      "description": "Buyer intent signal events \u2014 `GET /events/intents`"
    },
    {
      "name": "Pageviews",
      "description": "Website pageview events \u2014 `GET /events/pageviews`"
    },
    {
      "name": "Visits",
      "description": "Website visit events \u2014 `GET /events/visits`"
    },
    {
      "name": "Ad Accounts",
      "description": "Ad account dimension records \u2014 `GET /dimensions/ad-accounts`"
    },
    {
      "name": "Ad Campaign Groups",
      "description": "Ad campaign group dimension records \u2014 `GET /dimensions/ad-campaign-groups`"
    },
    {
      "name": "Ad Campaigns",
      "description": "Ad campaign dimension records \u2014 `GET /dimensions/ad-campaigns`"
    },
    {
      "name": "Ad Groups",
      "description": "Ad group dimension records \u2014 `GET /dimensions/ad-groups`"
    },
    {
      "name": "Ad Units",
      "description": "Ad unit dimension records \u2014 `GET /dimensions/ad-units`"
    },
    {
      "name": "Ads",
      "description": "Ad dimension records \u2014 `GET /dimensions/ads`"
    },
    {
      "name": "Audiences",
      "description": "Audience dimension records \u2014 `GET /dimensions/audiences`"
    },
    {
      "name": "Channels",
      "description": "Channel dimension records \u2014 `GET /dimensions/channels`"
    },
    {
      "name": "Companies",
      "description": "Company dimension records \u2014 `GET /dimensions/companies`"
    },
    {
      "name": "Vendors",
      "description": "Vendor dimension records \u2014 `GET /dimensions/vendors`"
    },
    {
      "name": "IP Lookup",
      "description": "Company information lookup by IP address \u2014 `GET /ip/{ipAddress}`"
    }
  ],
  "paths": {
    "/auth/token": {
      "post": {
        "tags": [
          "Auth"
        ],
        "summary": "Issue access token",
        "description": "Exchange an M2M client ID and secret for a bearer access token. This endpoint does not require authentication.",
        "operationId": "postAuthToken",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "client_id",
                  "client_secret"
                ],
                "properties": {
                  "client_id": {
                    "type": "string",
                    "description": "The M2M client identifier",
                    "example": "m2m-client-00000000-0000-0000-0000-000000000000"
                  },
                  "client_secret": {
                    "type": "string",
                    "description": "The M2M client secret",
                    "example": "\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Access token issued successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "access_token",
                    "token_type",
                    "expires_in"
                  ],
                  "properties": {
                    "access_token": {
                      "type": "string",
                      "description": "Bearer token to use in subsequent requests"
                    },
                    "token_type": {
                      "type": "string",
                      "enum": [
                        "bearer"
                      ]
                    },
                    "expires_in": {
                      "type": "integer",
                      "description": "Token lifetime in seconds",
                      "example": 3600
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          }
        }
      }
    },
    "/health": {
      "get": {
        "tags": [
          "Health"
        ],
        "summary": "Health check",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Service is healthy",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "ok"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          }
        }
      }
    },
    "/events/impressions": {
      "get": {
        "tags": [
          "Impressions"
        ],
        "summary": "List impressions",
        "operationId": "getImpressions",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/cursor"
          },
          {
            "$ref": "#/components/parameters/listLimit"
          },
          {
            "$ref": "#/components/parameters/filterImpressions"
          },
          {
            "$ref": "#/components/parameters/sortImpressions"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of impression records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedImpressions"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance, invalid cursor, invalid filter, invalid sort, or invalid limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/events/intents": {
      "get": {
        "tags": [
          "Intents"
        ],
        "summary": "List intents",
        "operationId": "getIntents",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/cursor"
          },
          {
            "$ref": "#/components/parameters/listLimit"
          },
          {
            "$ref": "#/components/parameters/filterIntents"
          },
          {
            "$ref": "#/components/parameters/sortIntents"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of intent records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedIntents"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance, invalid cursor, invalid filter, invalid sort, or invalid limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/events/pageviews": {
      "get": {
        "tags": [
          "Pageviews"
        ],
        "summary": "List pageviews",
        "operationId": "getPageviews",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/cursor"
          },
          {
            "$ref": "#/components/parameters/listLimit"
          },
          {
            "$ref": "#/components/parameters/filterPageviews"
          },
          {
            "$ref": "#/components/parameters/sortPageviews"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of pageview records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedPageviews"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance, invalid cursor, invalid filter, invalid sort, or invalid limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/events/visits": {
      "get": {
        "tags": [
          "Visits"
        ],
        "summary": "List visits",
        "operationId": "getVisits",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/cursor"
          },
          {
            "$ref": "#/components/parameters/listLimit"
          },
          {
            "$ref": "#/components/parameters/filterVisits"
          },
          {
            "$ref": "#/components/parameters/sortVisits"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of visit records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedVisits"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance, invalid cursor, invalid filter, invalid sort, or invalid limit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/dimensions/ad-accounts": {
      "get": {
        "tags": [
          "Ad Accounts"
        ],
        "summary": "List ad accounts",
        "operationId": "getAdAccounts",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/filterAdAccounts"
          }
        ],
        "responses": {
          "200": {
            "description": "All ad account records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdAccountList"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance or invalid filter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/dimensions/ad-campaign-groups": {
      "get": {
        "tags": [
          "Ad Campaign Groups"
        ],
        "summary": "List ad campaign groups",
        "operationId": "getAdCampaignGroups",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/filterAdCampaignGroups"
          }
        ],
        "responses": {
          "200": {
            "description": "All ad campaign group records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdCampaignGroupList"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance or invalid filter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/dimensions/ad-campaigns": {
      "get": {
        "tags": [
          "Ad Campaigns"
        ],
        "summary": "List ad campaigns",
        "operationId": "getAdCampaigns",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/filterAdCampaigns"
          }
        ],
        "responses": {
          "200": {
            "description": "All ad campaign records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdCampaignList"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance or invalid filter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/dimensions/ad-groups": {
      "get": {
        "tags": [
          "Ad Groups"
        ],
        "summary": "List ad groups",
        "operationId": "getAdGroups",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/filterAdGroups"
          }
        ],
        "responses": {
          "200": {
            "description": "All ad group records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdGroupList"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance or invalid filter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/dimensions/ad-units": {
      "get": {
        "tags": [
          "Ad Units"
        ],
        "summary": "List ad units",
        "operationId": "getAdUnits",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/filterAdUnits"
          }
        ],
        "responses": {
          "200": {
            "description": "All ad unit records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdUnitList"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance or invalid filter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/dimensions/ads": {
      "get": {
        "tags": [
          "Ads"
        ],
        "summary": "List ads",
        "operationId": "getAds",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/filterAds"
          }
        ],
        "responses": {
          "200": {
            "description": "All ad records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdList"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance or invalid filter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden \u2013 invalid token or client mismatch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/dimensions/audiences": {
      "get": {
        "tags": [
          "Audiences"
        ],
        "summary": "List audiences",
        "operationId": "getAudiences",
        "security": [
          {
            "bearerAuth": [],
            "clientId": []
          }
        ],
        "parameters": [
          {
            "name": "x-client-id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Client identifier matching the authenticated token",
            "example": "m2m-client-00000000-0000-0000-0000-000000000000"
          },
          {
            "$ref": "#/components/parameters/filterAudiences"
          }
        ],
        "responses": {
          "200": {
            "description": "All audience records",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AudienceList"
                }
              }
            }
          },
          "400": {
            "description": "Bad request \u2013 missing instance or invalid filter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized \u2013 missing or malformed credentials",
            "content": {
              "application/

# --- truncated at 32 KB (78 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/channel99/refs/heads/main/openapi/channel99-pulsar-openapi.json