List Events - API Documentation

API Reference

REST API

Getting Started Authorization Best Practices

MCP (AI Assistants)

MCP Overview MCP Authentication

General

Status Get Business Identity Get Business Details

Contacts

List Contacts

Jobs

List Jobs

Estimates

List Estimates

Invoices

List Invoices

Offerings

List Offerings

Equipment

List Equipment

Events

List Events

GET https://backend.localbusiness.pro/api/v1/events

Returns published events for the authenticated business, ordered by most recent first. Draft and archived events are excluded. Uses a count-based limit instead of pagination.

Header Parameters

X-Public-Key string required

Your business public key. Used to identify which business is making the request.

X-Timestamp string required

Current Unix timestamp in seconds. Requests older than 5 minutes are rejected.

X-Signature string required

HMAC-SHA256 signature of the signing string: {timestamp}\n{METHOD}\n{path}\n{body}, using your private key as the secret.

Query Parameters

count integer

Number of events to return (default 10). Clamped to 1–100.

Responses

200 A list of published events.

{
  "events": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Spring AC Tune-Up Special",
      "description": "Get your AC ready for summer. $79 tune-up includes full system inspection, refrigerant check, and filter replacement.",
      "url": "https://summithvac.com/spring-special",
      "type": "multi-day",
      "schedule": [
        {
          "date": "2026-04-01",
          "start_time": "08:00",
          "end_time": "17:00"
        },
        {
          "date": "2026-04-15",
          "start_time": "08:00",
          "end_time": "17:00"
        }
      ],
      "location_type": "in-person",
      "venue": "Summit HVAC Services",
      "address": "4820 Industrial Blvd, Denver, CO 80216",
      "virtual_link": null,
      "is_free": false,
      "image_url": "https://s3.amazonaws.com/bucket/spring-ac-tuneup.jpg",
      "media": [
        {
          "url": "https://s3.amazonaws.com/bucket/spring-ac-tuneup.jpg",
          "file_type": "image",
          "caption": "Spring AC maintenance special",
          "featured": true
        }
      ]
    }
  ]
}

401 Missing credentials, expired timestamp, or invalid signature.

{
  "error": "Invalid API credentials",
  "code": "INVALID_CREDENTIALS"
}

403 Business account exists but is not active.

{
  "error": "Business account is not active",
  "code": "ACCOUNT_INACTIVE"
}

429 Rate limit exceeded (60 requests/minute per key).

{
  "message": "Too Many Attempts."
}

Authentication — HMAC-SHA256

Every authenticated request requires three headers:

X-Public-KeyYour business public key

X-TimestampUnix timestamp (seconds)

X-SignatureHMAC-SHA256 of signing string

Signing string: {timestamp}\n{METHOD}\n{path}\n{body}

Request

GET https://backend.localbusiness.pro/api/v1/events

Rate Limits

With X-Public-Key: 60 req/min per key

Without: 10 req/min per IP

Code Examples

PUBLIC_KEY="pk_live_..."
PRIVATE_KEY="sk_live_..."
TIMESTAMP=$(date +%s)
PATH_URI="/api/v1/events?count=5"

SIGNATURE=$(printf '%s\n%s\n%s\n' "$TIMESTAMP" "GET" "$PATH_URI" \
  | openssl dgst -sha256 -hmac "$PRIVATE_KEY" | awk '{print $2}')

curl -H "X-Public-Key: $PUBLIC_KEY" \
     -H "X-Timestamp: $TIMESTAMP" \
     -H "X-Signature: $SIGNATURE" \
     "https://backend.localbusiness.pro$PATH_URI"

const crypto = require("crypto");

const publicKey = "pk_live_...";
const privateKey = "sk_live_...";
const timestamp = Math.floor(Date.now() / 1000).toString();
const method = "GET";
const path = "/api/v1/events?count=5";
const body = "";

const signingString = `${timestamp}\n${method}\n${path}\n${body}`;
const signature = crypto
  .createHmac("sha256", privateKey)
  .update(signingString)
  .digest("hex");

const response = await fetch("https://backend.localbusiness.pro/api/v1/events?count=5", {
  headers: {
    "X-Public-Key": publicKey,
    "X-Timestamp": timestamp,
    "X-Signature": signature,
  },
});

const data = await response.json();
console.log(data);

import hmac, hashlib, time, requests

public_key = "pk_live_..."
private_key = "sk_live_..."
timestamp = str(int(time.time()))
method = "GET"
path = "/api/v1/events?count=5"
body = ""

signing_string = f"{timestamp}\n{method}\n{path}\n{body}"
signature = hmac.new(
    private_key.encode(), signing_string.encode(), hashlib.sha256
).hexdigest()

response = requests.get(
    "https://backend.localbusiness.pro/api/v1/events?count=5",
    headers={
        "X-Public-Key": public_key,
        "X-Timestamp": timestamp,
        "X-Signature": signature,
    },
)
print(response.json())

<?php
$publicKey = 'pk_live_...';
$privateKey = 'sk_live_...';
$timestamp = time();
$method = 'GET';
$path = '/api/v1/events?count=5';
$body = '';

$signingString = $timestamp . "\n" . $method . "\n" . $path . "\n" . $body;
$signature = hash_hmac('sha256', $signingString, $privateKey);

$ch = curl_init('https://backend.localbusiness.pro/api/v1/events?count=5');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-Public-Key: $publicKey",
    "X-Timestamp: $timestamp",
    "X-Signature: $signature",
]);

$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));