{
  "kind": "api_reference",
  "api": "Google Analytics Admin API (v1beta)",
  "method": "GET",
  "endpoint": "https://analyticsadmin.googleapis.com/v1beta/{parent=properties/*}/keyEvents",
  "scopes": [
    "https://www.googleapis.com/auth/analytics.readonly",
    "https://www.googleapis.com/auth/analytics.edit"
  ],
  "query_parameters": {
    "pageSize": "optional; default 50; maximum 200; higher values coerced to 200",
    "pageToken": "optional; a token from a previous keyEvents.list call"
  },
  "response": {
    "keyEvents": "list of KeyEvent objects",
    "nextPageToken": "present only when more pages exist"
  },
  "guide": "list-key-events-with-admin-api",
  "title": "List your key events with the Admin API: the inventory check, and the slots you have left",
  "worked_example": {
    "key_events": [
      {
        "event_name": "purchase",
        "custom": false,
        "counting_method": "ONCE_PER_EVENT",
        "default_value": null
      },
      {
        "event_name": "generate_lead",
        "custom": true,
        "counting_method": "ONCE_PER_SESSION",
        "default_value": "25.00 CAD"
      },
      {
        "event_name": "sign_up",
        "custom": true,
        "counting_method": "ONCE_PER_EVENT",
        "default_value": null
      },
      {
        "event_name": "form_submit",
        "custom": true,
        "counting_method": "ONCE_PER_EVENT",
        "default_value": null
      },
      {
        "event_name": "download_whitepaper",
        "custom": true,
        "counting_method": "ONCE_PER_SESSION",
        "default_value": null
      },
      {
        "event_name": "book_demo",
        "custom": true,
        "counting_method": "ONCE_PER_SESSION",
        "default_value": "50.00 CAD"
      },
      {
        "event_name": "newsletter_signup",
        "custom": true,
        "counting_method": "ONCE_PER_EVENT",
        "default_value": null
      },
      {
        "event_name": "phone_click",
        "custom": true,
        "counting_method": "ONCE_PER_EVENT",
        "default_value": null
      }
    ],
    "total_key_events": 8,
    "custom_key_events": 7,
    "default_key_events": 1,
    "custom_key_event_ceiling": 30,
    "custom_slots_left": 23,
    "default_page_size": 50,
    "pages_needed": 1,
    "next_page_token": null
  },
  "verification": "Figures recomputed in Python 3 with decimal arithmetic, 2026-11-11. No live GA4 run."
}
