# ExhibitDay API > REST API for ExhibitDay, a trade show and event management platform. Use it to read data from an ExhibitDay workspace or push data into it. - Base URL: https://api.exhibitday.com/v1 - Authentication: send the workspace API key as `Authorization: Bearer YOUR_API_KEY`. `X-API-Key` and the legacy `api_key` parameter still work. Find the key under Workspace Settings > API & Integrations > API Access. - Rate limit: 50 calls per second per workspace by default. Workspace rate checks return `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (seconds) headers; a separate IP rate check can refuse a request before those headers are added. A 429 response carries `Retry-After` (seconds). Use the returned limit and retry headers rather than assuming a fixed allowance. - Error responses are JSON with `status_code`, `status`, `message`, `errors`, a stable `error_code`, `error_params` (the parameters the errors refer to), `request_id` (also in the X-Request-Id header) and, when applicable, `warnings`. Successful object responses also include warnings for unknown, unsupported, ignored or defaulted parameters, and for empty values sent on an update. On a create, an empty value means no value and gets no warning. Warnings can also report attachments that could not be copied to an inventory return. - Successful warnings: arrays and 304 responses retain their shape and expose a JSON-array `X-API-Warnings` header. `X-API-Warnings-Count` gives the full count; `X-API-Warnings-Truncated: true` means the 6000-character ASCII header limit was reached. Request the default object format for the full warning list. Invalid values that would be stored return 400. - Lists: use `$limit` and `$offset` on endpoints that support paging (responses include `total_records` and `has_more`). Use `filter_by_last_update_timestamp_greater_than_or_equal_to` where supported to retrieve changes; upsert every returned record by ID, including records at the inclusive timestamp boundary. - Retries: send an `Idempotency-Key` header with a create (POST). Successful responses are retained for 24 hours; retry the same request with the same byte-identical, case-sensitive key during that period to reuse the saved response. Follow the documented 409 handling when a request is still running or its outcome is unknown. DELETE has no idempotency replay contract; after an uncertain response, retrieve the record first and treat a later `not_found` as already absent. Successful API GET responses that return JSON include an `ETag` for `If-None-Match`; file downloads do not. - HTTP methods: send actual documented verbs. Method tunneling is refused with 400 `invalid_request` on every endpoint: `X-HTTP-Method-Override` as a header, a form field or a query-string parameter, and form/query `_method` (a request with no API key in a header, the query string or a form field gets 401 first; a request with a JSON body gets 400, because its key may be inside the body). - Updates: on PATCH requests, omit fields you want to keep. Empty or whitespace-only update values are ignored with a warning. A JSON null or the text `null` clears or resets a supported field; fields that cannot be cleared return an error. The legacy `$ignore_params_with_empty_values=true` option drops empty values and JSON nulls before updates; the text `null` still requests a clear. Related fields can also change to keep the record consistent; see the endpoint's field rules. To update only if none of the fields that PATCH can change has changed since you read the record, read it with `$include_record_revision=true` and send the returned `record_revision` as `expected_revision` (the help page lists what each revision covers; a change undone in between does not count); a 409 `record_changed` then means nothing was saved: read it again and decide whether to send your change again. After no response or a 5xx on a PATCH, read the record before sending it again: it may already have been saved. ## Docs - [Getting started](https://api.exhibitday.com/Help/V1.md): passing parameters, updating and clearing values, authentication and response codes - [Events](https://api.exhibitday.com/Help/V1.md?epf=1): Create, read, update, copy and delete Events, with their file attachments and exports. - [Events - Booth Services](https://api.exhibitday.com/Help/V1.md?epf=1&topic=booth-services): Booth Services on an Event: their details and costs, invoices, file attachments and exports. - [Events - Staff](https://api.exhibitday.com/Help/V1.md?epf=1&topic=staff): Event Staff (attendees and registrations): roles, registration details and costs, invoices, file attachments and exports. - [Events - Travel Reservations](https://api.exhibitday.com/Help/V1.md?epf=1&topic=travel-reservations): Travel Reservations on an Event: transportation and lodging bookings, tagged people, costs, invoices, file attachments and exports. - [Events - Giveaways](https://api.exhibitday.com/Help/V1.md?epf=1&topic=giveaways): Giveaways on an Event: supplier and inventory sources, distribution details, costs, invoices, file attachments and exports. - [Events - Shipments](https://api.exhibitday.com/Help/V1.md?epf=1&topic=shipments): Shipments on an Event: components, carrier and delivery details, costs, invoices, file attachments and exports. - [Events - Sponsorships](https://api.exhibitday.com/Help/V1.md?epf=1&topic=sponsorships): Sponsorships on an Event: their details and costs, invoices, file attachments and exports. - [Events - Playbook](https://api.exhibitday.com/Help/V1.md?epf=1&topic=playbook): The Event Playbook: scheduled activities, activity costs, invoices, file attachments and exports. - [Events - Misc. Expenses & Credits](https://api.exhibitday.com/Help/V1.md?epf=100): Miscellaneous expenses and credits on an Event: amounts, invoices, file attachments and exports. - [Events - Objectives](https://api.exhibitday.com/Help/V1.md?epf=1&topic=objectives): Event Objectives: their type, importance and achievement ratings. - [Events - Related Tasks & Items](https://api.exhibitday.com/Help/V1.md?epf=1&topic=related-tasks-and-items): Links between Tasks and Event items: read, link and unlink them by their typed keys. - [Events - Logs](https://api.exhibitday.com/Help/V1.md?epf=1&topic=logs): The activity history of one Event. - [Tasks](https://api.exhibitday.com/Help/V1.md?epf=2): Create, read, update and delete Tasks and Task Sections, import Tasks from another Event, and work with Task file attachments and exports. - [Tasks - Comments](https://api.exhibitday.com/Help/V1.md?epf=2&topic=comments): Comments on a Task: read, add, update and delete them. - [Tasks - Logs](https://api.exhibitday.com/Help/V1.md?epf=2&topic=logs): The activity history of one Task. - [Assets](https://api.exhibitday.com/Help/V1.md?epf=5): Create, read, update, archive and restore Assets, with their custom file attachments. - [Assets - Storage Locations](https://api.exhibitday.com/Help/V1.md?epf=5&topic=storage-locations): Storage Locations: where Assets are kept, the Capital Assets and Collateral transactions at each, and their logs. - [Assets - Inventory Adjustments](https://api.exhibitday.com/Help/V1.md?epf=5&topic=inventory-adjustments): Manual inventory increases and decreases: read, add, update and delete them. - [Assets - Availability](https://api.exhibitday.com/Help/V1.md?epf=5&topic=availability): Check an Asset's available dates and quantities before reserving it. - [Assets - Reservations](https://api.exhibitday.com/Help/V1.md?epf=5&topic=reservations): Asset Reservations for Events: add, update and cancel them, see the cancellation options, and work with their file attachments. - [Assets - Logistical Records](https://api.exhibitday.com/Help/V1.md?epf=5&topic=logistical-records): Logistical records on Asset Reservations: read, add, update and remove them. - [Assets - Pull Sheet](https://api.exhibitday.com/Help/V1.md?epf=5&topic=pull-sheet): Create a PDF or Word Pull Sheet for an Event's Asset Reservations. - [Assets - Images](https://api.exhibitday.com/Help/V1.md?epf=5&topic=images): An Asset's gallery images: view, add, download, delete and reorder them. - [Assets - Logs](https://api.exhibitday.com/Help/V1.md?epf=5&topic=logs): The activity history of one Asset. - [Financials](https://api.exhibitday.com/Help/V1.md?epf=4): Annual budgets, the annual budget allocation export and costs by Cost Center. - [Financials - Event Costs](https://api.exhibitday.com/Help/V1.md?epf=4&topic=event-costs): Event cost lines for reports and integrations, with an export. - [Financials - Misc. Annual Expenses](https://api.exhibitday.com/Help/V1.md?epf=4&topic=misc-annual-expenses-credits): Annual miscellaneous expenses: the entries and their costs. - [References](https://api.exhibitday.com/Help/V1.md?epf=3): Lookup lists such as cost centers, custom fields, tags, types, statuses, and users and resources. - [Users & Resources](https://api.exhibitday.com/Help/V1.md?epf=6&topic=users): Workspace users and resources, their Event involvements and their activity. - [Workspace Settings - User Invitations](https://api.exhibitday.com/Help/V1.md?epf=6&topic=user-invitations): Invite users to your workspace, and read, re-send or revoke open invitations. - [Workspace Logs](https://api.exhibitday.com/Help/V1.md?epf=6&topic=logs): The workspace's activity history. - [Workspace Settings](https://api.exhibitday.com/Help/V1.md?epf=6): Read and update the permitted workspace settings and workspace information. ## Guides - [Create or Update Events from Your CRM](https://api.exhibitday.com/Help/V1.md?guide=event-setup-crm): Create an Event from a CRM record (for example Salesforce, HubSpot or Zoho CRM), or update the Event already linked to it. - [Get a Complete List of Attendees, Travel and More](https://api.exhibitday.com/Help/V1.md?guide=find-filter-page): Pull a complete filtered list, such as everyone registered or traveling for a show, page by page. - [Avoid Overwriting Someone Else's Changes](https://api.exhibitday.com/Help/V1.md?guide=update-records-safely): Update a record only if nobody else changed it since you read it. - [Link ExhibitDay Events to Your CRM or ERP Records](https://api.exhibitday.com/Help/V1.md?guide=match-records): Link each record in your CRM or ERP (for example Salesforce, HubSpot or NetSuite) to the matching ExhibitDay Event, even after names change. - [Set an Event's Exhibit Hall Dates and Hours](https://api.exhibitday.com/Help/V1.md?guide=dates-times-time-zones): Set an Event's Exhibit Hall days, hours and time zone, then confirm them. - [Reserve Assets (Equipment and Materials) for an Event](https://api.exhibitday.com/Help/V1.md?guide=reserve-change-cancel-assets): Reserve equipment or materials for an Event, change the reservation, and see what canceling would do. - [Update Collateral Stock After a Delivery or Recount](https://api.exhibitday.com/Help/V1.md?guide=collateral-inventory-storage): Record a stock delivery or recount for Collateral at a Storage Location. - [Add Attendees and Their Travel Reservations to an Event](https://api.exhibitday.com/Help/V1.md?guide=staff-travel-tags): Register a person for an Event and record their hotel, then list everything for that person. - [Update Shipment Tracking and Status Automatically](https://api.exhibitday.com/Help/V1.md?guide=shipment-tracking): Add tracking numbers and Shipped status to Event Shipments from your shipping system or carrier (for example FedEx or UPS). - [Record Show Results: Leads and Objective Ratings](https://api.exhibitday.com/Help/V1.md?guide=show-results-objectives): Record a show's lead count and how well an Objective was met. - [Copy Tasks from a Previous Event](https://api.exhibitday.com/Help/V1.md?guide=reuse-event-plan): Copy last year's Tasks into this year's Event instead of rebuilding the checklist. - [Search Activity Audit Logs to See Who Changed What, and When](https://api.exhibitday.com/Help/V1.md?guide=workspace-activity): See who changed what and when, for audits, investigations or monitoring. - [Keep Another System Updated with Event and Task Changes](https://api.exhibitday.com/Help/V1.md?guide=sync-changes): Keep a copy of your Events and Tasks in another system, refreshed with only what changed. - [Record Costs and Split Them Across Cost Centers](https://api.exhibitday.com/Help/V1.md?guide=entering-costs): Record a cost on a record, and optionally split it across cost centers. - [Export Event Costs to Excel or a Reporting Tool](https://api.exhibitday.com/Help/V1.md?guide=export-event-costs): Save your Event costs to a CSV for Excel, Google Sheets, Power BI or another reporting tool. - [Create Tasks from Forms, Tickets or Other Apps](https://api.exhibitday.com/Help/V1.md?guide=create-tasks): Turn a form, ticket or plan item from another app (for example Google Forms, Zendesk or Jira) into an Event Task. - [Fill In Your Custom Event Fields from Another System](https://api.exhibitday.com/Help/V1.md?guide=custom-fields): Fill in or read your workspace's own Event fields from another system. - [Handle Errors and Retry Failed Requests](https://api.exhibitday.com/Help/V1.md?guide=errors-and-retries): Know what to do when a request fails: fix it, wait and retry, or check whether it already worked. ## Machine-readable - [OpenAPI 3.0 description](https://api.exhibitday.com/openapi.json): every endpoint with its parameters and response schemas - [OpenAPI 3.0 description without code samples](https://api.exhibitday.com/openapi.json?code_samples=false): the same description without the code samples, for faster imports - [Full documentation](https://api.exhibitday.com/llms-full.txt): the reference and guides in one Markdown file, with examples in curl, JavaScript, Python, C#, Java, PHP, Ruby and Go - [Postman collection (JSON)](https://api.exhibitday.com/postman_collection.json): every endpoint as a Postman v2.1 collection, organized like the help pages, with sample values and saved responses - [API catalog](https://api.exhibitday.com/.well-known/api-catalog): RFC 9727 links to the API descriptions and documentation - [Swagger 2.0 definition](https://api.exhibitday.com/swagger/docs/v1) - [Swagger UI](https://api.exhibitday.com/swagger/ui/index) - [Postman collection](https://www.postman.com/exhibitday/exhibitday-api/overview) ## Optional - [ExhibitDay](https://www.exhibitday.com/)