events

Calendar event or conference with date/time, location, venue, organizer, capacity, pricing, and online/offline status. Used for event management, calendar applications, and conference booking systems.

🎯 Request Builder

https://api.mockly.codes/events?page=1&limit=10&count=10
📡

Configure your request and click Send Request to see the response here.

Endpoints

GET/events

Get a collection of events

Alternative: /productivity/events
GET/events/:id

Get a single event by ID

Alternative: /productivity/events/:id
GET/events/meta

Get resource metadata and schema

Alternative: /productivity/events/meta
🔍

How to Use Search

The search feature allows you to filter results by searching for text across all or specific fields. Choose between ?q= or ?search= parameter names.

1. Basic Search

Search across all text fields:

Basic Search
GET https://api.mockly.codes/events?q=laptop

2. Search Specific Fields

Field-Specific Search
GET https://api.mockly.codes/events?q=laptop&search_fields=name,description

💡 Pro Tips

  • Search is case-insensitive and performs partial matching
  • Without search_fields, all text fields are searched
  • Combine with pagination to handle large result sets efficiently

Code Examples

JavaScript

Fetch Collection
// Get 10 events
fetch('https://api.mockly.codes/events?count=10')
  .then(res => res.json())
  .then(data => console.log(data));

Python

Fetch with Requests
import requests

response = requests.get(
    'https://api.mockly.codes/events?count=10'
)
data = response.json()

cURL

Command Line
curl "https://api.mockly.codes/events?count=10"

Bypass Cache

Get Fresh Data
fetch('https://api.mockly.codes/events?nocache=true')

Schema Properties

idinteger

Unique identifier for the event

Gen:random_int
titlestring

Event title or name

Gen:event_title
descriptionstring

Detailed description of the event

Gen:paragraph
categorystring

Event category (e.g., Conference, Workshop, Concert, Sports, Networking)

Gen:event_category
start_datestring

Event start date and time

Gen:future_datedate-time
end_datestring

Event end date and time

Gen:future_datedate-time
locationstring

Street address of the event location

Gen:address
citystring

City where the event takes place

Gen:city
countrystring

Country where the event takes place

Gen:country
venuestring

Venue name where the event is held

Gen:venue
organizerstring

Name of the organization or person organizing the event

Gen:company
capacityinteger

Maximum number of attendees the event can accommodate

Gen:random_int
pricenumber

Ticket price or entry fee

Gen:price
currencystring

ISO currency code for the price (e.g., USD, EUR, GBP)

Gen:currency
is_onlineboolean

Whether the event is held online/virtual or in-person

Gen:boolean
urlstring

Event website URL or registration link

Gen:urluri

Query Parameters

countinteger

Number of items to return (default: 10, max: 100)

seedinteger

Seed for reproducible data generation

nocacheboolean

Bypass cache and generate fresh data on every request