> ## Documentation Index > Fetch the complete documentation index at: https://api-docs-dev.iclosed.io/llms.txt > Use this file to discover all available pages before exploring further. # Get Events > List events for the authenticated account ## OpenAPI ````yaml GET /v1/events openapi: 3.0.0 info: title: iClosed.io V1 API description: >- V1 Public API with organization-based rate limiting. All requests require X-Org-Id header from API Gateway authorizer. This spec is generated from v1 module schemas (Zod). version: 1.0.0 contact: name: iClosed.io Support url: https://app.iclosed.io/support license: name: Proprietary url: https://app.iclosed.io/terms servers: - url: http://localhost:4000 description: local - url: https://public.api.iclosed.io description: V1 APIs (public) - url: https://api-dev.iclosed.io description: Development - url: https://api.iclosed.io description: Production security: - bearerAuth: [] tags: - name: Contacts description: Contact management - name: Deals description: Deal management - name: Events description: Event dates and time slots - name: Products description: Product listing - name: Outcomes description: Call outcomes paths: /v1/events: get: tags: - Events summary: Get Events description: >- List events for the authenticated account, or get a single event by id/token. Query: limit, page, id, token, search, userId, teamId, and other optional filters. operationId: getEvents parameters: - name: limit in: query schema: default: 10 type: integer minimum: 1 maximum: 500 - name: page in: query schema: type: integer minimum: 0 - name: search in: query schema: type: string - name: userId in: query schema: type: integer exclusiveMinimum: true - name: eventType in: query schema: type: string enum: - STRATEGY_EVENT - DISCOVERY_EVENT responses: '200': description: List of events or single event content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: number name: nullable: true type: string color: nullable: true type: string eventType: nullable: true type: string description: nullable: true type: string internalDescription: nullable: true type: string deletedAt: nullable: true anyOf: - type: string format: date-time - type: string type: object language: nullable: true type: string emailValidationEnabled: nullable: true type: boolean phoneNumberValidationEnabled: nullable: true type: boolean creditCheck: nullable: true type: object properties: type: nullable: true type: object toggle: type: boolean additionalProperties: false userId: nullable: true type: number duration: nullable: true type: number durationUnit: nullable: true type: string location: nullable: true type: string dateRangeType: nullable: true type: string dateRangeUnit: nullable: true type: string linkPrefix: nullable: true type: string status: nullable: true type: string allowReschedule: nullable: true type: boolean phonePreferred: nullable: true type: boolean splitFullName: nullable: true type: boolean businessEmail: nullable: true type: boolean disableDuplicateBooking: nullable: true type: boolean lockHostOnReschedule: nullable: true type: boolean dateRangeDays: nullable: true type: number bypassQuestion: nullable: true type: boolean required: - id additionalProperties: false count: type: number totalCount: type: number hasVisibleEvents: type: boolean additionalProperties: false '400': description: >- Bad request or validation failed (V1 Zod: message.details.fieldErrors/formErrors; or express-validator: message + errors array/object) content: application/json: schema: anyOf: - type: object properties: message: type: string description: Always "Invalid request" when errors is an array errors: type: array items: type: string description: List of validation error messages required: - message - errors additionalProperties: false - type: object properties: message: type: string description: e.g. "Invalid request" or custom message errors: type: object additionalProperties: type: array items: type: string description: >- Field name to list of validation error messages for that field required: - message - errors additionalProperties: false - type: object properties: message: type: object properties: status: type: number enum: - 400 details: type: object properties: formErrors: type: array items: type: string description: Global form-level error messages fieldErrors: type: object additionalProperties: type: array items: type: string description: >- Field name to list of validation error messages required: - formErrors - fieldErrors additionalProperties: false body: type: object additionalProperties: {} query: type: object additionalProperties: {} endpoint: type: string method: type: string token: type: string required: - status - details additionalProperties: false required: - message additionalProperties: false examples: validationZodDetails: summary: >- V1 Zod validation (body/query) – message contains status, details, request context value: message: status: 400 details: formErrors: [] fieldErrors: eventCallId: - 'Invalid input: expected number, received undefined' body: {} query: {} endpoint: /v1/deals method: POST token: Bearer iclosed_*** validationArray: summary: Validation errors (array) value: message: Invalid request errors: - email must be an email - name is required validationObject: summary: Validation errors (by field) value: message: Invalid request errors: email: - Invalid email name: - Required '401': description: Unauthorized – missing or invalid API key (Bearer token required) content: application/json: schema: type: object properties: message: type: string description: e.g. "API key is required" or "Invalid API key" code: description: >- Optional code e.g. MISSING_API_KEY when rate limiter runs before valid auth type: string required: - message additionalProperties: false examples: missing: summary: Missing API key value: message: API key is required invalid: summary: Invalid API key value: message: Invalid API key missingFromRateLimiter: summary: Missing auth when rate limiter runs first value: code: MISSING_API_KEY message: API key is required for this endpoint '403': description: Forbidden – insufficient permissions content: application/json: schema: type: object properties: message: type: string required: - message additionalProperties: false example: message: Forbidden access '404': description: >- Resource not found (e.g. NOT_FOUND, RECORD_NOT_FOUND, EVENT_NOT_FOUND) content: application/json: schema: type: object properties: message: type: string description: e.g. "Resource not found!" or "Record not found!" required: - message additionalProperties: false examples: generic: summary: Generic not found value: message: Resource not found! record: summary: Record not found value: message: Record not found! '429': description: >- Rate limit exceeded. Per-account, per-action limits apply. Response may include RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After headers. headers: RateLimit-Limit: description: Maximum requests allowed in the current window schema: type: string RateLimit-Remaining: description: Requests remaining in the current window schema: type: string RateLimit-Reset: description: ISO 8601 timestamp when the rate limit window resets schema: type: string format: date-time Retry-After: description: Seconds until the client can retry (when applicable) schema: type: string content: application/json: schema: type: object properties: code: type: string enum: - RATE_LIMIT_EXCEEDED description: Fixed code for rate limit responses message: type: string description: e.g. "Too many requests, please try again later." retryAfter: description: Seconds until the rate limit window resets type: number limit: description: Configured limit (when using account-based rate limiter) type: object properties: points: type: number windowSec: type: number required: - points - windowSec additionalProperties: false required: - code - message additionalProperties: false example: code: RATE_LIMIT_EXCEEDED message: Too many requests, please try again later. '500': description: >- Internal server error. Prisma and unhandled errors return a generic message; stack is only included in non-production. content: application/json: schema: type: object properties: message: type: string description: >- Generic: "Something went wrong" for Prisma errors, or error message stack: description: Present only in non-production type: string required: - message additionalProperties: false examples: generic: summary: Generic (e.g. Prisma errors) value: message: Something went wrong withMessage: summary: Error with message value: message: Database connection failed components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'API key required in Authorization header. Format: `iclosed-`' ````