> ## 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 Event By ID > Get a single event by id for the authenticated account ## OpenAPI ````yaml GET /v1/events/detail 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/detail: get: tags: - Events summary: Get Event By ID description: >- Get a single event by id for the authenticated account. Query: eventId (required). operationId: getEventById parameters: - name: id in: query schema: description: Event ID type: number description: Event ID - name: linkPrefix in: query schema: description: Event link prefix type: string description: Event link prefix responses: '200': description: Single event detail content: application/json: schema: type: object properties: data: type: object properties: id: type: number linkPrefix: nullable: true type: string name: nullable: true type: string eventType: nullable: true type: string status: nullable: true type: string accountId: type: number userId: type: number isDefaultNotification: type: boolean optimizationPriorities: type: array items: type: object properties: id: type: number priority: nullable: true type: number userId: nullable: true type: number eventId: nullable: true type: number user: nullable: true type: object properties: id: type: number firstName: nullable: true type: string lastName: nullable: true type: string email: nullable: true type: string profilePictureKey: nullable: true type: string previewId: nullable: true type: string signedUrl: nullable: true type: string userAccounts: type: array items: type: object properties: inviteNotAccepted: type: boolean additionalProperties: false calendarConnected: type: boolean zoomConnected: type: boolean inviteNotAccepted: nullable: true type: boolean activeAvailability: nullable: true type: object properties: id: type: number name: nullable: true type: string timeZone: nullable: true type: string availabilityDays: type: array items: type: object properties: id: type: number name: type: string timings: type: array items: type: object properties: startTime: type: string endTime: type: string required: - startTime - endTime additionalProperties: false active: type: boolean required: - id - name - timings - active additionalProperties: false required: - id - availabilityDays additionalProperties: false availabilitySet: nullable: true type: boolean required: - id additionalProperties: false required: - id additionalProperties: false inviteeQuestions: type: array items: type: object properties: id: type: number statement: nullable: true type: string type: nullable: true type: string required: nullable: true type: boolean options: nullable: true type: object displayIndex: nullable: true type: number deletedAt: nullable: true anyOf: - type: string format: date-time - type: string type: object required: - id additionalProperties: false workflowEvents: type: array items: type: object properties: workflow: type: object properties: id: type: number eventCallStateId: nullable: true type: number name: nullable: true type: string immediate: nullable: true type: boolean minutes: nullable: true type: number unit: nullable: true type: string disabled: nullable: true type: boolean required: - id additionalProperties: false required: - workflow additionalProperties: false EventRules: type: array items: type: object properties: rule: type: object properties: id: type: number name: nullable: true type: string type: nullable: true type: string disabled: nullable: true type: boolean multiBookingConditions: type: array items: type: object properties: customFieldEvent: nullable: true type: object properties: customFieldId: nullable: true type: number additionalProperties: false customFieldEventId: nullable: true type: number condition: nullable: true type: string value: nullable: true type: string operator: nullable: true type: string additionalProperties: false required: - id additionalProperties: false required: - rule additionalProperties: false EventLogicGroup: type: array items: type: object properties: minSlotsCheck: nullable: true type: boolean EventLogicUsers: type: array items: type: object properties: user: type: object properties: id: type: number email: nullable: true type: string firstName: nullable: true type: string lastName: nullable: true type: string profilePictureKey: nullable: true type: string signedUrl: nullable: true type: string required: - id additionalProperties: false required: - user additionalProperties: false EventLogics: type: array items: type: object properties: id: type: number eventId: nullable: true type: number inviteeQuestionId: nullable: true type: number customFieldId: nullable: true type: number condition: nullable: true type: string value: nullable: true type: string operator: nullable: true type: string customField: nullable: true type: object customFieldEvent: nullable: true type: object required: - id additionalProperties: false additionalProperties: false CustomFieldEventMap: type: array items: type: object properties: id: type: number statement: nullable: true type: string required: nullable: true type: boolean displayIndex: nullable: true type: number customField: nullable: true type: object required: - id additionalProperties: false DisqualificationLogicGroup: type: array items: type: object properties: redirectUrl: nullable: true type: string EventConditionalLogics: type: array items: type: object properties: id: type: number eventId: nullable: true type: number statement: nullable: true type: string operator: nullable: true type: string value: nullable: true type: string condition: nullable: true type: string disqualificationGroupId: nullable: true type: number required: - id additionalProperties: false additionalProperties: false eventImage: nullable: true type: object properties: id: type: number imageUrl: nullable: true type: string imageKey: nullable: true type: string signedUrl: nullable: true type: string required: - id additionalProperties: false account: nullable: true type: object properties: emailValidationEnabled: nullable: true type: boolean phoneNumberValidationEnabled: nullable: true type: boolean usCreditCheckEnabled: nullable: true type: boolean signedUrl: nullable: true type: string additionalProperties: false user: nullable: true type: object properties: id: type: number firstName: nullable: true type: string lastName: nullable: true type: string email: nullable: true type: string profilePictureKey: nullable: true type: string previewId: nullable: true type: string signedUrl: nullable: true type: string userAccounts: type: array items: type: object properties: inviteNotAccepted: type: boolean additionalProperties: false calendarConnected: type: boolean zoomConnected: type: boolean inviteNotAccepted: nullable: true type: boolean activeAvailability: nullable: true type: object properties: id: type: number name: nullable: true type: string timeZone: nullable: true type: string availabilityDays: type: array items: type: object properties: id: type: number name: type: string timings: type: array items: type: object properties: startTime: type: string endTime: type: string required: - startTime - endTime additionalProperties: false active: type: boolean required: - id - name - timings - active additionalProperties: false required: - id - availabilityDays additionalProperties: false availabilitySet: nullable: true type: boolean required: - id additionalProperties: false eventEmailTemplateVariables: type: array items: type: object properties: id: type: number eventId: nullable: true type: number variableKey: nullable: true type: string variableValue: nullable: true type: string required: - id additionalProperties: false required: - id additionalProperties: false 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-`' ````