Base URL
https://techevents.co.nz/api/v1/
You can also use /api/latest/ which always points to the current API version.
Programmatic access to New Zealand tech event listings.
https://techevents.co.nz/api/v1/
You can also use /api/latest/ which always points to the current API version.
Public endpoints (listing and viewing events) require no authentication. Creating, updating, and deleting events requires a bearer token.
Approved organisers and admins can generate API tokens from the API Tokens page (requires sign-in).
Include the token in the Authorization header:
Authorization: Bearer techevents_your_token_here
Example (curl)
curl -H "Authorization: Bearer techevents_your_token" \
https://techevents.co.nz/api/v1/events/mine
GET /api/v1/events — No auth required
Returns approved upcoming events by default.
Query Parameters
| Param | Type | Description |
|---|---|---|
scope | string | upcoming (default) or past |
region | string | Filter by region (e.g., auckland, wellington, online) |
city | string | Filter by city name (requires region) |
event_type | string | Filter by type (e.g., meetup, conference) |
page | integer | Page number (default: 1) |
per_page | integer | Items per page (default: 25, max: 100) |
Example Response
{
"events": [
{
"id": 1,
"title": "Ruby Meetup Auckland",
"description": "Plain text description...",
"description_markdown": "**Markdown** description...",
"short_summary": "Brief summary",
"start_date": "2026-04-15",
"end_date": null,
"start_time": "18:00",
"end_time": "20:00",
"cost": "Free",
"event_type": "meetup",
"registration_url": "https://...",
"address": "123 Queen St",
"locations": [
{ "region": "auckland", "city": "Auckland CBD" }
],
"approved": true,
"created_at": "2026-03-20T10:00:00Z",
"updated_at": "2026-03-20T10:00:00Z"
}
],
"meta": {
"current_page": 1,
"total_pages": 1,
"total_count": 1,
"per_page": 25
}
}
GET /api/v1/events/:id — No auth required
Returns a single approved event. Returns 404 if the event doesn't exist or isn't approved.
GET /api/v1/events/mine — Auth required
Returns all events owned by the token holder, including unapproved events. Supports page and per_page parameters.
POST /api/v1/events — Auth required
Request Body
{
"event": {
"title": "My Event",
"description_markdown": "Event description in **Markdown**",
"short_summary": "Brief summary (optional)",
"start_date": "2026-04-15",
"end_date": "2026-04-16",
"start_time": "09:00",
"end_time": "17:00",
"cost": "Free",
"event_type": "meetup",
"registration_url": "https://example.com",
"address": "123 Queen Street",
"source": "Events in Aotearoa",
"source_url": "https://example.com/source",
"locations": [
{ "region": "auckland", "city": "Auckland CBD" }
]
}
}
Required Fields
| Field | Type |
|---|---|
title | string (max 200 chars) |
description_markdown | string (Markdown or plain text) |
start_date | date (YYYY-MM-DD) |
event_type | string (see valid values below) |
locations | array (at least one with region) |
Returns 201 Created with the event JSON on success, or 422 with validation errors.
PATCH /api/v1/events/:id — Auth required
Update an event you own. All fields are optional (partial updates). If locations is provided, it replaces all existing locations.
DELETE /api/v1/events/:id — Auth required
Delete an event you own.
conference, meetup, workshop, hackathon, webinar, networking, other, talk, awards
northland, auckland, waikato, bay_of_plenty, gisborne, hawkes_bay, taranaki, manawatu_whanganui, wellington, tasman, nelson, marlborough, west_coast, canterbury, otago, southland, apac, online
All errors return JSON with consistent structure:
{ "error": "Not found", "status": 404 }
Validation errors include field-level detail:
{
"errors": {
"title": ["can't be blank"],
"base": ["at least one location is required"]
},
"status": 422
}
| Code | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 401 | Missing or invalid token |
| 403 | Not the event owner |
| 404 | Not found |
| 422 | Validation errors |
| 429 | Rate limited |
| Scope | Limit |
|---|---|
| Read endpoints (index, show, mine) | 120 requests per minute |
| Write endpoints (create, update, delete) | 30 requests per minute |
Exceeding the limit returns 429 Too Many Requests.
A JSON spec is available at /api/v1/spec.json (also at /api/latest/spec.json).