Catalyst

The official Eventication API (work in progress)

Use the Catalyst integration to export Eventication data (memberships, jobs, shifts) to an external system.

Setup in Eventication

Go to: Admin → Event → General → Integrations → + (button) → Catalyst. If you can't find it, ask an Eventication admin to add it for you.

Admin validation required: this integration must be validated by an Eventication admin before it becomes active and before you can use the API key.

On the Catalyst integration screen, if it’s not validated you’ll see an “Action required” note with a link to contact Eventication.

Note that a Catalyst API key is scoped to an event. Each event needs another Catalyst integration.

API key / authentication

Once validated, you’ll see an API key in the Catalyst integration screen. Keep this key secret (treat it like a password):

• Do not share it

• Do not commit it to git

• Do not paste it in screenshots / tickets

• Store it in your secret manager or encrypted environment variables

Authenticate every request with the Authorization Bearer header:

Authorization: Bearer YOUR_CATALYST_API_KEY

Base URL

All endpoints are hosted on the API domain:

• https://api.eventication.com

Example:

• https://api.eventication.com/catalyst/memberships

Access control per endpoint

Eventication admins can enable/disable access per endpoint in the Catalyst integration settings. If your API key is valid but an endpoint is not allowed, you will receive:

• HTTP 403 with { "error": "Access denied" }

Pagination

List endpoints are paginated to keep responses fast.

• Query param: page (1-based)

• Fixed page size: Dependent on request

• The response includes meta:

  • page, per_page, next_page, prev_page

Example:

• GET https://api.eventication.com/catalyst/memberships?page=2

Rate limiting

Requests are rate-limited:

• 10 requests per minute

• On limit: HTTP 429 with { "error": "Rate limit exceeded" }

---

Endpoints

• Members (memberships)

Planning

• Jobs (work_jobs)

• Shifts (work_shifts)

Food and beverages

• Food and beverages (custom_meal_drinks)

• Selected food and beverages (selected_custom_meal_drinks)

Stock

• Categories (stock_categories)

• Types (stock_types)

• Articles (stock_items)

• Leases (stock_leases)

---

Errors & status codes

401 Unauthorized

• Missing/invalid API key

• Example: { "error": "Catalyst not found. Request UUID: ..." }

403 Forbidden

• Endpoint access not enabled for this integration

• Example: { "error": "Access denied" }

429 Too Many Requests

• Rate limit exceeded

• Example: { "error": "Rate limit exceeded" }

---

Example clients

cURL

curl -sS "https://api.eventication.com/catalyst/memberships?page=1" \
  -H "Authorization: Bearer YOUR_CATALYST_API_KEY" \
  -H "Accept: application/json"

Ruby (Net::HTTP)

require 'json'
require 'net/http'
require 'uri'

API_KEY = 'YOUR_CATALYST_API_KEY'
BASE_URL = 'https://api.eventication.com'

def get_json(path, page:)
  uri = URI("#{BASE_URL}#{path}?page=#{page}")
  req = Net::HTTP::Get.new(uri)
  req['Authorization'] = "Bearer #{API_KEY}"
  req['Accept'] = 'application/json'

  res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
  raise "HTTP #{res.code}: #{res.body}" unless res.is_a?(Net::HTTPSuccess)

  JSON.parse(res.body)
end

# Fetch all memberships (paginated)
page = 1
loop do
  payload = get_json('/catalyst/memberships', page: page)
  payload.fetch('data').each do |m|
    puts "#{m['id']} #{m['firstname']} #{m['lastname']} <#{m['email_address']}>"
  end

  next_page = payload.dig('meta', 'next_page')
  break if next_page.nil?
  page = next_page
end

JavaScript (fetch)

const apiKey = 'YOUR_CATALYST_API_KEY';
const baseUrl = 'https://api.eventication.com';

async function fetchPage(path, page) {
  const res = await fetch(`${baseUrl}${path}?page=${page}`, {
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Accept': 'application/json',
    },
  });

  if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
  return await res.json();
}

let page = 1;
while (true) {
  const payload = await fetchPage('/catalyst/work_jobs', page);
  // payload.data ...
  if (!payload.meta.next_page) break;
  page = payload.meta.next_page;
}

Python (requests)

import requests

api_key = "YOUR_CATALYST_API_KEY"
base_url = "https://api.eventication.com"

page = 1
while True:
  r = requests.get(
    f"{base_url}/catalyst/work_shifts",
    params={"page": page},
    headers={"Authorization": f"Bearer {api_key}", "Accept": "application/json"},
    timeout=30,
  )
  r.raise_for_status()
  payload = r.json()

  for row in payload["data"]:
    print(row["id"], row["work_job_id"], row["membership_id"])

  if payload["meta"]["next_page"] is None:
    break
  page = payload["meta"]["next_page"]

This API is a work in progress BETA and might change over time.