> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.neetocal.com/llms.txt > Use this file to discover all available pages before exploring further. # List scheduling links > List scheduling links. Replace `{your-subdomain}` with your workspace’s subdomain.
Learn how to find your subdomain in [Workspace subdomain](/getting-started/workspace-subdomain). ## OpenAPI ````yaml bundled/meetings.yaml GET /meetings openapi: 3.0.3 info: title: NeetoCal Meetings APIs version: 2.0.0 servers: - description: NeetoCal APIs url: https://{your-subdomain}.neetocal.com/api/external/v2 variables: your-subdomain: default: spinkart description: >- Replace **spinkart** with your [workspace's subdomain](/getting-started/workspace-subdomain). security: [] tags: - name: Scheduling links description: APIs to create and manage scheduling links. paths: /meetings: get: tags: - Scheduling links summary: List scheduling links description: List scheduling links. parameters: - $ref: '#/components/parameters/api_key_header' - $ref: '#/components/parameters/page_number_param' - $ref: '#/components/parameters/page_size_param' - in: query name: host_email description: > Filter scheduling links by host email(s). Supports both single email and multiple emails. **Single email:** `host_email=oliver@example.com` **Multiple emails:** `host_email[]=oliver@example.com&host_email[]=jane@example.com` When multiple emails are provided, it returns scheduling links that include any of the specified hosts. required: false schema: oneOf: - type: string description: Single host email example: oliver@example.com - type: array items: type: string description: Array of host emails example: - oliver@example.com - jane@example.com style: form explode: true examples: single_email: summary: Single host email value: oliver@example.com multiple_emails: summary: Multiple host emails (array format) value: - oliver@example.com - jane@example.com - in: query name: search description: >- Filter scheduling links by meeting name or slug. Performs a case-insensitive search. required: false schema: type: string responses: '200': description: OK - Request succeeded content: application/json: schema: $ref: '#/components/schemas/meeting_list_response' components: parameters: api_key_header: in: header name: X-Api-Key description: >- Use the X-Api-Key header to provide your workspace API key. Refer to [Authentication](/getting-started/authentication) for more information. required: true schema: type: string page_number_param: in: query name: page_number description: >- Retrieve paginated results by specifying the desired page number. If this parameter is absent, all results will be returned. required: false schema: type: integer page_size_param: in: query name: page_size description: >- Set the number of results returned in the response. Defaulting to 30 when omitted. required: false schema: type: integer schemas: meeting_list_response: allOf: - type: object properties: meetings: type: array items: $ref: '#/components/schemas/meeting' description: List of meetings/scheduling links. pagination: $ref: '#/components/schemas/pagination' meeting: type: object properties: id: type: string description: Unique identifier for the scheduling link. sid: type: string description: Short identifier (SID) for the meeting, used in URLs and API calls. name: type: string description: Display name of the scheduling link. slug: type: string description: >- URL-friendly identifier for the meeting, used in public scheduling links. description: type: string description: Detailed description of the meeting purpose or agenda. kind: type: string enum: - one_on_one - round_robin - multihost - grouped description: >- Type of meeting. one_on_one for individual meetings, round_robin for rotating hosts, multihost for multiple simultaneous hosts, grouped for group sessions. duration: type: integer description: Duration of the meeting in minutes. disabled: type: boolean description: >- Whether the scheduling link is currently disabled and not accepting bookings. spot: type: string enum: - custom - jitsi - google_meet - daily - zoom - whereby - teams - phone_call - in_person description: Meeting platform or location type for the scheduled meeting. spot_in_person_location: type: string nullable: true description: Physical location details when meeting place is set to in_person. spot_custom_text: type: string nullable: true description: >- Custom meeting instructions or details when meeting place is set to custom. spot_phone_call_number: type: string nullable: true description: Phone number for the meeting when place is set to phone_call. is_template: type: boolean description: >- Whether this meeting is a template that can be used to create other meetings. schedulable_range_type: type: string enum: - number_of_days_into_the_future - number_of_business_days_into_the_future - date_range description: >- How the scheduling range is calculated - by days into future, business days, or specific date range. schedulable_range_value: type: string description: Value for the scheduling range (e.g., number of days or date range). lead_time: type: integer description: Minimum advance notice required for booking in minutes. start_time_increment: type: integer description: >- Time increment in minutes for available booking slots (e.g., 30 for 30-minute slots). before_buffer_time: type: integer minimum: 0 maximum: 1440 description: >- Buffer time in minutes before each meeting to allow for setup, preparation, or travel time. Must be between 0 and 1440 (24 hours). example: 0 after_buffer_time: type: integer minimum: 0 maximum: 1440 description: >- Buffer time in minutes after each meeting to allow for wrap-up, notes, or preparation for the next meeting. Must be between 0 and 1440 (24 hours). example: 0 created_at: type: string example: '2025-12-23T05:05:27.037Z' description: Timestamp when the meeting was created. updated_at: type: string example: '2025-03-31T13:22:19.832Z' description: Timestamp when the meeting was last updated. deleted_at: type: string nullable: true example: null description: Timestamp when the meeting was deleted (soft delete). is_multiple_spots_allowed: type: boolean description: Whether users can select from multiple meeting places. is_multiple_durations_allowed: type: boolean description: Whether users can select from multiple meeting duration options. conditional_pricing_enabled: type: boolean description: Whether conditional pricing rules are applied to this meeting. is_email_reminders_enabled: type: boolean description: Whether email reminders are sent for this meeting. is_sms_reminders_enabled: type: boolean description: Whether SMS reminders are sent for this meeting. organization_id: type: string description: Unique identifier of the organization that owns this meeting. rescheduling_lead_time: type: integer description: Minimum advance notice required for rescheduling in minutes. cancellation_lead_time: type: integer description: Minimum advance notice required for cancellation in minutes. booking_modification_allowed: type: boolean description: Whether users are allowed to modify their bookings after creation. cancellation_too_late_notice: type: string nullable: true description: Custom message shown when cancellation is attempted too late. cancellation_policy: type: string nullable: true description: Policy text explaining cancellation terms and conditions. rescheduling_too_late_notice: type: string nullable: true description: Custom message shown when rescheduling is attempted too late. pre_booking_allowed: type: boolean description: >- Whether users can book meetings in advance beyond the normal scheduling range. original_price_enabled: type: boolean description: Whether to show the original price alongside any discounted price. original_price: type: number nullable: true description: Original price of the meeting before any discounts. locked_time_zone: type: string nullable: true description: >- Time zone to lock the scheduling link to. When set, all available times are displayed in this time zone regardless of the booker's location. Must be a valid IANA time zone identifier (e.g., 'America/New_York', 'Europe/London'). example: America/New_York fees: type: array description: Fees or charges associated with the meeting (scheduling link). items: type: object properties: id: type: string description: Unique identifier for the fee configuration. example: 1b217cc5-69b5-4fb1-a13c-c22f9c14e7f9 amount: type: string description: The fee amount as a string to preserve decimal precision. example: '120.0' currency: type: string description: >- The currency code for the fee amount. Follows the ISO 4217 standard (e.g., "inr", "usd"). example: inr feeable_id: type: string description: >- ID of the entity this fee is associated with (meeting ID in this case). example: aff17ff8-1bf8-4e77-a3c5-2f86104f9a20 feeable_type: type: string description: Type of entity this fee is associated with. example: Meeting payment_provider: type: string enum: - stripe - razorpay - cash - paypal - dodopayments description: Payment service provider used for processing payments. example: cash kind: type: string description: Type of fee structure (e.g., "fixed", "percentage"). example: fixed min_amount: type: string description: Minimum amount that can be charged for this fee. example: '120.0' is_default: type: boolean description: >- Indicates whether this is the default fee configuration for the meeting. display_amount: type: string nullable: true description: >- Custom display amount for the fee (if different from the actual amount). is_tax_enabled: type: boolean description: Whether tax calculation is enabled for this fee. is_tip_enabled: type: boolean description: Whether tipping is enabled for this fee. is_tax_applicable_on_tip: type: boolean description: Whether taxes are calculated on top of tips. vpas: type: array description: Virtual Payment Addresses for UPI payments (India-specific). items: type: object recipient: type: object description: The payment recipient configured for this fee. properties: id: type: string description: Unique identifier for the recipient. fee_id: type: string description: ID of the fee this recipient belongs to. accountable: type: object description: The connected payment account that receives the payout. amount_in_smallest_currency_unit: type: integer description: >- Fee amount in the smallest currency unit (e.g., paise for INR, cents for USD). example: 12000 durations_possible: type: array items: type: integer description: >- List of available duration options in minutes when multiple durations are allowed. durations: type: array items: type: object properties: id: type: string description: Unique identifier for the duration option. example: 4ece6b6b-4b5f-4c15-9122-a85af189198c duration: type: integer description: Duration in minutes. example: 30 is_default: type: boolean description: Whether this duration is the default option. example: false created_at: type: string format: date-time description: Timestamp when the duration option was created. example: '2025-08-18T07:43:16.775Z' updated_at: type: string format: date-time description: Timestamp when the duration option was last updated. example: '2025-08-18T08:03:58.019Z' hosts: type: array items: type: object properties: name: type: string description: Full name of the host. example: Oliver Smith email: type: string description: Email address of the host. example: oliver@example.com description: List of hosts for the scheduling link with their name and email. spots: type: array items: type: object properties: id: type: string description: Unique identifier for the meeting place option. example: bcc90342-9345-4d89-9144-d25d7c7b3521 spot: type: string enum: - daily - zoom - jitsi - google_meet - teams - whereby - in_person - custom - phone_call description: The place type for the meeting. example: jitsi is_default: type: boolean description: Whether this meeting place is the default option. example: false phone_call_number: type: string nullable: true description: >- Phone number for phone call meeting place. Only populated when place type is "phone_call", otherwise null. example: null in_person_location: type: string nullable: true description: >- Location details for in-person meetings. Only populated when place type is "in_person", otherwise null. example: null custom_text: type: string nullable: true description: >- Custom text for custom meeting place. Only populated when place type is "custom", otherwise null. example: null created_at: type: string format: date-time description: Timestamp when the meeting place option was created. example: '2025-08-18T07:19:28.341Z' updated_at: type: string format: date-time description: Timestamp when the meeting place option was last updated. example: '2025-08-18T07:35:32.822Z' pagination: type: object properties: total_records: type: integer description: Total number of records. total_pages: type: integer description: Total number of pages available. current_page_number: type: integer description: Current page number. page_size: type: integer description: Number of records per page. ````