FinancialsEvent Costs

Event Costs

Retrieve Event Costs #

Method
GET
Endpoint

Retrieves the costs recorded on your Events.

Parameters
Name Type Required? Description Details
filter_by_event_id Number No
Return costs for this Event only. Omit to return costs for all Events that match the other filters.
filter_by_event_start_date_greater_than_or_equal_to Date No
Include Events that start on or after this date.
Use YYYY-MM-DD.
filter_by_event_start_date_smaller_than_or_equal_to Date No
Include Events that start on or before this date.
Use YYYY-MM-DD.
filter_by_event_end_date_greater_than_or_equal_to Date No
Include Events that end on or after this date.
Use YYYY-MM-DD.
filter_by_event_end_date_smaller_than_or_equal_to Date No
Include Events that end on or before this date.
Use YYYY-MM-DD.
filter_by_event_start_date_category String No
Choose all for every Event, upcoming for Events that end today or later (including Events in progress), or past for Events that ended before today. A year selects Events that start in that calendar year. Today is based on your workspace's time zone. When you use this filter, the four date filters are ignored. Category values are case-insensitive and ignore surrounding spaces. See GET /v1/references/event_start_date_categories for your workspace's categories.
Allowed values: all | upcoming | past | a year such as 2026
filter_by_budget_year Number No
Include Events that start in this fiscal year, using the same fiscal-year start month as Annual Budgets. Events must also match any start or end date filters you supply. Use either this filter or filter_by_event_start_date_category. If the date bounds don't overlap, the response contains an empty list and a warning.
A four-digit year such as 2026.
$limit Number No
The maximum number of cost records to return. Omit to return all remaining matches. Use $offset for paging. total_records and the X-Total-Count header give the full count. has_more tells you whether more records are available.
A whole number of 1 or more.
$offset Number No
How many cost records to skip. For the next page, add the number of records you received to the current offset.
A whole number of 0 or more. Default 0.
$result_format String No
By default, the response is an object containing list_data and the paging totals (records_found, total_records, has_more). Send array to get just a JSON array of the records, or wrapped_in_array to get the default object inside a one-item array.
Allowed values: array | wrapped_in_array
$on_error_return_empty_result Boolean No
Set to true to return HTTP 200 with an empty list when an ID, date filter or paging value is invalid, or when the Event doesn't exist. Authentication, rate-limit and unexpected server errors keep their normal HTTP status.
Default: false.

Good to know

Retrieves the costs recorded on your Events, one record per cost. The list includes costs on hidden Event tabs. Filter by Event ID, Event dates, a start-date category, or a fiscal budget year.

Cost types

For Booth Services, cost_subtype gives the selected service type, including "Other" when that is the selected type. For Event Activities, it gives the activity type or category, such as "Presentation (Other)". It returns null for Booth Services without a type, General or unspecified Event Activities, and other cost types. The details field describes the individual item.

Code Samples
curl -X GET "https://api.exhibitday.com/v1/financials/event_costs" -H "Authorization: Bearer YOUR_API_KEY"

Example response

{
  "records_found": 1,
  "total_records": 1,
  "has_more": false,
  "list_type": "event_cost",
  "list_data": [
    {
      "id": 12345,
      "cost_type_id": 6,
      "cost_type": "Miscellaneous Expense/Credit",
      "cost_subtype": null,
      "details": "Sample expense",
      "cost": {
        "amount": 125.50,
        "cost_center_breakdown": [
          {
            "cost_center_id": null,
            "cost_center": "Not Specified",
            "charge": 125.50
          }
        ]
      },
      "amount": 125.50,
      "amount_cost_center_breakdown": [
        {
          "cost_center_id": null,
          "cost_center": "Not Specified",
          "charge": 125.50
        }
      ],
      "payment_due_date": "",
      "payment_status": {
        "id": 0,
        "name": "Not Specified"
      },
      "next_payment_due_date": "",
      "payment_notes": "",
      "event": {
        "id": 12345,
        "exhibitday_url": "https://www.exhibitday.com/Workspace/Event/98765?eid=12345",
        "name": "Sample Event",
        "start_date": "2026-12-19",
        "end_date": "2026-12-21",
        "participation_type_id": 1,
        "participation_type": "Committed",
        "format_id": 1,
        "format": "In-Person",
        "event_created_timestamp": "2026-11-19T17:00:00Z",
        "event_last_update_timestamp": "2026-11-19T17:00:00Z"
      }
    }
  ]
}
Note: IDs are illustrative; use IDs from your workspace.