---
title: "Retrieve Event Costs"
method: GET
path: "/v1/financials/event_costs"
tags: ["Financials"]
---

# Retrieve Event Costs

`GET /v1/financials/event_costs`

## Request

- Base URL: `https://api.exhibitday.com`
- URL: `https://api.exhibitday.com/v1/financials/event_costs`
- Auth: one of:
  - API key in header `api_key`
  - API key in query parameter `api_key`

If a specific Event Id is passed in (using the "filter_by_event_id" parameter), then only the costs for that event are returned. Otherwise, all costs for all events are returned. The "cost_subtype" property contains the selected Booth Service type or the Event Activity type. Other Booth Services use "Other"; Other activities use their category name, including "Presentation (Other)". General activities and other cost types return null. The subtype is separate from "details", which describes the item.

Documentation: https://api.exhibitday.com/Help/V1?epf=4#get-v1-financials-event_costs

## Query parameters

- `filter_by_event_id` integer
- `filter_by_event_start_date_greater_than_or_equal_to` string, date
- `filter_by_event_start_date_smaller_than_or_equal_to` string, date
- `filter_by_event_end_date_greater_than_or_equal_to` string, date
- `filter_by_event_end_date_smaller_than_or_equal_to` string, date
- `filter_by_event_start_date_category` string
- `$limit` integer
- `$offset` integer
- `$result_format` string
- `$on_error_return_empty_result` boolean

## Headers

- `If-None-Match` string

## Response `200`

OK

- EventCostsList, nullable
  - `records_found` integer
  - `total_records` integer
  - `has_more` boolean
  - `list_type` string, nullable
  - `list_data` EventCost[], nullable
    - `id` integer
    - `cost_type_id` integer
    - `cost_type` string, nullable
    - `cost_subtype` string, nullable
    - `details` string, nullable
    - `amount` number
    - `amount_cost_center_breakdown` CostCenterBreakdown[], nullable
      - `cost_center_id` integer, nullable
      - `cost_center` string, nullable
      - `charge` number
    - `payment_due_date` string, nullable
    - `payment_status` PaymentStatusReferenced, nullable
      - `id` integer
      - `name` string, nullable
    - `next_partial_payment_due_date` string, nullable
    - `payment_notes` string, nullable
    - `event` EventReferenced, nullable
      - `id` integer
      - `exhibitday_url` string, nullable
      - `name` string, nullable
      - `start_date` string, nullable
      - `end_date` string, nullable
      - `participation_type_id` integer
      - `participation_type` string, nullable
      - `format_id` integer
      - `format` string, nullable
      - `event_created_timestamp` string, date-time, nullable
      - `event_last_update_timestamp` string, date-time

## Other responses

- `304`: Not Modified: If-None-Match named the current ETag, so there is no body.
- `400`: Bad Request: a missing or invalid parameter, or a change that is not allowed (error_code says which).
- `401`: Unauthorized: the api_key is missing or invalid, or API access is not enabled for the workspace.
- `404`: Not Found: no object with that id in your workspace, or an unknown URL or method.
- `429`: Too Many Requests: the rate limit was exceeded.
- `500`: Unexpected Internal Error.

---

[API](https://skmtc.dev/exhibitday/apis/exhibitday-api.md) · [All operations](https://skmtc.dev/exhibitday/apis/exhibitday-api/llms.txt) · [OpenAPI document](https://skmtc.dev/exhibitday/apis/exhibitday-api/revisions/a35e95422b0a?raw)