> ## Documentation Index > Fetch the complete documentation index at: https://docs.os.default.com/llms.txt > Use this file to discover all available pages before exploring further. # Get event details > Returns booking configuration for one event, addressed by event id or slug (scheduling link ids and slugs also resolve), including all configured hosts. Requires the `scheduling:read` scope. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/scheduling/events/{event} openapi: 3.1.0 info: title: Default Public API version: 1.0.0 description: >- Customer-facing REST API for scheduling and workflow triggers: list events, fetch availability, book, reschedule, or cancel meetings, and fire API triggers. Authenticate every request with `Authorization: Bearer ` using an API key created in workspace settings (Settings → API Keys). Keys carry permissions (`scheduling:read`, `scheduling:write`, `triggers:read`, `triggers:write`; a write key also satisfies read for its surface) and can be revoked at any time. Requests are rate limited to 30 per minute per key — a 429 response carries a `Retry-After` header with the seconds until the window resets. This is a server-to-server API: no CORS headers are sent, so it cannot be called directly from a browser. servers: - url: https://api.default.com security: - apiKey: [] paths: /v1/scheduling/events/{event}: get: tags: - Scheduling summary: Get event details description: >- Returns booking configuration for one event, addressed by event id or slug (scheduling link ids and slugs also resolve), including all configured hosts. Requires the `scheduling:read` scope. operationId: getEvent parameters: - name: event in: path required: true description: >- Event id or slug. Scheduling link ids and slugs also resolve and show the hosts configured on the link. schema: description: >- Event id or slug. Scheduling link ids and slugs also resolve and show the hosts configured on the link. type: string responses: '200': description: Success content: application/json: schema: type: object properties: id: type: string format: uuid slug: anyOf: - type: string - type: 'null' name: type: string schedulerTitle: anyOf: - type: string - type: 'null' schedulerDescription: anyOf: - type: string - type: 'null' duration: type: integer minimum: -2147483648 maximum: 2147483647 timeslotIncrement: type: integer minimum: -2147483648 maximum: 2147483647 conferencingType: type: string enum: - calendar_default - zoom - zoom_personal - in_person location: anyOf: - type: string - type: 'null' hosts: type: array items: type: object properties: name: anyOf: - type: string - type: 'null' profilePictureUrl: anyOf: - type: string - type: 'null' isQueue: type: boolean isPrimary: type: boolean required: - name - profilePictureUrl - isQueue - isPrimary additionalProperties: false questions: type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - email - text - textarea - single_select - multi_select - phone - url - number title: type: string description: anyOf: - type: string - type: 'null' placeholder: anyOf: - type: string - type: 'null' isRequired: type: boolean order: type: integer minimum: -9007199254740991 maximum: 9007199254740991 options: anyOf: - type: array items: type: object properties: value: type: string label: type: string required: - value - label additionalProperties: false - type: 'null' requireWorkEmail: type: boolean required: - id - type - title - description - placeholder - isRequired - order - options - requireWorkEmail additionalProperties: false required: - id - slug - name - schedulerTitle - schedulerDescription - duration - timeslotIncrement - conferencingType - location - hosts - questions additionalProperties: false '400': description: Error (INVALID_REQUEST) content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - INVALID_REQUEST message: type: string details: type: array items: type: string examples: INVALID_REQUEST: summary: INVALID_REQUEST value: error: code: INVALID_REQUEST message: Request validation failed details: - 'personEmail: Invalid email address' '401': description: Error (INVALID_API_KEY) content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - INVALID_API_KEY message: type: string details: type: array items: type: string examples: INVALID_API_KEY: summary: INVALID_API_KEY value: error: code: INVALID_API_KEY message: Missing, malformed, or revoked API key '403': description: Error (MISSING_SCOPE) content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - MISSING_SCOPE message: type: string details: type: array items: type: string examples: MISSING_SCOPE: summary: MISSING_SCOPE value: error: code: MISSING_SCOPE message: >- This API key is missing the required 'scheduling:read' scope '404': description: Error (NOT_FOUND) content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - NOT_FOUND message: type: string details: type: array items: type: string examples: NOT_FOUND: summary: NOT_FOUND value: error: code: NOT_FOUND message: Event not found '429': description: Error (RATE_LIMITED) headers: Retry-After: description: Seconds until the current rate-limit window resets. schema: type: integer content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - RATE_LIMITED message: type: string details: type: array items: type: string examples: RATE_LIMITED: summary: RATE_LIMITED value: error: code: RATE_LIMITED message: Rate limit exceeded for this API key '500': description: Error (INTERNAL_ERROR) content: application/json: schema: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - INTERNAL_ERROR message: type: string details: type: array items: type: string examples: INTERNAL_ERROR: summary: INTERNAL_ERROR value: error: code: INTERNAL_ERROR message: Internal server error components: securitySchemes: apiKey: type: http scheme: bearer description: >- Organization API key, created in workspace settings (Settings → API Keys). Sent as `Authorization: Bearer `. Shown once at creation; revocable and permission-scoped per key. ````