tec-calendar-read-entities
Read, list, or search events, venues, organizers, and tickets with filters like date range, location, status, and price.
Instructions
Read, list, or search calendar posts.
Use Cases
Get single post: provide postType and id
List all posts: provide postType only
Search posts: provide postType and query
Query Capabilities
Get single post by ID
List all posts with pagination
Search posts by keyword
Filter by post-specific criteria
Combine multiple filters
Examples
Basic Queries
1. Get specific event by ID
{ "postType": "event", "id": 123 }2. List all venues with pagination
{ "postType": "venue", "per_page": 20, "page": 1 }3. Search events by keyword
{ "postType": "event", "search": "conference" }4. Get all organizers sorted by name
{ "postType": "organizer", "orderby": "title", "order": "asc" }Date Filtering
5. Get upcoming events
{
"postType": "event",
"eventFilters": {
"start_date": "2024-12-06"
}
}6. Get events in date range
{
"postType": "event",
"eventFilters": {
"start_date": "2024-12-01",
"end_date": "2024-12-31"
}
}Location Filtering
7. Find venues by city and state
{
"postType": "venue",
"venueFilters": {
"city": "San Francisco",
"state": "CA"
}
}8. Find venues near coordinates
{
"postType": "venue",
"venueFilters": {
"geo_lat": 37.7749,
"geo_lng": -122.4194,
"radius": 10
}
}Relationship Queries
9. Get events at specific venue
{ "postType": "event", "eventFilters": { "venue": 456 } }10. Get tickets for specific event
{ "postType": "ticket", "ticketFilters": { "event": 123 } }11. Get available tickets only
{
"postType": "ticket",
"ticketFilters": {
"event": 123,
"available": true
}
}Status & Filtering
12. Get only published events
{ "postType": "event", "status": "publish" }13. Get draft and pending venues
{ "postType": "venue", "status": ["draft", "pending"] }Complex Queries
14. Search published events at venues with dates
{
"postType": "event",
"search": "workshop",
"status": "publish",
"eventFilters": {
"venue": 456,
"start_date": "2024-12-01"
},
"per_page": 50
}15. Get tickets under $50 sorted by price
{
"postType": "ticket",
"ticketFilters": {
"max_price": 50,
"available": true
},
"orderby": "price",
"order": "asc"
}Available Filters
eventFilters: venue, organizer, featured, categories, tags
venueFilters: city, state, country, zip, geo_lat/lng, radius
ticketFilters: event, type, provider, min/max_price
organizerFilters: email, website, phone
Common: status, search, include, exclude, page, per_page, orderby
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| postType | Yes | The type of post to read | |
| id | No | Post ID for single post retrieval | |
| query | No | Search query string | |
| page | No | Page number | |
| per_page | No | Items per page | |
| order | No | Sort order | |
| orderby | No | Field to order by | |
| status | No | Post status filter | |
| include | No | Include specific IDs | |
| exclude | No | Exclude specific IDs | |
| eventFilters | No | Event-specific filters (only used when postType is "event") | |
| venueFilters | No | Venue-specific filters (only used when postType is "venue") | |
| organizerFilters | No | Organizer-specific filters (only used when postType is "organizer") | |
| ticketFilters | No | Ticket-specific filters (only used when postType is "ticket") |