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.
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:
{
"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": { "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).