---
title: "List Event Definitions"
method: GET
path: "/peopleevents/2/definitions"
tags: ["customer-engagement", "people", "events"]
---

# List Event Definitions

`GET /peopleevents/2/definitions`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/peopleevents/2/definitions`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Retrieve a paginated list of event definitions, including standard, custom, and template definitions. Use query parameters to filter by category (`External`, `Person`, `Channel`, `Product`, `Template`) or search by definition ID, title, or description. Results can be ordered by definition ID or title.

## Query parameters

- `offset` integer
- `limit` integer
- `orderType` 'Asc' | 'Desc': Sort direction for results.
- `orderField` 'DefinitionId' | 'Title': Field by which results should be ordered.
- `category` Fadcd3a5e2560b383cc614bf34d902f536c2b4a12ddd61a5d337e7d4f40ab864EventDefinitionCategory[]
- `searchText` string

## Response `200`

OK

- B3ed157de85ce51bb7c17933fb84ff4b3e9bcb9fb8576a5ae189b97589d5bd1cEventDefinitionResource[]
  - `isInternalDefinition` boolean: Indicates whether this is a standard (internal) event definition provided by the system, or a custom (external) definition created by the user.
  - `category` 'external' | 'person' | 'channel' | 'product' | 'template': Event definition category.
  - `subcategory` 'sms' | 'email' | 'push' | 'whatsapp' | 'viber' | 'facebook' | 'moments' | 'forms' | 'conversations' | 'mobileapp' | 'voice' | 'line' | 'appleBC' | 'rcs' | 'mms' | 'viberBot' | 'inapp' | 'answers' | 'blocklist': Event definition subcategory.
  - `definitionId` string, nullable: Event definition identifier.
  - `title` string, nullable: Event definition title.
  - `description` string, nullable: Event definition description.
  - `fields` B3ed157de85ce51bb7c17933fb84ff4b3e9bcb9fb8576a5ae189b97589d5bd1cEventFieldResource[], nullable: Event definition fields describing the structure and data types of the event properties.
    - `name` string, required: Field name. Must not exceed `128` characters. Must start with a lowercase letter `(a–z)` and can contain alphanumeric characters `(A–Z, a–z, 0–9)` and underscores `(_)`.
    - `type` 'String' | 'Boolean' | 'DateTime' | 'Numeric' | 'Decimal' | 'List', required: Field data type.
    - `schema` B3ed157de85ce51bb7c17933fb84ff4b3e9bcb9fb8576a5ae189b97589d5bd1cListItemResource
      - `type` 'Object', required: Schema type for List items.
      - `fields` B3ed157de85ce51bb7c17933fb84ff4b3e9bcb9fb8576a5ae189b97589d5bd1cListItemFieldResource[], required: Fields within the List item object. Must not be empty, must contain no more than `128` items, field names must be unique (case-insensitive).
        - `name` string, required: Field name within a List item. Must not exceed `128` characters. Must start with a lowercase letter `(a–z)` and can contain alphanumeric characters `(A–Z, a–z, 0–9)` and underscores `(_)`.
        - `type` 'String' | 'Boolean' | 'DateTime' | 'Numeric' | 'Decimal', required: Field data type within a List item.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: No matches
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)