Developer APIPrivate beta

Your event data,
in your own systems.

Read your events and your attendee list from anywhere, check guests in from an app you built yourself, and get a signed webhook the second an order lands. Your key, your systems, your data.

Self-serve keys  ·  Signed webhook deliveries  ·  A sandbox for your check-in tests
www.ticketfalcon.com/wp-json/ticketfalcon/v1/organizer Live
0Calls
made
Ready
Request

						
Response 200 OK

						
Activity Live

    Press play to walk one integration through the real request and response shapes. Illustrative simulation, not a live connection.

    Why it matters

    Your attendee list should not be stuck in one tab

    Every team already runs on something else: a CRM, a donor database, a spreadsheet, a badge printer, a check-in app built for one venue. Copying a list between them by hand is how the data goes stale, and it always goes stale on the day it matters.

    Read

    Take your data with you

    Everything you can see on your dashboard, you can pull into your own tools on your own schedule.

    • Your events, filtered how you want them
    • Every attendee, with their ticket details
    • Only what changed since your last sync
    Write

    Check guests in your way

    Post a check-in from anything you can write code in, and our screens treat it as if your staff scanned it.

    • The same validation our own scanner runs
    • Live on every device already watching
    • A sandbox mode so you can test on a real event
    React

    Hear it the moment it happens

    Save one URL and orders, refunds, and attendee changes come to you instead of you asking for them.

    • Four events, one payload shape
    • Signed with a secret only you hold
    • Verify any delivery inside your portal
    The whole surface

    Three endpoints, and that is the point

    A small API is one you can read in five minutes and trust in production. Two reads and one write cover the integrations organizers actually build.

    GET
    /events

    Your event list

    Everything you own, plus everything shared with you, with the role you hold on each one.

    • Filter by upcoming, ended, draft, or cancelled
    • Search by name or start date
    • Up to 200 events a page, with totals in the headers
    GET
    /attendees

    Your attendee list

    Name, email, ticket type, ticket number, seat, paddle number, and check-in state for every guest.

    • One event, or every event your key reaches
    • Ask for only what changed since last time
    • The next sync link comes back with the answer
    POST
    /checkin

    Admit a guest

    The one write. Send an order number and a ticket number and the guest is checked in.

    • Validated against the real order, like our scanner
    • A repeat scan answers clearly instead of failing
    • Sandbox mode runs it all and writes nothing
    Reading your data

    Pull your events and attendees anywhere

    Two read endpoints cover almost every integration anyone has asked us for. Ask for your events, ask for the people coming to them, and put both wherever your team already works.

    Your event list

    Ask for upcoming, ended, draft, or cancelled events, filter by name or start date, and get the event page link back with each one.

    Your attendee list

    Names, emails, ticket types, ticket numbers, seats, paddle numbers, and whether each guest has been checked in.

    Sync changes, not everything

    Ask for only what changed since your last call. Every response hands you the exact link to use for the next one.

    Events shared with you

    Events another organizer shared with your account come back too, tagged with the role you hold on each one.

    Paging that adds up

    Totals and page counts come back in the response headers, so you always know how much is left to fetch.

    Refunds left out

    Refunded tickets and donation lines are filtered out for you, so your list is the list of people actually coming.

    Checking guests in

    Run the door from your own app

    Check-in is the one thing you can write back, and it behaves exactly like a scan made on our own app. Build the door experience you want and the rest of the platform keeps up.

    Post a check-in

    Send the order number and ticket number and the guest is admitted, with the same validation our own scanner runs.

    It reaches every screen

    A check-in you post appears instantly on the check-in page, the scanner, the guest list, and the bulk editor.

    A second scan is not a failure

    Scan a guest twice and you get a clear "already checked in" answer with the time they arrived, not an error.

    A sandbox for your tests

    Flip one header on and your check-in calls run the full validation and write nothing. Test against a real event safely.

    Auction paddles included

    Check-in responses carry the paddle number for auction events, so a bidder is ready the moment they walk in.

    Door times that match

    A scan you post reads the same on every screen as one made in our own app, formatted in your event's own timezone, so nobody has to work out which surface recorded it.

    Getting told

    Know the moment something happens

    Point us at one URL and we post to it as orders land, refunds go out, and attendee details change. No polling loop to write and no delay to explain.

    An order completed

    The full order arrives as it happens, one line per ticket, with the attendee name, email, phone, and ticket number on each.

    A refund went out

    Refunded orders and individually refunded tickets both fire, so your own records never drift out of step with ours.

    An attendee changed

    A guest name, email, phone, seat, paddle number, or check-in state changing sends you the order again, updated.

    Signed, so you can trust it

    Every delivery carries a signature made with your own secret, so your listener can prove the message came from us.

    Rotate the secret yourself

    Generate a new signing secret whenever you want, from the same screen, without opening a support ticket.

    Check a delivery in seconds

    Paste a delivery into the portal and it tells you whether the signature verifies. It never leaves your browser.

    Staying in control

    A key you can hand out and take back

    Your attendee list is the most sensitive thing you keep with us. Everything about the API is built so that opening it up never means losing track of who can read what.

    Generated by you, shown once

    Create a key in your portal and copy it there and then. We only ever store a hash of it, so nobody can read it back.

    Rotate with no downtime

    Generate a new key and the old one keeps working for 24 hours, so you can update your apps without breaking them.

    Decide who on your team

    Choose which team members can use their own key. Their reach never grows past the events you already assigned them.

    A sane rate limit

    Up to 60 requests a minute per account, which is far more than a normal sync needs and enough to keep the platform quick.

    See when it was last used

    Your account shows the last time your key was used, which is the fastest way to confirm an integration is live.

    Docs, samples, and Postman

    A documentation tab in the portal, a full guide in our help center, and a Postman collection to try every call in a minute.

    What people connect

    Built for the tools you already run on

    You do not need an engineering team to get value here. Most of these are an afternoon of work, and several need no code at all.

    Your CRM or donor database

    Push every buyer into the system your team already lives in, so an event attendee becomes a contact you can reach again.

    A check-in app of your own

    Build the door experience your venue needs and post the scans back, with our screens staying in sync the whole night.

    Waivers and post-event forms

    Send each guest a form that already knows their name and ticket number, so nobody has to type it in twice.

    Zapier, Make, and n8n

    Any tool that accepts a webhook can start a workflow the second a ticket sells. No server of your own required.

    Dashboards and reporting

    Feed live sales and attendance into the board report, the sponsor deck, or the spreadsheet your finance team trusts.

    Badge and name tag printing

    Pull the confirmed list into your badge software the morning of the event and print from real data.

    Membership and school systems

    Match ticket buyers to members, students, or families in the system of record you already maintain.

    Your own email platform

    Sync attendees into the mailing tool you already pay for and segment them by event or ticket type.

    A multi-venue operation

    One key reaches every event you own and every event shared with you, so one integration covers the whole portfolio.

    The Ticket Falcon difference

    An API you can hand to a partner

    The API is not a paid add-on or a separate product. It is the same data, the same events, and the same check-in behavior you already use, opened up on your terms.

    Keys only you hold

    Shown once, stored as a hash, rotated whenever you want with a full day of overlap.

    Every delivery signed

    Your listener can prove a webhook came from us before it acts on a single field.

    A real sandbox

    Test check-in against a live event and nobody gets admitted and no screen changes.

    Live on every screen

    Your app checks a guest in and our check-in page shows it at the same moment.

    For organizers

    Connected in four steps

    Step 1

    Ask for access

    Tell us what you want to build and we switch the Developer Portal on for your account.

    Step 2

    Generate your key

    Open My Account, then Developer Portal, and create a key. Copy it there and then, because it is shown once.

    Step 3

    Make your first call

    Import the Postman collection, paste your key in, and read your own event list back in under a minute.

    Step 4

    Add a webhook

    Save your URL, copy your signing secret, and start hearing about orders the second they land.

    Request access Read the developer guide
    Before you build

    What it does not do, said up front

    Finding a limit halfway through a build is worse than reading it here. These are the three that come up most, and each one has a pattern that works around it.

    Check-in is the only write

    You cannot create an event, issue a ticket, edit an order, or process a refund through the API. Those all stay on your dashboard, where the approvals and the audit trail live.

    Webhooks are not retried

    If your listener is down when one fires, that delivery is gone. Treat webhooks as the fast path and run a scheduled sync of everything that changed as the safety net. Between the two, nothing is missed.

    One webhook URL per account

    There is no per event routing yet. Every event your key can reach posts to the same URL, and the event ID travels on the payload so you can route it once it arrives.

    Keep exploring

    What the API works with

    Event check-in

    Before you build your own door app, see what the built-in one already does. Most teams use both: our scanners at the main door, their own tool for a special case.

    Explore event check-in

    Guest list

    Bringing a list in rather than pulling one out? Import your guests and send every one of them a real ticket, with no code at all.

    See the guest list

    Box office and POS

    Door sales made at the box office flow through the same order data your integration reads, so walk-ups appear in your systems too.

    See the box office

    Everything else included

    The API is one of 100+ tools: reserved seating, fundraising, check-in, marketing, and reporting, all in one login.

    See all features
    Questions

    The Developer API, answered

    Who can use the Developer API?
    It is in private beta right now, so it is switched on per account. Ask for access and our team will enable it for you, then your Developer Portal opens up under My Account with everything you need to start.
    What can the API actually do?
    Three things. It reads your event list, it reads your attendee list, and it checks a guest in. Everything else on the platform stays where it is: you cannot create events, issue tickets, or process refunds through the API.
    How do I get a key?
    From the Credentials tab of your Developer Portal. Click to generate one and copy it right away, because it is shown a single time. We store only a hashed copy, so nobody, including us, can read it back to you later.
    What happens if a key gets out?
    Generate a new one from the same screen. The old key keeps working for 24 hours so your apps keep running while you swap it over, then it stops working on its own.
    How many requests can I make?
    Up to 60 a minute for your account. A normal sync uses a tiny fraction of that, because you can ask for only the attendees who changed since your last call instead of downloading the whole list every time.
    Can I test without checking real guests in?
    Yes. Send the test-mode header with your check-in call and it runs the full validation, tells you exactly what would have happened, and writes nothing. Nothing appears on anyone's screen.
    How do webhooks work?
    You save one URL in your portal. We post to it when an order completes, when an order or a single ticket is refunded, and when a guest's details or check-in state change. Each delivery is signed with your own secret so your listener can verify it really came from us.
    What if my server is down when a webhook fires?
    That delivery is missed. There are no retries, on purpose, because a retry queue behind a slow listener would hold up the checkout everyone else is waiting on. The fix is a safety net rather than a workaround: ask the attendees endpoint for everything that changed since your last successful sync, on a schedule, and nothing is ever lost.
    Can I send different events to different URLs?
    Not today. There is one webhook URL per account and it receives everything your key can reach. Most teams route by the event ID on the payload once it arrives.
    Does a check-in from my app show up on your screens?
    Immediately, on every device already watching that event: the check-in page, the scanner, the guest list, and the bulk editor. It is treated exactly like a scan made in our own app.
    Can my team members have their own keys?
    Yes, and you decide who. The Permissions tab lets you allow a whole role or specific people. Allowing someone never widens which events they can see, so a member assigned to two events still reaches only those two.
    Where do I find the technical documentation?
    In the Documentation tab of your portal, in the full guide in our help center, and as a Postman collection you can import and run against your own account in about a minute.

    Put your event data to work.

    The Developer API is in private beta. Tell us what you want to build and we will switch it on for your account.

    Request access See all features