Get Event

Get Event

curl --request GET \
  --url https://app.flashquotes.com/api/events/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://app.flashquotes.com/api/events/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.flashquotes.com/api/events/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.flashquotes.com/api/events/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.flashquotes.com/api/events/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "object": "event",
  "id": "evt_8K3aN1qV2x",
  "name": "Acme launch party",
  "clientName": "Jane Doe",
  "clientEmail": "[email protected]",
  "clientPhone": "+15555550123",
  "serviceStartTime": "2026-06-12T18:00:00.000Z",
  "serviceEndTime": "2026-06-12T23:00:00.000Z",
  "staffNumber": 4,
  "resourceNumber": 2,
  "guestCount": 120,
  "companyId": "cmp_a1b2c3",
  "locationId": "loc_7H2pQ9",
  "bookingId": "bkg_4F2yL8",
  "eventBriefId": "ebf_3R9wM1",
  "eventBriefUrl": "https://app.flashquotes.com/event-briefs/ebf_3R9wM1",
  "multiDay": false,
  "tipJarAllowed": true,
  "outdoors": false,
  "createdAt": "2026-05-01T14:23:11.000Z",
  "updatedAt": "2026-05-08T09:12:44.000Z"
}

GET

events

{id}

Get Event

curl --request GET \
  --url https://app.flashquotes.com/api/events/{id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://app.flashquotes.com/api/events/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.flashquotes.com/api/events/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.flashquotes.com/api/events/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.flashquotes.com/api/events/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "object": "event",
  "id": "evt_8K3aN1qV2x",
  "name": "Acme launch party",
  "clientName": "Jane Doe",
  "clientEmail": "[email protected]",
  "clientPhone": "+15555550123",
  "serviceStartTime": "2026-06-12T18:00:00.000Z",
  "serviceEndTime": "2026-06-12T23:00:00.000Z",
  "staffNumber": 4,
  "resourceNumber": 2,
  "guestCount": 120,
  "companyId": "cmp_a1b2c3",
  "locationId": "loc_7H2pQ9",
  "bookingId": "bkg_4F2yL8",
  "eventBriefId": "ebf_3R9wM1",
  "eventBriefUrl": "https://app.flashquotes.com/event-briefs/ebf_3R9wM1",
  "multiDay": false,
  "tipJarAllowed": true,
  "outdoors": false,
  "createdAt": "2026-05-01T14:23:11.000Z",
  "updatedAt": "2026-05-08T09:12:44.000Z"
}

Retrieves the event with the given id. By default the response includes the event’s own scalar fields plus the foreign-key ids for related objects (bookingId, locationId, eventBriefId). Relations are inlined only when requested via expand[]. Pass one or more expand[] query parameters to inline related objects. On this endpoint, paths are written as-is — no prefix.

curl "https://app.flashquotes.com/api/events/evt_8K3aN1qV2x?expand[]=booking.lead&expand[]=services" \
  -H "x-api-key: $FLASHQUOTES_API_KEY"

Allow-listed expand paths:

Path	Adds
`location`	The event’s `location` object
`services`	The event’s `services` array
`staff`	The event’s `staff` array
`addons`	The event’s `addons` array
`resources`	The event’s `resources` array
`checklists`	The event’s checklists, without tasks
`checklists.tasks`	`tasks` inside each checklist (auto-promotes `checklists`)
`booking`	The parent `booking` object
`booking.lead`	`lead` inside `booking` (auto-promotes `booking`)
`booking.eventType`	`eventType` inside `booking` (auto-promotes `booking`)
`booking.invoices`	`invoices` array inside `booking` (auto-promotes `booking`)
`booking.formResponse`	Booking form answers inside `booking`, or `null` (auto-promotes `booking`)

Requesting any nested booking.* path automatically expands booking itself — you do not need to list booking separately.

Expanded response

With expand[]=booking.lead&expand[]=booking.invoices, the response inlines the nested objects under booking:

{
  "object": "event",
  "id": "evt_8K3aN1qV2x",
  "booking": {
    "object": "booking",
    "id": "bkg_4F2yL8",
    "lead": {
      "object": "lead",
      "id": "led_2T7nC4",
      "companyName": "Acme",
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "[email protected]",
      "source": "Website"
    },
    "invoices": [
      {
        "object": "invoice",
        "id": "inv_9P5xK3",
        "status": "Paid",
        "subtotal": 225000,
        "gratuityAmount": 20000,
        "discountAmount": 10000,
        "serviceChargeAmount": 0,
        "taxAmount": 15000,
        "total": 250000,
        "amountPaid": 250000,
        "amountDue": 0,
        "url": "https://app.flashquotes.com/invoice/..."
      }
    ]
  }
}

Invoice totals

Each invoice breaks its total into parts. All amounts, including total, are integers in cents.

Field	Includes
`subtotal`	Line items, excluding gratuity
`gratuityAmount`	Gratuity line items
`serviceChargeAmount`	Service charges
`discountAmount`	Discount, subtracted from the total
`taxAmount`	Tax

subtotal + gratuityAmount + serviceChargeAmount - discountAmount + taxAmount = total. These match the columns in the invoice CSV export.

Booking form answers

booking.formResponse returns the answers your customer gave on your booking form. It’s null when the booking has no booking form response, for example when it was booked without the booking form. Lead intake form answers aren’t included.

curl "https://app.flashquotes.com/api/events/evt_8K3aN1qV2x?expand[]=booking.formResponse" \
  -H "x-api-key: $FLASHQUOTES_API_KEY"

{
  "object": "event",
  "id": "evt_8K3aN1qV2x",
  "booking": {
    "object": "booking",
    "id": "bkg_4F2yL8",
    "formResponse": {
      "object": "formResponse",
      "id": "frs_7Q1mB6",
      "formId": "frm_3K8pD2",
      "createdAt": "2026-10-20T17:42:10.000Z",
      "updatedAt": "2026-10-20T17:45:03.000Z",
      "formQuestionResponses": [
        {
          "id": "fqr_5H2nV9",
          "response": "150",
          "question": { "id": "fq_1C4rT7", "title": "Guest count", "type": "NUMBER" }
        },
        {
          "id": "fqr_8L6wP3",
          "response": "yes",
          "question": { "id": "fq_9M2kX5", "title": "Indoor venue?", "type": "YESNO" }
        }
      ]
    }
  }
}

Answers are in form order: by page, then by question. Blank answers are left out.
response is the answer as stored, which can differ from how the dashboard shows it. Yes/no answers are "yes" or "no", and dates are yyyy-MM-dd.
Answers to questions you’ve since deleted from the form are still included.
To look up answers by booking ID, use List Events.

Checklists and tasks

checklists.tasks returns the event’s checklists with their tasks. Use it to send prep lists, packing amounts, or admin to-dos to another tool.

curl "https://app.flashquotes.com/api/events/evt_8K3aN1qV2x?expand[]=checklists.tasks" \
  -H "x-api-key: $FLASHQUOTES_API_KEY"

{
  "object": "event",
  "id": "evt_8K3aN1qV2x",
  "checklists": [
    {
      "object": "checklist",
      "id": "chk_5N8vR2",
      "name": "Bar service",
      "type": "STAFF",
      "eventId": "evt_8K3aN1qV2x",
      "createdAt": "2026-05-01T14:23:11.000Z",
      "updatedAt": "2026-05-01T14:23:11.000Z",
      "tasks": [
        {
          "object": "task",
          "id": "tsk_2W6hJ4",
          "checklistId": "chk_5N8vR2",
          "description": "Load ice",
          "quantity": 4,
          "unit": "bags",
          "dueDate": null,
          "completedAt": null,
          "createdAt": "2026-05-01T14:23:11.000Z",
          "updatedAt": "2026-05-01T14:23:11.000Z"
        }
      ]
    },
    {
      "object": "checklist",
      "id": "chk_9D3kF7",
      "name": "Admin",
      "type": "ADMIN",
      "eventId": "evt_8K3aN1qV2x",
      "createdAt": "2026-05-01T14:23:11.000Z",
      "updatedAt": "2026-05-01T14:23:11.000Z",
      "tasks": [
        {
          "object": "task",
          "id": "tsk_6P1xQ8",
          "checklistId": "chk_9D3kF7",
          "description": "Confirm final guest count",
          "quantity": null,
          "unit": null,
          "dueDate": "2026-06-05T00:00:00.000Z",
          "completedAt": "2026-06-04T16:10:02.000Z",
          "createdAt": "2026-05-01T14:23:11.000Z",
          "updatedAt": "2026-06-04T16:10:02.000Z"
        }
      ]
    }
  ]
}

Each checklist’s type tells you where it shows up in Flashquotes:

`type`	Checklist	Where it appears
`STAFF`	Event brief checklist	The event brief your team sees
`ADMIN`	Admin checklist	The Tasks section on the event

There’s no type query parameter. Filter the checklists array in your code. For example, to keep only event brief checklists:

curl "https://app.flashquotes.com/api/events/evt_8K3aN1qV2x?expand[]=checklists.tasks" \
  -H "x-api-key: $FLASHQUOTES_API_KEY" \
  | jq '.checklists[] | select(.type == "STAFF")'

An event can have more than one checklist of each type.
Checklists are oldest first. Deleted checklists are left out.
Event brief tasks are in brief order: by stage, then by position within the stage.
quantity and unit hold optional amounts, such as 4 and "bags". Both are null when not set.
completedAt is when the task was checked off, or null when it’s not done.
A checklist with no tasks returns "tasks": []. Without checklists.tasks, checklists have no tasks field.

Limits

Maximum 20 expand paths per request (duplicates are deduplicated).
Maximum nesting depth of 4 segments.
Unknown or malformed paths return 400.

Authorizations

x-api-key

string

header

required

API key for authentication

Path Parameters

string

required

The event id.

Query Parameters

expand[]

string[]

Inline related objects. Allow-listed paths: location, services, staff, addons, resources, checklists, checklists.tasks, booking, booking.lead, booking.eventType, booking.invoices, booking.formResponse. Requesting any booking.* path auto-promotes booking, and checklists.tasks auto-promotes checklists. Max 20 paths, max depth 4.

Response

Event retrieved successfully

Default response includes only the fields below plus foreign-key ids (bookingId, locationId, eventBriefId). Related objects (location, services, staff, addons, resources, checklists, booking) appear only when requested via expand[].

object

enum<string>

required

Available options:

event

string

required

locationId

string

required

bookingId

string | null

required

name

string

clientName

string

clientEmail

string

clientPhone

string

siteContactName

string

siteContactPhone

string

eventDescription

string

eventAddress

string

additionalLocationInfo

string

specialNotes

string

parkingLoadingInfo

string

serviceStartTime

string<date-time>

serviceEndTime

string<date-time>

staffNumber

integer

resourceNumber

integer

companyId

string

eventBriefId

string | null

eventBriefUrl

string | null

Public URL to view the event brief, or null if no brief exists.

createdAt

string<date-time>

updatedAt

string<date-time>

staffDressCode

string | null

customData

any

Arbitrary JSON metadata attached to the event.

multiDay

boolean

guestCount

integer | null

loadingTime

integer | null

Minutes.

setupTime

integer | null

Minutes.

breakdownTime

integer | null

Minutes.

unloadingTime

integer | null

Minutes.

shiftStartTime

string<date-time> | null

shiftEndTime

string<date-time> | null

specialPrepTime

integer | null

Minutes.

travelToEventTime

integer | null

Minutes.

travelFromEventTime

integer | null

Minutes.

tipJarAllowed

boolean

outdoors

boolean

location

object

Present only when expand[]=location (or data.location on list).

Show child attributes

services

object[]

Present only when expanded.

Show child attributes

staff

object[]

Present only when expanded.

Show child attributes

addons

object[]

Present only when expanded.

Show child attributes

resources

object[]

Present only when expanded.

Show child attributes

checklists

object[]

Present only when checklists or checklists.tasks is expanded. The event's admin and event brief checklists, oldest first. Deleted checklists are left out.

Show child attributes

booking

object

Present only when expanded (auto-promoted by any booking.* expand).

Show child attributes

API Documentation

Quotes

Events

Tasks

Form Responses

Staff

Invoices

Resources

Expanded response

Invoice totals

Booking form answers

Checklists and tasks

Limits

Authorizations

Path Parameters

Query Parameters

Response

​Expanding related objects

​Expanded response

​Invoice totals

​Booking form answers

​Checklists and tasks

​Limits

Authorizations

Path Parameters

Query Parameters

Response

Expanding related objects

Expanded response

Invoice totals

Booking form answers

Checklists and tasks

Limits