List Events

GEThttps://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.

X-Public-Keystringrequired

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

X-Timestampstringrequired

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

X-Signaturestringrequired

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

countinteger

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

Values: 1-100

Responses

{
  "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
        }
      ]
    }
  ]
}

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

GEThttps://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"