Agency

API

A read-only API for your own events and RSVPs, available on the Agency plan. Create a key in Settings → API access. Keys can't change anything.

Authentication

Send your key as a bearer token. Treat it like a password: it's shown once when you create it, and you can revoke it any time in Settings. If your account leaves the Agency plan, your keys stop working until you upgrade again.

Request
curl "https://ceremonia.cc/api/v1/events/maple-wedding/rsvps?limit=2" \
  -H "Authorization: Bearer cer_live_xxxxxxxxxxxx"

Endpoints

Base URL:https://ceremonia.cc/api/v1

  • GET /events
    Every event on your account, newest first.
  • GET /events/{slug}
    One event, including its RSVP count.
  • GET /events/{slug}/rsvps?limit=50&offset=0
    That event's RSVPs, oldest first. limit is 1–100 (default 50).

Example RSVP response:

Response
{
  "data": [
    {
      "id": "7c1f0c3e-…",
      "name": "Ada Lovelace",
      "attendance": "yes",
      "guests": 2,
      "plusOnes": ["Charles"],
      "table": 4,
      "dietary": "Vegetarian",
      "meals": [
        {
          "person": "Ada Lovelace",
          "picks": [{ "course": "Main", "dish": "Mushroom Wellington" }]
        }
      ],
      "message": "Can't wait!",
      "createdAt": "2026-10-01T12:00:00.000Z"
    }
  ],
  "pagination": { "total": 87, "limit": 2, "offset": 0 }
}

Limits & errors

Each key may make 60 requests per minute. Errors share one shape:

Error
{ "error": { "message": "Missing or invalid API key." } }
  • 401Missing, malformed or revoked key.
  • 403The account isn't on the Agency plan.
  • 404The event doesn't exist or isn't yours.
  • 429Rate limit reached. Wait for the Retry-After header (in seconds).