---
updatedAt: 2026-05-04T14:58:04.000Z
agentTools:
  projectIndex: https://developers.eventtemple.com/llms.txt
---

# List all events

Returns a list of events

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "version": "2.0.0",
    "title": "Event Temple API",
    "description": "The Event Temple API provides programmatic access to the core features of the Event Temple platform, enabling developers to integrate and extend its functionality. With this API, you can manage accounts, contacts, bookings, events, and more.\n",
    "contact": {
      "name": "API Support",
      "url": "https://developers.eventtemple.com",
      "email": "developers@eventtemple.com"
    }
  },
  "servers": [
    {
      "url": "https://api.eventtemple.com/v2"
    }
  ],
  "security": [
    {
      "OAuth2": [],
      "ApiOrg": []
    },
    {
      "ApiKey": [],
      "ApiOrg": []
    }
  ],
  "tags": [
    {
      "name": "events"
    }
  ],
  "paths": {
    "/events": {
      "get": {
        "summary": "List all events",
        "operationId": "listEvents",
        "description": "Returns a list of events",
        "tags": [
          "events"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/page_size"
          },
          {
            "$ref": "#/components/parameters/page_after"
          },
          {
            "$ref": "#/components/parameters/page_before"
          },
          {
            "name": "include",
            "in": "query",
            "description": "Comma separated list of related resources for inclusion",
            "schema": {
              "type": "string",
              "enum": [
                "booking",
                "space",
                "event_type",
                "setup_style",
                "revenue_summaries",
                "organization"
              ]
            }
          },
          {
            "name": "filter[updated_at][gt]",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "2020-01-01T00:00:00Z",
              "description": "Supported fields and predicates:\n\n| Field        | Supported Predicates                           |\n| ------------ | ---------------------------------------------- |\n| `id`         | `eq` `in` `not_in` `null` `not_null`           |\n| `status`     | `eq` `in` `not_in`                             |\n| `start_date` | `eq` `gt` `gteq` `lt` `lteq` `null` `not_null` `in` |\n| `end_date`   | `eq` `gt` `gteq` `lt` `lteq` `null` `not_null` `in` |\n| `booking_id` | `eq` `in` `not_in` `null` `not_null`           |\n| `space_id`   | `eq` `in` `not_in` `null` `not_null`           |\n| `created_at` | `eq` `gt` `gteq` `lt` `lteq` `null` `not_null` `in` |\n| `updated_at` | `eq` `gt` `gteq` `lt` `lteq` `null` `not_null` `in` |"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A paged array of events",
            "content": {
              "application/vnd.api+json": {
                "schema": {
                  "$ref": "#/components/schemas/EventListResponse"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequestError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      },
      "ApiOrg": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-ORG"
      },
      "OAuth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://client.eventtemple.com/oauth/authorize",
            "tokenUrl": "https://api.eventtemple.com/oauth/token",
            "scopes": {
              "crm_read": "Grants read access",
              "crm_manage": "Grants manage access",
              "settings_manage": "Grants access to admin operations"
            }
          }
        }
      }
    },
    "schemas": {
      "CustomValue": {
        "description": "Array of custom values associated with a resource",
        "items": {
          "allOf": [
            {
              "type": "object",
              "properties": {
                "field_id": {
                  "type": "string",
                  "example": "f7ac09f8bec5340fb8be40dd2148353e",
                  "description": "Unique identifier of the Custom Field"
                },
                "type": {
                  "type": "string",
                  "example": "text",
                  "description": "Data type of the custom value. For 'user' and 'contact' types, the value references the Users or Contacts respectively"
                },
                "value": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "example": "Grand opening",
                  "description": "Value stored in the Custom Field. For 'user' and 'contact' types, this is the full user/contact object"
                },
                "label": {
                  "type": "string",
                  "example": "Comments",
                  "description": "Display label of the Custom Field"
                },
                "flat_label": {
                  "type": "string",
                  "example": "Comments",
                  "description": "Simplified version of the label used in certain contexts"
                }
              }
            }
          ]
        }
      },
      "SingleObject": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string"
              }
            }
          }
        }
      },
      "Included": {
        "type": "array",
        "items": {
          "type": "object",
          "description": "List of included objects"
        }
      },
      "Meta": {
        "type": "object",
        "properties": {
          "after_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "The cursor to use for pagination to get the next page of results",
            "example": "Y3Vyc29yOjE4"
          },
          "before_cursor": {
            "type": [
              "string",
              "null"
            ],
            "description": "The cursor to use for pagination to get the previous page of results",
            "example": "Y3Vyc29yOjE3"
          },
          "has_more": {
            "type": "boolean",
            "description": "Whether there are more results to fetch",
            "example": true
          }
        }
      },
      "ArrayObject": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "BaseEventProperties": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number",
            "example": 123456789,
            "readOnly": true,
            "description": "Unique identifier of the Event"
          },
          "external_id": {
            "type": [
              "string",
              "null"
            ],
            "example": "123456789",
            "description": "External identifier used for integration with external systems"
          },
          "created_at": {
            "type": "string",
            "readOnly": true,
            "format": "date-time",
            "example": "2019-01-01T00:00:00.000Z",
            "description": "Timestamp when the Event was created"
          },
          "updated_at": {
            "type": "string",
            "readOnly": true,
            "format": "date-time",
            "example": "2019-01-01T00:00:00.000Z",
            "description": "Timestamp when the Event was last updated"
          },
          "name": {
            "type": "string",
            "example": "Wedding Reception",
            "description": "Name or title of the Event"
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "example": "2023-01-01",
            "description": "Start date of the Event"
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "example": "2023-12-01",
            "description": "End date of the Event"
          },
          "start_time": {
            "type": [
              "integer",
              "null"
            ],
            "example": 3600,
            "description": "Start time of the Event in seconds since start of the day"
          },
          "end_time": {
            "type": "integer",
            "example": 5000,
            "description": "End time of the Event in seconds since start of the day"
          },
          "notes": {
            "type": [
              "string",
              "null"
            ],
            "example": "Wedding photos on beach",
            "description": "Additional notes or details about the Event"
          },
          "expected": {
            "type": "integer",
            "example": 50,
            "description": "Expected number of attendees for the Event"
          },
          "guaranteed": {
            "type": "integer",
            "example": 25,
            "description": "Guaranteed minimum number of attendees for the Event"
          },
          "actual": {
            "type": "integer",
            "example": 20,
            "description": "Actual number of attendees for the Event"
          },
          "set": {
            "type": "integer",
            "example": 10,
            "description": "Number of tables or sets required for the Event"
          },
          "discount": {
            "type": "string",
            "format": "decimal",
            "example": "50.00",
            "description": "Discount amount applied to the Event"
          },
          "amount_paid": {
            "type": "string",
            "format": "decimal",
            "example": "100.00",
            "description": "Total amount paid for the Event"
          },
          "all_day": {
            "type": "boolean",
            "example": true,
            "readOnly": true,
            "description": "Whether the Event spans the entire day"
          },
          "status": {
            "type": "string",
            "enum": [
              "lead",
              "tentative",
              "definite",
              "lost"
            ],
            "description": "Current status of the Event"
          },
          "status_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Date when the current status was set"
          },
          "organization_id": {
            "type": "integer",
            "example": 123456789,
            "readOnly": true,
            "description": "Unique identifier of the Organization this Event belongs to"
          },
          "space_id": {
            "type": "integer",
            "example": 123456789,
            "description": "Unique identifier of the Space where the Event will take place"
          },
          "booking_id": {
            "type": "integer",
            "example": 123456789,
            "description": "Unique identifier of the Booking this Event is associated with"
          },
          "event_type_id": {
            "type": "integer",
            "example": 123456789,
            "description": "Unique identifier of the Event Type classification"
          },
          "setup_style_id": {
            "type": "integer",
            "example": 123456789,
            "description": "Unique identifier of the Setup Style for the Event"
          }
        }
      },
      "Event": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseEventProperties"
          },
          {
            "type": "object",
            "properties": {
              "custom_fields": {
                "$ref": "#/components/schemas/CustomValue"
              }
            }
          }
        ]
      },
      "EventResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "events"
            ]
          },
          "attributes": {
            "$ref": "#/components/schemas/Event"
          },
          "relationships": {
            "type": "object",
            "properties": {
              "space": {
                "$ref": "#/components/schemas/SingleObject"
              },
              "booking": {
                "$ref": "#/components/schemas/SingleObject"
              },
              "event_type": {
                "$ref": "#/components/schemas/SingleObject"
              },
              "setup_style": {
                "$ref": "#/components/schemas/SingleObject"
              },
              "revenue_summaries": {
                "$ref": "#/components/schemas/ArrayObject"
              },
              "organization": {
                "$ref": "#/components/schemas/SingleObject"
              }
            }
          }
        }
      },
      "EventListResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EventResponse"
            }
          },
          "included": {
            "$ref": "#/components/schemas/Included"
          },
          "meta": {
            "$ref": "#/components/schemas/Meta"
          }
        }
      }
    },
    "parameters": {
      "page_size": {
        "name": "page[size]",
        "in": "query",
        "description": "Number of records per page",
        "required": false,
        "schema": {
          "type": "integer",
          "example": 50
        }
      },
      "page_after": {
        "name": "page[after]",
        "in": "query",
        "description": "To get records after a specific cursor",
        "required": false,
        "schema": {
          "type": "string",
          "example": "Y3Vyc29yOjEwODg="
        }
      },
      "page_before": {
        "name": "page[before]",
        "in": "query",
        "description": "To get records before a specific cursor",
        "required": false,
        "schema": {
          "type": "string",
          "example": "Y3Vyc29yOjEwODg="
        }
      }
    },
    "responses": {
      "BadRequestError": {
        "description": "Bad Request",
        "content": {
          "application/vnd.api+json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "invalid_request"
                    },
                    "message": {
                      "type": "string",
                      "example": "The request is invalid or missing required fields"
                    }
                  },
                  "example": {
                    "code": "invalid_request",
                    "message": "The request is invalid or missing required fields"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```