Travel Reservations
Retrieve a Single Travel Reservation by ID #
|
Sample Object
|
Retrieves a single Travel Reservation by its ID.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the Travel Reservation.
|
Use the id from Retrieve Travel Reservations (GET /v1/events/travel_reservations) or from the add response. You don't send the Event ID; the record's Event is found automatically.
|
| $result_format | String | No |
By default, the response is a single object. Send
array to get it inside a one-item array.
|
Allowed values:
array | object |
| $include_record_revision | Boolean | No |
Whether to include record_revision in the response.
|
Default: false. Send true to get record_revision, then send that value as expected_revision when you update this reservation. See What $include_record_revision covers below.
|
| $on_error_return_empty_result | Boolean | No |
Whether an invalid or unavailable reservation should return an empty result.
|
Default: false. True returns HTTP 200 with {} (or [] for array format) for invalid IDs or an unavailable reservation. API key errors, conflicts with a change in progress, inconsistent invoice information and unexpected errors keep their normal status.
|
| If-None-Match | String | No |
An ETag from an earlier response to this GET.
|
Optional HTTP header. If the successful response is unchanged, the API returns HTTP 304 with no body.
|
Good to know
The response includes booking details, tagged people, costs and payment information.
What $include_record_revision covers
Setting $include_record_revision=true returns record_revision for use as expected_revision on a later update.
record_revision covers the saved reservation details, payment fields, cost allocations, tagged-person IDs, related-item links and Event binding. File Attachment or Invoice Attachment metadata/contents and notification delivery state are not included.
Files and access
Invoice Attachment metadata is included as invoice_attachment, or null if no invoice is attached. Supporting File Attachments have their own collection and download operation.
The Event's Travel Reservations tab must be available and readable. A locked tab can still be read. Inconsistent invoice information returns HTTP 409 instead of exposing another record's file.
Formatted text in the response
Notes and other rich-text values in the response contain the stored HTML, including encoded characters and line breaks such as <br />.
Open in ExhibitDay
Each record includes exhibitday_url, the record's page in ExhibitDay. It opens the record in view mode on its Event's tab. Sign in with an account that can view the record; ExhibitDay checks access when the link is opened.
curl -X GET "https://api.exhibitday.com/v1/events/travel_reservations/info?id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/info?" + new URLSearchParams({ "id": "12345" }), {
method: "GET",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.get(
"https://api.exhibitday.com/v1/events/travel_reservations/info",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"id": 12345},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.GetAsync("https://api.exhibitday.com/v1/events/travel_reservations/info?id=12345");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/info?id=12345"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/info?id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/info?id=12345')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/events/travel_reservations/info?id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"id": 12345,
"exhibitday_url": "https://www.exhibitday.com/Workspace/Event/98765?eid=23456&riType=9&riSub=0&riId=12345",
"event_id": 23456,
"event_name": "Sample Event",
"reservation_type_id": 1,
"booking_status_id": null,
"book_by_date": null,
"date_booked": null,
"booking_url": null,
"cancellation_instructions": null,
"vehicle_drop_off_location": null,
"reservation_number": "AB123",
"origin_vendor_name": "Example Airline",
"origin_flight_number": null,
"origin_reservation_item_info": null,
"origin_checkin_location": null,
"origin_checkin_date": "2027-02-03",
"origin_checkin_time": "09:30",
"origin_reservation_details": null,
"origin_destination_location": null,
"origin_destination_date": null,
"origin_destination_time": null,
"origin_reservation_final_details": null,
"return_vendor_name": null,
"return_flight_number": null,
"return_reservation_item_info": null,
"return_checkin_location": null,
"return_checkin_date": null,
"return_checkin_time": null,
"return_reservation_details": null,
"return_destination_location": null,
"return_destination_date": null,
"return_destination_time": null,
"return_reservation_final_details": null,
"origin_vendor_address": null,
"notes": "",
"payment_status_id": 0,
"payment_due_date": null,
"next_payment_due_date": null,
"payment_notes": null,
"invoice_attachment": {
"id": 882345,
"filename": "travel-reservation-invoice.pdf",
"attachment_created_timestamp": "2027-01-30T12:00:00Z"
},
"reservation_type": "Flight",
"reservation_group": "Transportation",
"booking_status": "Not Specified",
"payment_status": {
"id": 0,
"name": "N/A"
},
"cost": {
"amount": 200.00,
"cost_center_breakdown": [
{
"cost_center_id": 54321,
"cost_center": "Marketing",
"charge": 125.50
},
{
"cost_center_id": 54322,
"cost_center": "Operations",
"charge": 74.50
}
]
},
"tagged_users": [
{
"id": "11111111-2222-4333-8444-555555555551",
"first_name": "Alex",
"last_name": "Rivera",
"display_name": "Alex Rivera",
"email": "alex@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
},
{
"id": "11111111-2222-4333-8444-555555555552",
"first_name": "Jamie",
"last_name": "Chen",
"display_name": "Jamie Chen",
"email": "jamie@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
}
],
"created_by": {
"id": "11111111-2222-4333-8444-555555555555",
"first_name": "Jane",
"last_name": "Smith",
"display_name": "Jane Smith",
"email": "jane@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
},
"related_items": [
{
"id": 5551,
"related_item_id": 67890,
"related_item_exhibitday_url": "https://www.exhibitday.com/Workspace/TaskView/98765?tid=67890",
"related_item_type_id": 1,
"related_item_type": "Task",
"related_item_asset_type_id": null,
"related_item_name": "Confirm booth graphics with the printer",
"related_item_created_timestamp": "2030-01-10T14:03:00Z"
},
{
"id": 5552,
"related_item_id": 45678,
"related_item_exhibitday_url": "https://www.exhibitday.com/Workspace/RelatedItemView/98765?typeId=4&subTypeId=0&rid=45678",
"related_item_type_id": 4,
"related_item_type": "Shipment",
"related_item_asset_type_id": null,
"related_item_name": "Booth crates to convention center",
"related_item_created_timestamp": "2030-01-10T14:03:00Z"
}
]
}
{
"status_code": 400,
"status": "Bad Request",
"message": "X-HTTP-Method-Override: hTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The invoice attachment or its owning record changed or has conflicting saved information. Retrieve the current record before retrying.",
"error_code": "record_changed",
"errors": [
"The invoice attachment or its owning record changed or has conflicting saved information. Retrieve the current record before retrying."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back.",
"error_code": "record_changed",
"errors": [
"The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Retrieve Travel Reservations #
|
Retrieves Travel Reservations across the Events you can read.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| filter_by_event_id | Number | No |
Return records for this Event only. Omit for all readable Events in your workspace.
|
|
| filter_by_tagged_user_ids | String or JSON array | No |
Return records tagged with these users or resources. Send one user ID or an array of user IDs, for example "user-id" or ["user-id","other-user-id"]. Omit, leave blank or send [] for no tagged-user filter. Duplicate IDs collapse. Inactive and deactivated people, and people no longer in this workspace, still match the records they are tagged on; IDs never tagged in this workspace match nothing. Use filter_by_tagged_user_ids_match_type to require at least one or every selected person. This filter combines with the other filters before counting and paging.
View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
|
| filter_by_tagged_user_ids_match_type | String | No |
How to match the selected tagged people. Omit or leave blank to return records tagged with at least one selected person (the default), or require every selected person; records can have other tags too. This combines with the other filters before counting and paging. If filter_by_tagged_user_ids has no IDs, this option is ignored and the response includes a warning. Values are case-insensitive.
|
Allowed values:
any | all |
| $limit | Number | No |
The most Travel Reservations to return: a whole number of 1 or more. Omit it for all remaining matches; a blank value or null is refused, so leave the parameter out instead.
|
|
| $offset | Number | No |
How many matching Travel Reservations to skip: a whole number of 0 or more. Default: 0. A blank value or null is refused.
|
|
| $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 |
| hydrate_related_items | Boolean | No |
Set to true to include each record's related_items: the Tasks and items linked to it, with the key to use when adding or removing a link. Omit it or send false to leave related_items out of list results. Single-record GETs always include related_items.
|
Default: false.
|
Good to know
Retrieves records across your workspace's readable Event tabs. Use filter_by_event_id to narrow the results to one Event, or omit it for the workspace list. Each record includes its event_id and Event name. Use filter_by_tagged_user_ids to select tagged people or Resources. any is the default; all requires every selected ID and permits additional tags.
Choosing Events
Omit filter_by_event_id to retrieve records across readable Event tabs, or supply one Event ID to narrow the list. Each result retains its own event_id and Event name.
Hidden or unavailable Event tabs are not included. A locked tab can still be read. If no records match, the response is an empty list.
Filtering tagged people
filter_by_tagged_user_ids accepts one user ID string or an array. Set filter_by_tagged_user_ids_match_type=any (the default) to match at least one selected ID, or all to require every selected ID. Additional tags are allowed. Omit the IDs, leave them blank or send [] for no tag filter. Sending filter_by_tagged_user_ids_match_type without IDs is ignored with a warning.
Stored assignments and tags match directly: inactive and deactivated people, Resources and people no longer in this workspace still match the records they are on. IDs never used on this workspace's records match nothing; this is not an error. The people and Event filters combine with AND before counting and paging.
Reading pages
The Event filter and any people filter are applied before the total count and paging. Results are ordered by Event start date ascending, Event ID ascending, then Travel display order, then Travel ID descending.
Use $limit and $offset for successive pages. Omit $limit to return all remaining matches. total_records and X-Total-Count describe all matches; records_found counts this response.
Omit $result_format for the normal list wrapper. array returns only the records; wrapped_in_array places the normal wrapper in a one-item array.
Handling input and changes
Unrecognized parameters are ignored and listed in the X-API-Warnings response header. Conflicting or malformed filter values return HTTP 400; send arrays in JSON, query parameters or form fields rather than comma-bearing headers.
Current API access is checked even when the list is empty. A concurrent change can return HTTP 409; retrieve the list again. These filters retrieve records and do not change tags, assignments or notification settings.
Related items
Set hydrate_related_items=true to include each record's related_items: the Tasks and items linked to it. Add or remove links with POST and DELETE /v1/related_items. It is left out by default to keep lists fast. Retrieving one record always includes related_items.
Formatted text in the response
Notes and other rich-text values in the response contain the stored HTML, including encoded characters and line breaks such as <br />.
Events with a hidden Travel tab
Records on Events whose Travel tab is hidden are not listed. If filter_by_event_id names such an Event, the response is HTTP 200 with no records for it and a warning that names the tab and the Event.
Open in ExhibitDay
Each record includes exhibitday_url, the record's page in ExhibitDay. It opens the record in view mode on its Event's tab. Sign in with an account that can view the record; ExhibitDay checks access when the link is opened.
curl -X GET "https://api.exhibitday.com/v1/events/travel_reservations" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations", {
method: "GET",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.get(
"https://api.exhibitday.com/v1/events/travel_reservations",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.GetAsync("https://api.exhibitday.com/v1/events/travel_reservations");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/events/travel_reservations", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"list_type": "travel_reservation",
"list_data": [
{
"id": 12345,
"exhibitday_url": "https://www.exhibitday.com/Workspace/Event/98765?eid=23456&riType=9&riSub=0&riId=12345",
"event_id": 23456,
"event_name": "Sample Event",
"reservation_type_id": 1,
"booking_status_id": null,
"book_by_date": null,
"date_booked": null,
"booking_url": null,
"cancellation_instructions": null,
"vehicle_drop_off_location": null,
"reservation_number": "AB123",
"origin_vendor_name": "Example Airline",
"origin_flight_number": null,
"origin_reservation_item_info": null,
"origin_checkin_location": null,
"origin_checkin_date": "2027-02-03",
"origin_checkin_time": "09:30",
"origin_reservation_details": null,
"origin_destination_location": null,
"origin_destination_date": null,
"origin_destination_time": null,
"origin_reservation_final_details": null,
"return_vendor_name": null,
"return_flight_number": null,
"return_reservation_item_info": null,
"return_checkin_location": null,
"return_checkin_date": null,
"return_checkin_time": null,
"return_reservation_details": null,
"return_destination_location": null,
"return_destination_date": null,
"return_destination_time": null,
"return_reservation_final_details": null,
"origin_vendor_address": null,
"notes": "",
"payment_status_id": 0,
"payment_due_date": null,
"next_payment_due_date": null,
"payment_notes": null,
"invoice_attachment": {
"id": 882345,
"filename": "travel-reservation-invoice.pdf",
"attachment_created_timestamp": "2027-01-30T12:00:00Z"
},
"reservation_type": "Flight",
"reservation_group": "Transportation",
"booking_status": "Not Specified",
"payment_status": {
"id": 0,
"name": "N/A"
},
"cost": {
"amount": 200.00,
"cost_center_breakdown": [
{
"cost_center_id": 54321,
"cost_center": "Marketing",
"charge": 125.50
},
{
"cost_center_id": 54322,
"cost_center": "Operations",
"charge": 74.50
}
]
},
"tagged_users": [
{
"id": "11111111-2222-4333-8444-555555555551",
"first_name": "Alex",
"last_name": "Rivera",
"display_name": "Alex Rivera",
"email": "alex@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
},
{
"id": "11111111-2222-4333-8444-555555555552",
"first_name": "Jamie",
"last_name": "Chen",
"display_name": "Jamie Chen",
"email": "jamie@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
}
],
"created_by": {
"id": "11111111-2222-4333-8444-555555555555",
"first_name": "Jane",
"last_name": "Smith",
"display_name": "Jane Smith",
"email": "jane@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
}
},
{
"id": 12346,
"exhibitday_url": "https://www.exhibitday.com/Workspace/Event/98765?eid=23456&riType=9&riSub=0&riId=12346",
"event_id": 23456,
"event_name": "Sample Event",
"reservation_type_id": 6,
"booking_status_id": null,
"book_by_date": null,
"date_booked": null,
"booking_url": null,
"cancellation_instructions": null,
"vehicle_drop_off_location": null,
"reservation_number": "HOTEL456",
"origin_vendor_name": "Example Hotel",
"origin_flight_number": null,
"origin_reservation_item_info": null,
"origin_checkin_location": null,
"origin_checkin_date": "2027-02-03",
"origin_checkin_time": "09:30",
"origin_reservation_details": null,
"origin_destination_location": null,
"origin_destination_date": null,
"origin_destination_time": null,
"origin_reservation_final_details": null,
"return_vendor_name": null,
"return_flight_number": null,
"return_reservation_item_info": null,
"return_checkin_location": null,
"return_checkin_date": null,
"return_checkin_time": null,
"return_reservation_details": null,
"return_destination_location": null,
"return_destination_date": null,
"return_destination_time": null,
"return_reservation_final_details": null,
"origin_vendor_address": null,
"notes": "",
"payment_status_id": 0,
"payment_due_date": null,
"next_payment_due_date": null,
"payment_notes": null,
"invoice_attachment": {
"id": 882346,
"filename": "travel-reservation-invoice.pdf",
"attachment_created_timestamp": "2027-01-30T12:00:00Z"
},
"reservation_type": "Hotel",
"reservation_group": "Lodging",
"booking_status": "Not Specified",
"payment_status": {
"id": 0,
"name": "N/A"
},
"cost": {
"amount": 200.00,
"cost_center_breakdown": [
{
"cost_center_id": 54321,
"cost_center": "Marketing",
"charge": 125.50
},
{
"cost_center_id": 54322,
"cost_center": "Operations",
"charge": 74.50
}
]
},
"tagged_users": [
{
"id": "11111111-2222-4333-8444-555555555551",
"first_name": "Alex",
"last_name": "Rivera",
"display_name": "Alex Rivera",
"email": "alex@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
},
{
"id": "11111111-2222-4333-8444-555555555552",
"first_name": "Jamie",
"last_name": "Chen",
"display_name": "Jamie Chen",
"email": "jamie@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
}
],
"created_by": {
"id": "11111111-2222-4333-8444-555555555555",
"first_name": "Jane",
"last_name": "Smith",
"display_name": "Jane Smith",
"email": "jane@example.invalid",
"type": "user",
"workspace_role": "team_member",
"is_active": true
}
}
],
"records_found": 2,
"total_records": 2,
"has_more": false
}
{
"status_code": 400,
"status": "Bad Request",
"message": "X-HTTP-Method-Override: hTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "filter_by_tagged_user_ids must be one user ID or an array of user IDs. Each ID is text of 1 to 128 characters; numbers, true/false, null, blank values and objects are not IDs. For example, send \"user-id\" or [\"user-id\",\"other-user-id\"].",
"error_code": "invalid_request",
"errors": [
"filter_by_tagged_user_ids must be one user ID or an array of user IDs. Each ID is text of 1 to 128 characters; numbers, true/false, null, blank values and objects are not IDs. For example, send \"user-id\" or [\"user-id\",\"other-user-id\"]."
],
"error_params": [
"filter_by_tagged_user_ids"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "invalid_api_key",
"errors": [
"The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "The invoice attachment is not available under this owning record.",
"error_code": "not_found",
"errors": [
"The invoice attachment is not available under this owning record."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The invoice attachment or its owning record changed or has conflicting saved information. Retrieve the current record before retrying.",
"error_code": "record_changed",
"errors": [
"The invoice attachment or its owning record changed or has conflicting saved information. Retrieve the current record before retrying."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The Travel entries changed while they were being read. Send the GET request again.",
"error_code": "record_changed",
"errors": [
"The Travel entries changed while they were being read. Send the GET request again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Add a Travel Reservation #
|
Adds a Travel Reservation to an Event.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| event_id | Number | Yes |
The ID of the Event.
|
The reservation will be added to this Event.
|
| reservation_type_id | Number | Yes |
The transportation or lodging type. Required when adding a reservation. Choose a type currently returned by GET /v1/references/travel_reservation_types. The selected type determines which travel-detail fields apply; blank or null is refused as missing.
|
Allowed values:
1 (Flight) | 2 (Train) | 3 (Bus) | 4 (Automobile) | 5 (Other Transportation) | 6 (Hotel) | 7 (Other Lodging) | 8 (Bed and Breakfast) |
| booking_status_id | Number | No |
The reservation's booking status. Omit or send null for Not Specified.
|
Allowed values:
10 (Not Booked Yet) | 20 (Booked) | 30 (Canceled) |
| book_by_date | String | No |
The date by which you want to book the reservation.
|
Use a calendar date in YYYY-MM-DD format. Omit for no value.
|
| date_booked | String | No |
The date the reservation was booked.
|
Use a calendar date in YYYY-MM-DD format. Omit for no value.
|
| booking_url | String | No |
A link to book or manage the reservation.
|
Up to 2,000 characters, excluding surrounding spaces. Omit for no value.
|
| cancellation_instructions | String | No |
Instructions for canceling the reservation.
|
Send plain text; line breaks are kept. If you send HTML, only its text is saved. Both the saved text and the ExhibitDay editor's character count must fit within 30,000 characters; line breaks and characters such as & and < take extra space when saved. Omit for no value. HTML tags are removed, characters are HTML-encoded and line breaks become <br/>. Responses therefore contain HTML.
|
| vehicle_drop_off_location | String | No |
The drop-off location for Automobile or Other Transportation.
|
Up to 1,000 characters, excluding surrounding spaces. Omit for no value. Applies to Automobile (4), Other Transportation (5).
|
| reservation_number | String | No |
The confirmation or reservation number.
|
Up to 125 characters, excluding surrounding spaces. Omit for no value.
|
| origin_vendor_name | String | No |
The outbound airline, transport operator, rental company or lodging name.
|
Up to 125 characters, excluding surrounding spaces. Omit for no value.
|
| origin_flight_number | String | No |
The outbound flight number.
|
Up to 100 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1).
|
| origin_reservation_item_info | String | No |
The outbound class or seat information, vehicle type or lodging room information.
|
Up to 125 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1), Train (2), Bus (3), Automobile (4), Hotel (6), Other Lodging (7), Bed and Breakfast (8).
|
| origin_checkin_location | String | No |
The outbound departure airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| origin_checkin_date | String | No |
The outbound departure, vehicle pickup or lodging check-in date.
|
Use a calendar date in YYYY-MM-DD format. Omit for no value.
|
| origin_checkin_time | String | No |
The local outbound departure, vehicle pickup or lodging check-in time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit for no value.
|
| origin_reservation_details | String | No |
Outbound layover or connection information.
|
Up to 750 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1).
|
| origin_destination_location | String | No |
The outbound arrival airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| origin_destination_date | String | No |
The outbound arrival date.
|
Use a calendar date in YYYY-MM-DD format. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| origin_destination_time | String | No |
The local outbound arrival time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| origin_reservation_final_details | String | No |
Outbound arrival information, pickup notes or lodging check-in information.
|
Up to 750 characters, excluding surrounding spaces. Omit for no value.
|
| return_vendor_name | String | No |
The return airline or transport operator.
|
Up to 125 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| return_flight_number | String | No |
The return flight number.
|
Up to 100 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1).
|
| return_reservation_item_info | String | No |
The return class, cabin or seat information.
|
Up to 125 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| return_checkin_location | String | No |
The return departure airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| return_checkin_date | String | No |
The return departure, vehicle drop-off or lodging check-out date.
|
Use a calendar date in YYYY-MM-DD format. Omit for no value.
|
| return_checkin_time | String | No |
The local return departure, vehicle drop-off or lodging check-out time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit for no value.
|
| return_reservation_details | String | No |
Return layover or connection information.
|
Up to 750 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1).
|
| return_destination_location | String | No |
The return arrival airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| return_destination_date | String | No |
The return arrival date.
|
Use a calendar date in YYYY-MM-DD format. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| return_destination_time | String | No |
The local return arrival time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit for no value. Applies to Flight (1), Train (2), Bus (3).
|
| return_reservation_final_details | String | No |
Return arrival information, drop-off notes or lodging check-out information.
|
Up to 750 characters, excluding surrounding spaces. Omit for no value.
|
| origin_vendor_address | String | No |
The pickup or lodging address.
|
Up to 500 characters, excluding surrounding spaces. Omit for no value. Applies to Automobile (4), Other Transportation (5), Hotel (6), Other Lodging (7), Bed and Breakfast (8).
|
| notes | String | No |
Notes about this Travel Reservation.
|
Send plain text; line breaks are kept. If you send HTML, only its text is saved. Both the saved text and the ExhibitDay editor's character count must fit within 30,000 characters; line breaks and characters such as & and < take extra space when saved. Omit for no value. HTML tags are removed, characters are HTML-encoded and line breaks become <br/>. Responses therefore contain HTML.
|
| payment_status_id | Number | No |
The reservation's payment status. Omit for N/A. A status other than Partially Paid clears the next partial payment due date.
|
Allowed values:
0 (N/A) | 1 (Paid in Full) | 2 (Partially Paid) | 3 (Not Paid Yet) |
| payment_due_date | String | No |
The reservation payment due date.
|
Use a calendar date in YYYY-MM-DD format. Omit for no value.
|
| next_payment_due_date | Date | No |
The next partial payment due date.
|
Use a calendar date in YYYY-MM-DD format. Applies only to Partially Paid (2). Supplying it with another payment status clears the date; choosing another status also clears it. Omit for no value.
|
| payment_notes | String | No |
Notes about the reservation payment.
|
Up to 200 characters, excluding surrounding spaces. Omit for no value.
|
| tagged_user_ids | JSON object/list | No |
The people associated with this reservation.
View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
A JSON array of unique, active workspace user or resource IDs, each 1 to 128 characters with no surrounding whitespace. A supplied array replaces the full tag list. Omit for no tagged people. Retained tags keep their notification state; only newly added tags can schedule notifications.
|
| notify_tagged_users | Boolean | No |
Whether to notify newly tagged people.
|
Default: true when omitted or blank, subject to each person's preferences and recipient eligibility. False suppresses notifications only for tags added by this request. Existing tags are unchanged. JSON null is refused even when ignore-empty is true. Changing this option alone makes no reservation change or revision change.
|
| cost | Number or cost object | No |
The full cost, as a number or an object with amount and/or cost_center_breakdown. Record Costs and Split Them Across Cost Centers.
View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
Optional; defaults to zero.
|
| $result_format | String | No |
By default, the response is a single object. Send
array to get it inside a one-item array.
|
Allowed values:
array | object |
| Idempotency-Key | String | No |
A unique key for safely retrying this add request.
|
Optional HTTP header: 1 to 255 visible ASCII characters without spaces or commas. Retry the identical request with the same key to replay its first saved response. Use a new key for a different request.
|
| $ignore_params_with_empty_values | Boolean | No |
Whether supplied JSON null values should be omitted.
|
Default: false. With true, actual JSON null fields and tag lists are omitted. Nonempty text null still requests clearing where supported. This option does not bypass required values, strict notify_tagged_users input or revision checks.
|
| $request_principal_name | String | No |
A display label for API-origin creation or newly added tags.
|
Optional; up to 122 characters. Omit or leave blank for ExhibitDay API. This is a display label, not a workspace user ID.
|
Good to know
Adds a Travel Reservation to an Event. Choose the transportation or lodging type, then record its booking details and the people it is for.
Choosing travel details
The selected reservation type determines which fields are used. The origin fields describe the outbound journey, vehicle pickup or lodging check-in; return fields describe the return journey, drop-off or check-out.
A supplied field that does not apply to the selected type is not kept; the table shows which types use each field.
Dates and local times
Enter each clock time in the local time at the relevant departure, arrival, pickup, drop-off or lodging location. The API does not convert timezones.
Changing a date preserves an already recorded matching clock time. Clearing a date alone does not clear its clock time. To remove both, clear both fields. A clock time can also be supplied without a date.
Tagging people and notifications
A supplied tagged_user_ids array replaces the full tag list. Include any currently tagged people you want to keep. Users and Resources can both be tagged; notifications depend on actual recipient eligibility and preferences.
notify_tagged_users defaults to true for newly added tags. False suppresses only those new notifications. Retained tags keep their existing notification state; changing the option alone saves no reservation change.
After the add
The response includes the new reservation and its id. The change is recorded in Event history. File Attachments and the Invoice Attachment are uploaded separately.
Recording costs does not attach an invoice, mark a payment complete or change the Event's planned Travel budget. If a save outcome cannot be confirmed, retrieve the current reservation before deciding whether to retry.
Access
The Event's Travel Reservations tab must be available, visible and unlocked, and your current access must allow the change.
Sending values
Use JSON, query parameters or form fields for text containing commas and tag arrays.
Sending text
Send plain text for Notes and other rich-text fields. Characters such as &, < and quotes, along with line breaks, are encoded for storage.
Notes and other rich-text values in the response contain the stored HTML, including encoded characters and line breaks such as <br />.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first. An Event that is not in your workspace returns HTTP 404.
Fields for each reservation type
Each trip field applies only to some reservation types. A value for a field that doesn't apply to the reservation's type is not saved, and the response includes a warning that names the field and the type.
- reservation_number: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_vendor_name: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_flight_number: Flight
- origin_reservation_item_info: Flight, Train, Bus, Automobile, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_checkin_date: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_checkin_time: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_reservation_details: Flight
- origin_destination_date: Flight, Train, Bus
- origin_destination_time: Flight, Train, Bus
- origin_reservation_final_details: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- return_vendor_name: Flight, Train, Bus
- return_flight_number: Flight
- return_reservation_item_info: Flight, Train, Bus
- return_checkin_date: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- return_checkin_time: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- return_reservation_details: Flight
- return_destination_date: Flight, Train, Bus
- return_destination_time: Flight, Train, Bus
- return_reservation_final_details: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_vendor_address: Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
Open in ExhibitDay
The created record includes exhibitday_url, the record's page in ExhibitDay. It is the same link that GET /v1/events/travel_reservations/info returns for this record and opens the record in view mode on its Event's tab. Sign in with an account that can view the record; ExhibitDay checks access when the link is opened.
curl -X POST "https://api.exhibitday.com/v1/events/travel_reservations" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"event_id\":23456,\"reservation_type_id\":1}"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations", {
method: "POST",
headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ "event_id": 23456, "reservation_type_id": 1 })
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.post(
"https://api.exhibitday.com/v1/events/travel_reservations",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"event_id": 23456, "reservation_type_id": 1},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Net.Http.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.PostAsync("https://api.exhibitday.com/v1/events/travel_reservations",
JsonContent.Create(new { event_id = 23456, reservation_type_id = 1 }));
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"event_id\":23456,\"reservation_type_id\":1}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"event_id":23456,"reservation_type_id":1}',
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = '{"event_id":23456,"reservation_type_id":1}'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
"strings"
)
func main() {
request, err := http.NewRequest("POST", "https://api.exhibitday.com/v1/events/travel_reservations", strings.NewReader("{\"event_id\":23456,\"reservation_type_id\":1}"))
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
request.Header.Set("Content-Type", "application/json")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"id": 12345,
"exhibitday_url": "https://www.exhibitday.com/Workspace/Event/98765?eid=23456&riType=9&riSub=0&riId=12345",
"event_id": 23456,
"event_name": "Sample Event",
"reservation_type_id": 1,
"booking_status_id": null,
"book_by_date": null,
"date_booked": null,
"booking_url": null,
"cancellation_instructions": null,
"vehicle_drop_off_location": null,
"reservation_number": null,
"origin_vendor_name": null,
"origin_flight_number": null,
"origin_reservation_item_info": null,
"origin_checkin_location": null,
"origin_checkin_date": null,
"origin_checkin_time": null,
"origin_reservation_details": null,
"origin_destination_location": null,
"origin_destination_date": null,
"origin_destination_time": null,
"origin_reservation_final_details": null,
"return_vendor_name": null,
"return_flight_number": null,
"return_reservation_item_info": null,
"return_checkin_location": null,
"return_checkin_date": null,
"return_checkin_time": null,
"return_reservation_details": null,
"return_destination_location": null,
"return_destination_date": null,
"return_destination_time": null,
"return_reservation_final_details": null,
"origin_vendor_address": null,
"notes": "",
"payment_status_id": 0,
"payment_due_date": null,
"next_payment_due_date": null,
"payment_notes": null,
"invoice_attachment": null,
"reservation_type": "Flight",
"reservation_group": "Transportation",
"booking_status": "Not Specified",
"payment_status": {
"id": 0,
"name": "N/A"
},
"cost": {
"amount": 0.00,
"cost_center_breakdown": []
},
"tagged_users": [],
"created_by": {
"id": null,
"first_name": "ExhibitDay",
"last_name": "API",
"display_name": "ExhibitDay API",
"email": null,
"type": null,
"workspace_role": null,
"is_active": true
}
}
{
"status_code": 400,
"status": "Bad Request",
"message": "X-HTTP-Method-Override: hTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "This Idempotency-Key was already used with a different request. Use a new key for a new request.",
"error_code": "idempotency_key_reused",
"errors": [
"This Idempotency-Key was already used with a different request. Use a new key for a new request."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Event not found. Invalid Event ID: 12345.",
"error_code": "not_found",
"errors": [
"Event not found. Invalid Event ID: 12345."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A request with this Idempotency-Key is still being processed. Retry after a moment.",
"error_code": "idempotency_key_in_use",
"errors": [
"A request with this Idempotency-Key is still being processed. Retry after a moment."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The saved response cannot be replayed safely.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"The earlier request with this Idempotency-Key completed, but its saved response cannot be returned safely. This retry was not run and its key was not released. Look for the existing record with a GET; use a new Idempotency-Key only after checking whether another create is needed."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back.",
"error_code": "record_changed",
"errors": [
"The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Update a Travel Reservation #
|
Updates an existing Travel Reservation.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the Travel Reservation.
|
Use its id from the list, single-record read or add response.
|
| reservation_type_id | Number | No |
The transportation or lodging type. Choose a type currently returned by GET /v1/references/travel_reservation_types. Omit or leave blank to keep it; null cannot clear it. Changing type clears details not used by the new type.
|
Allowed values:
1 (Flight) | 2 (Train) | 3 (Bus) | 4 (Automobile) | 5 (Other Transportation) | 6 (Hotel) | 7 (Other Lodging) | 8 (Bed and Breakfast) |
| booking_status_id | Number | No |
The reservation's booking status. Omit or leave blank to keep it; null means Not Specified.
|
Allowed values:
10 (Not Booked Yet) | 20 (Booked) | 30 (Canceled) |
| book_by_date | String | No |
The date by which you want to book the reservation.
|
Use a calendar date in YYYY-MM-DD format. Omit or leave blank to keep it; null clears it.
|
| date_booked | String | No |
The date the reservation was booked.
|
Use a calendar date in YYYY-MM-DD format. Omit or leave blank to keep it; null clears it.
|
| booking_url | String | No |
A link to book or manage the reservation.
|
Up to 2,000 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it.
|
| cancellation_instructions | String | No |
Instructions for canceling the reservation.
|
Send plain text; line breaks are kept. If you send HTML, only its text is saved. Both the saved text and the ExhibitDay editor's character count must fit within 30,000 characters; line breaks and characters such as & and < take extra space when saved. Omit or leave blank to keep it; null clears it. Existing over-limit content can stay unchanged or be shortened, but neither count may grow. HTML tags are removed, characters are HTML-encoded and line breaks become <br/>. Responses therefore contain HTML.
|
| vehicle_drop_off_location | String | No |
The drop-off location for Automobile or Other Transportation.
|
Up to 1,000 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Automobile (4), Other Transportation (5).
|
| reservation_number | String | No |
The confirmation or reservation number.
|
Up to 125 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it.
|
| origin_vendor_name | String | No |
The outbound airline, transport operator, rental company or lodging name.
|
Up to 125 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it.
|
| origin_flight_number | String | No |
The outbound flight number.
|
Up to 100 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1).
|
| origin_reservation_item_info | String | No |
The outbound class or seat information, vehicle type or lodging room information.
|
Up to 125 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3), Automobile (4), Hotel (6), Other Lodging (7), Bed and Breakfast (8).
|
| origin_checkin_location | String | No |
The outbound departure airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| origin_checkin_date | String | No |
The outbound departure, vehicle pickup or lodging check-in date.
|
Use a calendar date in YYYY-MM-DD format. Omit or leave blank to keep it; null clears it.
|
| origin_checkin_time | String | No |
The local outbound departure, vehicle pickup or lodging check-in time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit or leave blank to keep it; null clears it.
|
| origin_reservation_details | String | No |
Outbound layover or connection information.
|
Up to 750 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1).
|
| origin_destination_location | String | No |
The outbound arrival airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| origin_destination_date | String | No |
The outbound arrival date.
|
Use a calendar date in YYYY-MM-DD format. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| origin_destination_time | String | No |
The local outbound arrival time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| origin_reservation_final_details | String | No |
Outbound arrival information, pickup notes or lodging check-in information.
|
Up to 750 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it.
|
| return_vendor_name | String | No |
The return airline or transport operator.
|
Up to 125 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| return_flight_number | String | No |
The return flight number.
|
Up to 100 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1).
|
| return_reservation_item_info | String | No |
The return class, cabin or seat information.
|
Up to 125 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| return_checkin_location | String | No |
The return departure airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| return_checkin_date | String | No |
The return departure, vehicle drop-off or lodging check-out date.
|
Use a calendar date in YYYY-MM-DD format. Omit or leave blank to keep it; null clears it.
|
| return_checkin_time | String | No |
The local return departure, vehicle drop-off or lodging check-out time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit or leave blank to keep it; null clears it.
|
| return_reservation_details | String | No |
Return layover or connection information.
|
Up to 750 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1).
|
| return_destination_location | String | No |
The return arrival airport or station.
|
Up to 250 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| return_destination_date | String | No |
The return arrival date.
|
Use a calendar date in YYYY-MM-DD format. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| return_destination_time | String | No |
The local return arrival time.
|
Use local HH:mm, from 00:00 through 23:59, with no time zone conversion. See Dates and local times below. Omit or leave blank to keep it; null clears it. Applies to Flight (1), Train (2), Bus (3).
|
| return_reservation_final_details | String | No |
Return arrival information, drop-off notes or lodging check-out information.
|
Up to 750 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it.
|
| origin_vendor_address | String | No |
The pickup or lodging address.
|
Up to 500 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it. Applies to Automobile (4), Other Transportation (5), Hotel (6), Other Lodging (7), Bed and Breakfast (8).
|
| notes | String | No |
Notes about this Travel Reservation.
|
Send plain text; line breaks are kept. If you send HTML, only its text is saved. Both the saved text and the ExhibitDay editor's character count must fit within 30,000 characters; line breaks and characters such as & and < take extra space when saved. Omit or leave blank to keep it; null clears it. Existing over-limit content can stay unchanged or be shortened, but neither count may grow. HTML tags are removed, characters are HTML-encoded and line breaks become <br/>. Responses therefore contain HTML.
|
| payment_status_id | Number | No |
The reservation's payment status. Omit or leave blank to keep it; null resets it to N/A. A status other than Partially Paid clears the next partial payment due date.
|
Allowed values:
0 (N/A) | 1 (Paid in Full) | 2 (Partially Paid) | 3 (Not Paid Yet) |
| payment_due_date | String | No |
The reservation payment due date.
|
Use a calendar date in YYYY-MM-DD format. Omit or leave blank to keep it; null clears it.
|
| next_payment_due_date | Date | No |
The next partial payment due date.
|
Use a calendar date in YYYY-MM-DD format. Applies only to Partially Paid (2). Supplying it with another payment status clears the date; choosing another status also clears it. Omit or leave blank to keep it; null clears it.
|
| payment_notes | String | No |
Notes about the reservation payment.
|
Up to 200 characters, excluding surrounding spaces. Omit or leave blank to keep it; null clears it.
|
| tagged_user_ids | JSON object/list | No |
The people associated with this reservation.
View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
A JSON array of unique, active workspace user or resource IDs, each 1 to 128 characters with no surrounding whitespace. A supplied array replaces the full tag list. Omit to keep existing tags; null or [] removes them. Actual JSON null is omitted when the ignore-empty option is true. Retained tags keep their notification state; only newly added tags can schedule notifications.
|
| notify_tagged_users | Boolean | No |
Whether to notify newly tagged people.
|
Default: true when omitted or blank, subject to each person's preferences and recipient eligibility. False suppresses notifications only for tags added by this request. Existing tags are unchanged. JSON null is refused even when ignore-empty is true. Changing this option alone makes no reservation change or revision change.
|
| cost | Number or cost object | No |
The full cost, as a number or an object with amount and/or cost_center_breakdown. Record Costs and Split Them Across Cost Centers.
View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
Omit to keep the saved cost. A supplied value replaces its full allocation.
|
| expected_revision | String | No |
The record_revision from an earlier read of this Travel Reservation.
|
Optional. Obtain it from GET /v1/events/travel_reservations/info with $include_record_revision=true. A changed reservation returns HTTP 409 without saving this update. Omission skips the check; blank, null and malformed values are refused.
|
| $ignore_params_with_empty_values | Boolean | No |
Whether supplied JSON null values should be omitted.
|
Default: false. With true, actual JSON null fields and tag lists are omitted. Nonempty text null still requests clearing where supported. This option does not bypass required values, strict notify_tagged_users input or revision checks.
|
| $request_principal_name | String | No |
A display label for API-origin creation or newly added tags.
|
Optional; up to 122 characters. Omit or leave blank for ExhibitDay API. This is a display label, not a workspace user ID.
|
Good to know
Updates a Travel Reservation's booking, travel, payment or tagged-person details. Send only the fields you want to change.
Choosing travel details
The selected reservation type determines which fields are used. The origin fields describe the outbound journey, vehicle pickup or lodging check-in; return fields describe the return journey, drop-off or check-out.
A supplied field that does not apply to the selected type is not kept; the table shows which types use each field.
Dates and local times
Enter each clock time in the local time at the relevant departure, arrival, pickup, drop-off or lodging location. The API does not convert timezones.
Changing a date preserves an already recorded matching clock time. Clearing a date alone does not clear its clock time. To remove both, clear both fields. A clock time can also be supplied without a date.
Tagging people and notifications
A supplied tagged_user_ids array replaces the full tag list. Include any currently tagged people you want to keep. Users and Resources can both be tagged; notifications depend on actual recipient eligibility and preferences.
notify_tagged_users defaults to true for newly added tags. False suppresses only those new notifications. Retained tags keep their existing notification state; changing the option alone saves no reservation change.
Choosing what to change
Omitted or blank fields keep their values. Null clears or resets supported fields; reservation_type_id cannot be cleared. Clearing payment_status_id resets it to N/A. With $ignore_params_with_empty_values=true, a JSON null is ignored instead. Changing reservation_type_id clears the details the new type does not use. An update that keeps the type keeps the details you leave out. An attached Invoice Attachment keeps its file; its label follows the new type.
An unchanged request saves no business data or history and keeps its revision. File Attachments and the Invoice Attachment are managed separately.
Using expected_revision
- Retrieve this reservation with GET /v1/events/travel_reservations/info and $include_record_revision=true.
- Send the returned record_revision unchanged as expected_revision with this update.
- If the API reports a change, read the current reservation and decide what to update.
After the update
A real change is recorded in Event history. Supporting files and the Invoice Attachment use their separate file operations.
Recording costs does not attach an invoice, mark a payment complete or change the Event's planned Travel budget. If a save outcome cannot be confirmed, retrieve the current reservation before deciding whether to retry.
Access
The Event's Travel Reservations tab must be available, visible and unlocked, and your current access must allow the change.
Sending values
Use JSON, query parameters or form fields for text containing commas and tag arrays.
Sending text
Send plain text for Notes and other rich-text fields. Characters such as &, < and quotes, along with line breaks, are encoded for storage.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first. An Event that is not in your workspace returns HTTP 404.
Fields for each reservation type
Each trip field applies only to some reservation types. A value for a field that doesn't apply to the reservation's type is not saved, and the response includes a warning that names the field and the type.
- reservation_number: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_vendor_name: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_flight_number: Flight
- origin_reservation_item_info: Flight, Train, Bus, Automobile, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_checkin_date: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_checkin_time: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_reservation_details: Flight
- origin_destination_date: Flight, Train, Bus
- origin_destination_time: Flight, Train, Bus
- origin_reservation_final_details: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- return_vendor_name: Flight, Train, Bus
- return_flight_number: Flight
- return_reservation_item_info: Flight, Train, Bus
- return_checkin_date: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- return_checkin_time: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- return_reservation_details: Flight
- return_destination_date: Flight, Train, Bus
- return_destination_time: Flight, Train, Bus
- return_reservation_final_details: Flight, Train, Bus, Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
- origin_vendor_address: Automobile, Other Transportation, Hotel, Other Lodging, Bed and Breakfast (B&B)
curl -X PATCH "https://api.exhibitday.com/v1/events/travel_reservations" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"id\":12345,\"notes\":\"Updated text\"}"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations", {
method: "PATCH",
headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ "id": 12345, "notes": "Updated text" })
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.patch(
"https://api.exhibitday.com/v1/events/travel_reservations",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"id": 12345, "notes": "Updated text"},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Net.Http.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.PatchAsync("https://api.exhibitday.com/v1/events/travel_reservations",
JsonContent.Create(new { id = 12345, notes = "Updated text" }));
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.method("PATCH", HttpRequest.BodyPublishers.ofString("{\"id\":12345,\"notes\":\"Updated text\"}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'PATCH',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"id":12345,"notes":"Updated text"}',
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations')
request = Net::HTTP::Patch.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = '{"id":12345,"notes":"Updated text"}'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
"strings"
)
func main() {
request, err := http.NewRequest("PATCH", "https://api.exhibitday.com/v1/events/travel_reservations", strings.NewReader("{\"id\":12345,\"notes\":\"Updated text\"}"))
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
request.Header.Set("Content-Type", "application/json")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"status_code": 200,
"status": "OK",
"message": "Travel reservation updated.",
"errors": []
}
{
"status_code": 400,
"status": "Bad Request",
"message": "X-HTTP-Method-Override: hTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "This Travel changed since you read it; nothing was changed.",
"error_code": "record_changed",
"errors": [
"This Travel changed since you read it; nothing was changed."
],
"error_params": [
"expected_revision"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back.",
"error_code": "record_changed",
"errors": [
"The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Delete a Travel Reservation #
|
Deletes an existing Travel Reservation.
Note: Inputs that do not apply to this operation, including the ignore-empty option, are ignored and reported in the X-API-Warnings response header.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the Travel Reservation.
|
Use its id from the list, single-record read or add response.
|
Good to know
Deletes a Travel Reservation and its saved costs, taggings, related-item links, File Attachments and Invoice Attachment. Workspace members and linked Tasks or other records remain in place.
After the deletion
The reservation, its taggings, costs, related-item links and attachment records are removed together. Only its files are scheduled for physical cleanup after the save. Tagged workspace members and linked records remain.
The deletion is recorded in Event history. An unavailable reservation returns HTTP 404. If the save outcome cannot be confirmed, retrieve the current reservations before deciding whether to retry.
Access
The Event's Travel Reservations tab must be available, visible and unlocked, and your current access must allow the change.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first. An Event that is not in your workspace returns HTTP 404.
curl -X DELETE "https://api.exhibitday.com/v1/events/travel_reservations?id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations?" + new URLSearchParams({ "id": "12345" }), {
method: "DELETE",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.delete(
"https://api.exhibitday.com/v1/events/travel_reservations",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"id": 12345},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.DeleteAsync("https://api.exhibitday.com/v1/events/travel_reservations?id=12345");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations?id=12345"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations?id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations?id=12345')
request = Net::HTTP::Delete.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("DELETE", "https://api.exhibitday.com/v1/events/travel_reservations?id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"status_code": 200,
"status": "OK",
"message": "Travel reservation removed.",
"errors": []
}
{
"status_code": 400,
"status": "Bad Request",
"message": "X-HTTP-Method-Override: hTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back.",
"error_code": "record_changed",
"errors": [
"The Travel entry or its Event scope is busy or changed. Read its current values and decide whether to retry; this request was rolled back."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Download Travel Reservation Invoice Attachment #
|
Downloads the Invoice Attachment for a Travel Reservation.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| travel_reservation_id | Number | Yes |
The ID of the Travel Reservation, from Retrieve Travel Reservations (GET /v1/events/travel_reservations) or its add response.
|
Good to know
Downloads the original Invoice Attachment for this Travel Reservation. Use this method to retrieve the file itself.
Finding the file
In the web app, this is the invoice control beside the Travel Reservation's cost and payment details. Each cost has one Invoice Attachment even when its amount is split among cost centers.
For file metadata, retrieve the parent record with GET /v1/events/travel_reservations/info and read invoice_attachment. Use this download method for the contents. No attachment ID or invoice flag is needed.
Download response
A successful response contains the original uploaded file, with a safe download filename. API errors use the usual JSON response. If no invoice is attached, this method returns HTTP 404.
Current record, financial and invoice permissions apply. A locked tab can still be read. Permitted downloads remain available on the Free plan.
Files still being copied
If this file is still being copied, the download returns HTTP 409 with file_copy_pending. Try the download again in a few minutes.
Hidden tab
If the Event's Travel tab is hidden, this request returns HTTP 400 (not_allowed), and the message says the tab is hidden. Show the tab in ExhibitDay first. A locked tab can still be read.
# bash; inspect an error body instead of saving it as the requested file.
status=$(curl --silent --show-error -X GET "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345" -H "Authorization: Bearer YOUR_API_KEY" --output response-body.tmp --write-out "%{http_code}")
if [ "$status" != 200 ]; then cat response-body.tmp; exit 1; fi
mv response-body.tmp 'invoice.pdf'
// Node.js 18+; use a local file only for a declared multipart operation.
import { readFile, writeFile } from 'node:fs/promises';
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345", { method: "GET", headers: { Authorization: 'Bearer YOUR_API_KEY' } });
if (response.status !== 200) throw new Error(`${response.status}: ${await response.text()}`);
await writeFile("invoice.pdf", new Uint8Array(await response.arrayBuffer()));
import requests
import json
response = requests.request("GET", "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345", headers={'Authorization': 'Bearer YOUR_API_KEY'}, timeout=30)
if response.status_code != 200:
raise RuntimeError(f'{response.status_code}: {response.text}')
with open("invoice.pdf", 'wb') as destination:
destination.write(response.content)
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
using var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345");
using var response = await client.SendAsync(request);
if ((int)response.StatusCode != 200) throw new Exception(await response.Content.ReadAsStringAsync());
await File.WriteAllBytesAsync("invoice.pdf", await response.Content.ReadAsByteArrayAsync());
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.nio.charset.StandardCharsets;
import java.io.ByteArrayOutputStream;
import java.util.UUID;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpRequest.Builder request = HttpRequest.newBuilder(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345")).header("Authorization", "Bearer YOUR_API_KEY");
HttpResponse<byte[]> response = HttpClient.newHttpClient().send(request.method("GET", HttpRequest.BodyPublishers.noBody()).build(), HttpResponse.BodyHandlers.ofByteArray());
if (response.statusCode() != 200) throw new RuntimeException(new String(response.body(), StandardCharsets.UTF_8));
Files.write(Path.of("invoice.pdf"), response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) throw new RuntimeException(curl_error($curl));
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status !== 200) throw new RuntimeException($response);
file_put_contents('invoice.pdf', $response);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') { |http| http.request(request) }
raise response.body unless response.code == '200'
File.binwrite('invoice.pdf', response.body)
package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
)
func main() {
request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment/download?travel_reservation_id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
if response.StatusCode != 200 { log.Fatalf("%d %s", response.StatusCode, data) }
if err := os.WriteFile("invoice.pdf", data, 0600); err != nil { log.Fatal(err) }
fmt.Println("File saved")
}
Example response
Content type: application/octet-stream
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "File not found.",
"error_code": "not_found",
"errors": [
"File not found."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "This file is still being copied. Try again in a few minutes.",
"error_code": "file_copy_pending",
"errors": [
"This file is still being copied. Try again in a few minutes."
],
"error_params": [
"file"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Add Travel Reservation Invoice Attachment #
|
Adds an Invoice Attachment to a Travel Reservation.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| travel_reservation_id | Number | Yes |
The ID of the Travel Reservation, from Retrieve Travel Reservations (GET /v1/events/travel_reservations) or its add response.
|
|
| file | File (multipart) | Yes |
The Invoice Attachment to upload.
Maximum size per file: 25 MiB (26,214,400 bytes). Allowed file types: .png, .jpg, .jpeg, .bmp, .gif, .pdf, .msg, .eml, .doc, .docx, .ppt, .pptx, .xls, .xlsx, .csv, .rtf, .odp, .odt, .ods, .txt, .wks, .zip. Maximum files per request: 1. View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
Send exactly one complete, nonempty multipart/form-data file part named file. The supported extensions and current per-file limit are shown below; the complete request limit also includes multipart overhead. A missing or null file is invalid and does not remove an existing invoice.
|
| Idempotency-Key | String | No |
A unique key for safely retrying this upload.
|
Optional HTTP header: 1 to 255 visible ASCII characters without spaces or commas. Retry the identical request with the same key to replay its first saved response. Use a new key for a different upload.
|
Good to know
Adds one Invoice Attachment to this Travel Reservation. You can attach an invoice, receipt or other payment document when no invoice file is currently attached.
Before you upload
POST requires an empty invoice slot. If an invoice is already attached, the API returns HTTP 409; use PATCH to replace it.
An Invoice Attachment is separate from the record's supporting File Attachments. Use the invoice control beside the Travel Reservation's cost and payment details in the web app.
After the upload
The response's invoice_attachment contains the attached file's id, filename and attachment_created_timestamp. The amount, payment fields, cost-center breakdown and other files are unchanged.
The upload is recorded in Event history. Attaching an invoice does not mark the record as paid.
Access and retries
A current upload-enabled plan, record and financial permissions, and an editable applicable tab are required. Each uploaded file must fit its supported type and size limits.
expected_revision is not supported by this file method. If the save outcome cannot be confirmed, retrieve the current parent record with GET /v1/events/travel_reservations/info and inspect invoice_attachment before deciding whether to retry.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first.
# bash; inspect an error body instead of saving it as the requested file.
status=$(curl --silent --show-error -X POST "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment" -H "Authorization: Bearer YOUR_API_KEY" --output response-body.tmp --write-out "%{http_code}" --form-string "travel_reservation_id=12345" --form "file=@invoice.pdf;type=application/octet-stream")
if [ "$status" != 200 ]; then cat response-body.tmp; exit 1; fi
cat response-body.tmp
// Node.js 18+; use a local file only for a declared multipart operation.
import { readFile, writeFile } from 'node:fs/promises';
const form = new FormData();
form.append("travel_reservation_id", "12345");
form.append("file", new Blob([await readFile("invoice.pdf")], { type: "application/octet-stream" }), "invoice.pdf");
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment", { method: "POST", headers: { Authorization: 'Bearer YOUR_API_KEY' }, body: form });
if (response.status !== 200) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
import requests
import json
from contextlib import ExitStack
with ExitStack() as stack:
files = [
("file", ("invoice.pdf", stack.enter_context(open("invoice.pdf", 'rb')), "application/octet-stream")),
]
response = requests.request("POST", "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment", headers={'Authorization': 'Bearer YOUR_API_KEY'}, files=files, data={"travel_reservation_id": "12345"}, timeout=30)
if response.status_code != 200:
raise RuntimeError(f'{response.status_code}: {response.text}')
print(response.json())
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
using var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment");
var form = new MultipartFormDataContent();
form.Add(new StringContent("12345"), "travel_reservation_id");
var file0 = new StreamContent(File.OpenRead("invoice.pdf"));
file0.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
form.Add(file0, "file", "invoice.pdf");
request.Content = form;
using var response = await client.SendAsync(request);
if ((int)response.StatusCode != 200) throw new Exception(await response.Content.ReadAsStringAsync());
Console.WriteLine(await response.Content.ReadAsStringAsync());
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.nio.charset.StandardCharsets;
import java.io.ByteArrayOutputStream;
import java.util.UUID;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpRequest.Builder request = HttpRequest.newBuilder(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment")).header("Authorization", "Bearer YOUR_API_KEY");
String boundary = "ExhibitDay-" + UUID.randomUUID();
ByteArrayOutputStream form = new ByteArrayOutputStream();
form.write(("--" + boundary + "\r\nContent-Disposition: form-data; name=\"travel_reservation_id\"\r\n\r\n" + "12345" + "\r\n").getBytes(StandardCharsets.UTF_8));
form.write(("--" + boundary + "\r\nContent-Disposition: form-data; name=\"file\"; filename=\"invoice.pdf\"\r\nContent-Type: application/octet-stream\r\n\r\n").getBytes(StandardCharsets.UTF_8));
form.write(Files.readAllBytes(Path.of("invoice.pdf")));
form.write("\r\n".getBytes(StandardCharsets.UTF_8));
form.write(("--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8));
request.header("Content-Type", "multipart/form-data; boundary=" + boundary);
HttpResponse<byte[]> response = HttpClient.newHttpClient().send(request.method("POST", HttpRequest.BodyPublishers.ofByteArray(form.toByteArray())).build(), HttpResponse.BodyHandlers.ofByteArray());
if (response.statusCode() != 200) throw new RuntimeException(new String(response.body(), StandardCharsets.UTF_8));
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
CURLOPT_POSTFIELDS => [
'travel_reservation_id' => '12345',
'file' => new CURLFile('invoice.pdf', 'application/octet-stream', 'invoice.pdf'),
],
]);
$response = curl_exec($curl);
if ($response === false) throw new RuntimeException(curl_error($curl));
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status !== 200) throw new RuntimeException($response);
echo $response;
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
files = []
begin
parts = [
['travel_reservation_id', '12345'],
['file', (files << File.open('invoice.pdf', 'rb')).last, {filename: 'invoice.pdf', content_type: 'application/octet-stream'}],
]
request.set_form(parts, 'multipart/form-data')
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') { |http| http.request(request) }
raise response.body unless response.code == '200'
puts response.body
ensure
files.each(&:close)
end
package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
"bytes"
"mime/multipart"
"net/textproto"
)
func main() {
var form bytes.Buffer
writer := multipart.NewWriter(&form)
if err := writer.WriteField("travel_reservation_id", "12345"); err != nil { log.Fatal(err) }
header0 := textproto.MIMEHeader{}
header0.Set("Content-Disposition", "form-data; name=\"file\"; filename=\"invoice.pdf\"")
header0.Set("Content-Type", "application/octet-stream")
part0, err := writer.CreatePart(header0)
if err != nil { log.Fatal(err) }
file0, err := os.Open("invoice.pdf")
if err != nil { log.Fatal(err) }
if _, err = io.Copy(part0, file0); err != nil { log.Fatal(err) }
file0.Close()
if err := writer.Close(); err != nil { log.Fatal(err) }
request, err := http.NewRequest("POST", "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment", &form)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
request.Header.Set("Content-Type", writer.FormDataContentType())
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
if response.StatusCode != 200 { log.Fatalf("%d %s", response.StatusCode, data) }
fmt.Printf("%s\n", data)
}
Example response
{
"invoice_attachment": {
"id": 12345,
"filename": "invoice.pdf",
"attachment_created_timestamp": "2027-01-30T12:00:00Z"
}
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "This Idempotency-Key was already used with a different request. Use a new key for a new request.",
"error_code": "idempotency_key_reused",
"errors": [
"This Idempotency-Key was already used with a different request. Use a new key for a new request."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A request with this Idempotency-Key is still being processed. Retry after a moment.",
"error_code": "idempotency_key_in_use",
"errors": [
"A request with this Idempotency-Key is still being processed. Retry after a moment."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The saved response cannot be replayed safely.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"The earlier request with this Idempotency-Key completed, but its saved response cannot be returned safely. This retry was not run and its key was not released. Look for the existing record with a GET; use a new Idempotency-Key only after checking whether another create is needed."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying.",
"error_code": "record_changed",
"errors": [
"The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Replace Travel Reservation Invoice Attachment #
|
Replaces a Travel Reservation's Invoice Attachment.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| travel_reservation_id | Number | Yes |
The ID of the Travel Reservation, from Retrieve Travel Reservations (GET /v1/events/travel_reservations) or its add response.
|
|
| file | File (multipart) | Yes |
The Invoice Attachment to upload.
Maximum size per file: 25 MiB (26,214,400 bytes). Allowed file types: .png, .jpg, .jpeg, .bmp, .gif, .pdf, .msg, .eml, .doc, .docx, .ppt, .pptx, .xls, .xlsx, .csv, .rtf, .odp, .odt, .ods, .txt, .wks, .zip. Maximum files per request: 1. View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
Send exactly one complete, nonempty multipart/form-data file part named file. The supported extensions and current per-file limit are shown below; the complete request limit also includes multipart overhead. A missing or null file is invalid and does not remove an existing invoice.
|
Good to know
Replaces this Travel Reservation's current Invoice Attachment with one uploaded file. Use this method when an invoice file is already attached.
Replacing the current file
PATCH requires a current invoice file. If none is attached, the API returns HTTP 404. Upload exactly one file; the previous attachment ID is not needed.
If another request changes the current invoice during your upload, the API refuses this request instead of replacing a different file. Even identical replacement contents receive a new attachment ID.
After the replacement
The response's invoice_attachment contains the attached file's id, filename and attachment_created_timestamp. The amount, payment fields, cost-center breakdown and other files are unchanged.
The previous file is scheduled for physical cleanup after a confirmed save; cleanup may finish later. The replacement is recorded in Event history.
Access and retries
A current upload-enabled plan, record and financial permissions, and an editable applicable tab are required. Each uploaded file must fit its supported type and size limits.
expected_revision is not supported by this file method. PATCH does not use Idempotency-Key replay. If the save outcome cannot be confirmed, retrieve the current parent record with GET /v1/events/travel_reservations/info and inspect invoice_attachment before deciding whether to retry.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first.
# bash; inspect an error body instead of saving it as the requested file.
status=$(curl --silent --show-error -X PATCH "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment" -H "Authorization: Bearer YOUR_API_KEY" --output response-body.tmp --write-out "%{http_code}" --form-string "travel_reservation_id=12345" --form "file=@invoice.pdf;type=application/octet-stream")
if [ "$status" != 200 ]; then cat response-body.tmp; exit 1; fi
cat response-body.tmp
// Node.js 18+; use a local file only for a declared multipart operation.
import { readFile, writeFile } from 'node:fs/promises';
const form = new FormData();
form.append("travel_reservation_id", "12345");
form.append("file", new Blob([await readFile("invoice.pdf")], { type: "application/octet-stream" }), "invoice.pdf");
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment", { method: "PATCH", headers: { Authorization: 'Bearer YOUR_API_KEY' }, body: form });
if (response.status !== 200) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
import requests
import json
from contextlib import ExitStack
with ExitStack() as stack:
files = [
("file", ("invoice.pdf", stack.enter_context(open("invoice.pdf", 'rb')), "application/octet-stream")),
]
response = requests.request("PATCH", "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment", headers={'Authorization': 'Bearer YOUR_API_KEY'}, files=files, data={"travel_reservation_id": "12345"}, timeout=30)
if response.status_code != 200:
raise RuntimeError(f'{response.status_code}: {response.text}')
print(response.json())
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
using var request = new HttpRequestMessage(new HttpMethod("PATCH"), "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment");
var form = new MultipartFormDataContent();
form.Add(new StringContent("12345"), "travel_reservation_id");
var file0 = new StreamContent(File.OpenRead("invoice.pdf"));
file0.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
form.Add(file0, "file", "invoice.pdf");
request.Content = form;
using var response = await client.SendAsync(request);
if ((int)response.StatusCode != 200) throw new Exception(await response.Content.ReadAsStringAsync());
Console.WriteLine(await response.Content.ReadAsStringAsync());
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.nio.charset.StandardCharsets;
import java.io.ByteArrayOutputStream;
import java.util.UUID;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpRequest.Builder request = HttpRequest.newBuilder(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment")).header("Authorization", "Bearer YOUR_API_KEY");
String boundary = "ExhibitDay-" + UUID.randomUUID();
ByteArrayOutputStream form = new ByteArrayOutputStream();
form.write(("--" + boundary + "\r\nContent-Disposition: form-data; name=\"travel_reservation_id\"\r\n\r\n" + "12345" + "\r\n").getBytes(StandardCharsets.UTF_8));
form.write(("--" + boundary + "\r\nContent-Disposition: form-data; name=\"file\"; filename=\"invoice.pdf\"\r\nContent-Type: application/octet-stream\r\n\r\n").getBytes(StandardCharsets.UTF_8));
form.write(Files.readAllBytes(Path.of("invoice.pdf")));
form.write("\r\n".getBytes(StandardCharsets.UTF_8));
form.write(("--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8));
request.header("Content-Type", "multipart/form-data; boundary=" + boundary);
HttpResponse<byte[]> response = HttpClient.newHttpClient().send(request.method("PATCH", HttpRequest.BodyPublishers.ofByteArray(form.toByteArray())).build(), HttpResponse.BodyHandlers.ofByteArray());
if (response.statusCode() != 200) throw new RuntimeException(new String(response.body(), StandardCharsets.UTF_8));
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'PATCH',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
CURLOPT_POSTFIELDS => [
'travel_reservation_id' => '12345',
'file' => new CURLFile('invoice.pdf', 'application/octet-stream', 'invoice.pdf'),
],
]);
$response = curl_exec($curl);
if ($response === false) throw new RuntimeException(curl_error($curl));
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status !== 200) throw new RuntimeException($response);
echo $response;
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment')
request = Net::HTTP::Patch.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
files = []
begin
parts = [
['travel_reservation_id', '12345'],
['file', (files << File.open('invoice.pdf', 'rb')).last, {filename: 'invoice.pdf', content_type: 'application/octet-stream'}],
]
request.set_form(parts, 'multipart/form-data')
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') { |http| http.request(request) }
raise response.body unless response.code == '200'
puts response.body
ensure
files.each(&:close)
end
package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
"bytes"
"mime/multipart"
"net/textproto"
)
func main() {
var form bytes.Buffer
writer := multipart.NewWriter(&form)
if err := writer.WriteField("travel_reservation_id", "12345"); err != nil { log.Fatal(err) }
header0 := textproto.MIMEHeader{}
header0.Set("Content-Disposition", "form-data; name=\"file\"; filename=\"invoice.pdf\"")
header0.Set("Content-Type", "application/octet-stream")
part0, err := writer.CreatePart(header0)
if err != nil { log.Fatal(err) }
file0, err := os.Open("invoice.pdf")
if err != nil { log.Fatal(err) }
if _, err = io.Copy(part0, file0); err != nil { log.Fatal(err) }
file0.Close()
if err := writer.Close(); err != nil { log.Fatal(err) }
request, err := http.NewRequest("PATCH", "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment", &form)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
request.Header.Set("Content-Type", writer.FormDataContentType())
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
if response.StatusCode != 200 { log.Fatalf("%d %s", response.StatusCode, data) }
fmt.Printf("%s\n", data)
}
Example response
{
"invoice_attachment": {
"id": 12345,
"filename": "invoice.pdf",
"attachment_created_timestamp": "2027-01-30T12:00:00Z"
}
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying.",
"error_code": "record_changed",
"errors": [
"The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Remove Travel Reservation Invoice Attachment #
|
Deletes a Travel Reservation's Invoice Attachment.
Note: Inputs that do not apply to this operation, including the ignore-empty option, are ignored and reported in the X-API-Warnings response header.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| travel_reservation_id | Number | Yes |
The ID of the Travel Reservation, from Retrieve Travel Reservations (GET /v1/events/travel_reservations) or its add response.
|
Good to know
Removes this Travel Reservation's Invoice Attachment. The cost, payment details and other File Attachments stay in place.
After the removal
The Invoice Attachment is cleared and the removal is recorded in Event history. Its physical file is scheduled for cleanup after a confirmed save; cleanup may finish later. Costs, payment fields, cost-center allocations and supporting files stay unchanged.
If no invoice is attached, DELETE returns HTTP 404 Not Found with the message "This Travel Reservation has no invoice to remove." No saved data or history is changed. Current access and the record's binding are still checked. Do not send file parts with this request.
Access and retries
Current record, financial and invoice permissions and applicable tab-edit access are required. Permitted removals remain available on the Free plan.
expected_revision is not supported, and DELETE does not use Idempotency-Key replay. If the save outcome cannot be confirmed, retrieve the current parent record with GET /v1/events/travel_reservations/info and inspect invoice_attachment before deciding whether to retry.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first.
curl -X DELETE "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment?travel_reservation_id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment?" + new URLSearchParams({ "travel_reservation_id": "12345" }), {
method: "DELETE",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.delete(
"https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"travel_reservation_id": 12345},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.DeleteAsync("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment?travel_reservation_id=12345");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment?travel_reservation_id=12345"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment?travel_reservation_id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment?travel_reservation_id=12345')
request = Net::HTTP::Delete.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("DELETE", "https://api.exhibitday.com/v1/events/travel_reservations/invoice_attachment?travel_reservation_id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"status_code": 200,
"status": "OK",
"message": "Attachment removed.",
"errors": []
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "This Travel Reservation has no invoice to remove.",
"error_code": "not_found",
"errors": [
"This Travel Reservation has no invoice to remove."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying.",
"error_code": "record_changed",
"errors": [
"The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Retrieve Travel Reservation General File Attachments #
|
Retrieves the General File Attachments on a Travel Reservation.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| travel_reservation_id | Number | Yes |
The ID of the Travel Reservation, from Retrieve Travel Reservations (GET /v1/events/travel_reservations) or its add response.
|
|
| $limit | Number | No |
The most File Attachments to return.
|
A positive whole number. Omit for all remaining matching files.
|
| $offset | Number | No |
The number of matching File Attachments to skip.
|
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.
|
Allowed values:
array |
| If-None-Match | String | No |
An ETag from an earlier response to this GET.
|
Optional HTTP header. If the successful response is unchanged, the API returns HTTP 304 with no body.
|
Good to know
Retrieves the General File Attachments on this Travel Reservation. Each result includes the file's ID, name and added time; use the download method for its contents.
Reading the file list
Files are ordered by added time, then attachment ID, lowest first. Only files available under your current access are included.
Paging totals and X-Total-Count count all matching files before $limit and $offset are applied. A record with no files you can view returns an empty list. This list does not return edit revisions or support changed-since filtering.
Supporting files and invoices
These are the record's General File Attachments. Its cost Invoice Attachment is separate and has its own download and upload methods. Use this list's id values for these supporting-file downloads and removals.
Access
The record's Event and tab must be available, and the tab must not be hidden. A locked tab can still be read.
Hidden tab
If the Event's Travel tab is hidden, this request returns HTTP 400 (not_allowed), and the message says the tab is hidden. Show the tab in ExhibitDay first. A locked tab can still be read.
curl -X GET "https://api.exhibitday.com/v1/events/travel_reservations/attachments?travel_reservation_id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/attachments?" + new URLSearchParams({ "travel_reservation_id": "12345" }), {
method: "GET",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.get(
"https://api.exhibitday.com/v1/events/travel_reservations/attachments",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"travel_reservation_id": 12345},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.GetAsync("https://api.exhibitday.com/v1/events/travel_reservations/attachments?travel_reservation_id=12345");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/attachments?travel_reservation_id=12345"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/attachments?travel_reservation_id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/attachments?travel_reservation_id=12345')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/events/travel_reservations/attachments?travel_reservation_id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"records_found": 1,
"total_records": 1,
"has_more": false,
"list_type": "attachment",
"list_data": [
{
"id": 12345,
"filename": "attachment.pdf",
"attachment_created_timestamp": "2027-01-30T12:00:00Z"
}
]
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Add Travel Reservation General File Attachments #
|
Adds General File Attachments to a Travel Reservation.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| travel_reservation_id | Number | Yes |
The ID of the Travel Reservation, from Retrieve Travel Reservations (GET /v1/events/travel_reservations) or its add response.
|
|
| file | File (multipart) | Yes |
The File Attachments to upload.
Maximum size per file: 25 MiB (26,214,400 bytes). Allowed file types: .png, .jpg, .jpeg, .bmp, .gif, .pdf, .msg, .eml, .doc, .docx, .ppt, .pptx, .xls, .xlsx, .csv, .rtf, .odp, .odt, .ods, .txt, .wks, .zip. View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
Send one or more complete, nonempty multipart/form-data parts, each named file. Supported types and the current per-file limit are shown below. The complete request limit includes all files and multipart overhead; split larger batches. A missing or null upload is not a removal request.
|
| Idempotency-Key | String | No |
A unique key for safely retrying this upload.
|
Optional HTTP header: 1 to 255 visible ASCII characters without spaces or commas. Retry the identical request with the same key to replay its first saved response. Use a new key for a different upload.
|
Good to know
Adds one or more General File Attachments to this Travel Reservation. Send each file as a multipart upload part named file.
After the upload
The response's list_data contains the newly attached files, including each id, filename and attachment_created_timestamp. Existing files are kept. Use each returned id to download or remove that file.
Identical repeated files in one request are attached once when their cleaned filename, length and contents match. Files with different contents remain separate even when their names match. This does not remove or replace files already attached to the record.
Choosing the right file method
These uploads add General File Attachments. Use this record's Invoice Attachment methods for its cost invoice or receipt. Adding supporting files does not change amounts, payments or cost-center allocations.
Access
Current record and file-change permissions and applicable Event/tab locks must allow this upload. An upload-enabled paid plan is required.
History and retries
A confirmed file change is recorded in history. expected_revision is not supported by these file methods. If the save outcome cannot be confirmed, retrieve the current file list before deciding whether to retry; the API does not automatically repeat an uncertain change.
Supporting File Attachments have no PATCH replacement. To replace one, add the new file and remove the old one using their separate requests; each request has its own outcome.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first.
# bash; inspect an error body instead of saving it as the requested file.
status=$(curl --silent --show-error -X POST "https://api.exhibitday.com/v1/events/travel_reservations/attachments" -H "Authorization: Bearer YOUR_API_KEY" --output response-body.tmp --write-out "%{http_code}" --form-string "travel_reservation_id=12345" --form "file=@attachment.pdf;type=application/octet-stream")
if [ "$status" != 200 ]; then cat response-body.tmp; exit 1; fi
cat response-body.tmp
// Node.js 18+; use a local file only for a declared multipart operation.
import { readFile, writeFile } from 'node:fs/promises';
const form = new FormData();
form.append("travel_reservation_id", "12345");
form.append("file", new Blob([await readFile("attachment.pdf")], { type: "application/octet-stream" }), "attachment.pdf");
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/attachments", { method: "POST", headers: { Authorization: 'Bearer YOUR_API_KEY' }, body: form });
if (response.status !== 200) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
import requests
import json
from contextlib import ExitStack
with ExitStack() as stack:
files = [
("file", ("attachment.pdf", stack.enter_context(open("attachment.pdf", 'rb')), "application/octet-stream")),
]
response = requests.request("POST", "https://api.exhibitday.com/v1/events/travel_reservations/attachments", headers={'Authorization': 'Bearer YOUR_API_KEY'}, files=files, data={"travel_reservation_id": "12345"}, timeout=30)
if response.status_code != 200:
raise RuntimeError(f'{response.status_code}: {response.text}')
print(response.json())
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
using var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.exhibitday.com/v1/events/travel_reservations/attachments");
var form = new MultipartFormDataContent();
form.Add(new StringContent("12345"), "travel_reservation_id");
var file0 = new StreamContent(File.OpenRead("attachment.pdf"));
file0.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream");
form.Add(file0, "file", "attachment.pdf");
request.Content = form;
using var response = await client.SendAsync(request);
if ((int)response.StatusCode != 200) throw new Exception(await response.Content.ReadAsStringAsync());
Console.WriteLine(await response.Content.ReadAsStringAsync());
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.nio.charset.StandardCharsets;
import java.io.ByteArrayOutputStream;
import java.util.UUID;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpRequest.Builder request = HttpRequest.newBuilder(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/attachments")).header("Authorization", "Bearer YOUR_API_KEY");
String boundary = "ExhibitDay-" + UUID.randomUUID();
ByteArrayOutputStream form = new ByteArrayOutputStream();
form.write(("--" + boundary + "\r\nContent-Disposition: form-data; name=\"travel_reservation_id\"\r\n\r\n" + "12345" + "\r\n").getBytes(StandardCharsets.UTF_8));
form.write(("--" + boundary + "\r\nContent-Disposition: form-data; name=\"file\"; filename=\"attachment.pdf\"\r\nContent-Type: application/octet-stream\r\n\r\n").getBytes(StandardCharsets.UTF_8));
form.write(Files.readAllBytes(Path.of("attachment.pdf")));
form.write("\r\n".getBytes(StandardCharsets.UTF_8));
form.write(("--" + boundary + "--\r\n").getBytes(StandardCharsets.UTF_8));
request.header("Content-Type", "multipart/form-data; boundary=" + boundary);
HttpResponse<byte[]> response = HttpClient.newHttpClient().send(request.method("POST", HttpRequest.BodyPublishers.ofByteArray(form.toByteArray())).build(), HttpResponse.BodyHandlers.ofByteArray());
if (response.statusCode() != 200) throw new RuntimeException(new String(response.body(), StandardCharsets.UTF_8));
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/attachments');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
CURLOPT_POSTFIELDS => [
'travel_reservation_id' => '12345',
'file' => new CURLFile('attachment.pdf', 'application/octet-stream', 'attachment.pdf'),
],
]);
$response = curl_exec($curl);
if ($response === false) throw new RuntimeException(curl_error($curl));
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status !== 200) throw new RuntimeException($response);
echo $response;
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/attachments')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
files = []
begin
parts = [
['travel_reservation_id', '12345'],
['file', (files << File.open('attachment.pdf', 'rb')).last, {filename: 'attachment.pdf', content_type: 'application/octet-stream'}],
]
request.set_form(parts, 'multipart/form-data')
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') { |http| http.request(request) }
raise response.body unless response.code == '200'
puts response.body
ensure
files.each(&:close)
end
package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
"bytes"
"mime/multipart"
"net/textproto"
)
func main() {
var form bytes.Buffer
writer := multipart.NewWriter(&form)
if err := writer.WriteField("travel_reservation_id", "12345"); err != nil { log.Fatal(err) }
header0 := textproto.MIMEHeader{}
header0.Set("Content-Disposition", "form-data; name=\"file\"; filename=\"attachment.pdf\"")
header0.Set("Content-Type", "application/octet-stream")
part0, err := writer.CreatePart(header0)
if err != nil { log.Fatal(err) }
file0, err := os.Open("attachment.pdf")
if err != nil { log.Fatal(err) }
if _, err = io.Copy(part0, file0); err != nil { log.Fatal(err) }
file0.Close()
if err := writer.Close(); err != nil { log.Fatal(err) }
request, err := http.NewRequest("POST", "https://api.exhibitday.com/v1/events/travel_reservations/attachments", &form)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
request.Header.Set("Content-Type", writer.FormDataContentType())
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
if response.StatusCode != 200 { log.Fatalf("%d %s", response.StatusCode, data) }
fmt.Printf("%s\n", data)
}
Example response
{
"records_found": 1,
"total_records": 1,
"has_more": false,
"list_type": "attachment",
"list_data": [
{
"id": 12345,
"filename": "attachment.pdf",
"attachment_created_timestamp": "2027-01-30T12:00:00Z"
}
]
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "This Idempotency-Key was already used with a different request. Use a new key for a new request.",
"error_code": "idempotency_key_reused",
"errors": [
"This Idempotency-Key was already used with a different request. Use a new key for a new request."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Travel Reservation not found. Invalid Travel Reservation ID: 12345.",
"error_code": "not_found",
"errors": [
"Travel Reservation not found. Invalid Travel Reservation ID: 12345."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A request with this Idempotency-Key is still being processed. Retry after a moment.",
"error_code": "idempotency_key_in_use",
"errors": [
"A request with this Idempotency-Key is still being processed. Retry after a moment."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The saved response cannot be replayed safely.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"The earlier request with this Idempotency-Key completed, but its saved response cannot be returned safely. This retry was not run and its key was not released. Look for the existing record with a GET; use a new Idempotency-Key only after checking whether another create is needed."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying.",
"error_code": "record_changed",
"errors": [
"The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Remove a Travel Reservation General File Attachment #
|
Deletes a General File Attachment from a Travel Reservation.
Note: Inputs that do not apply to this operation, including the ignore-empty option, are ignored and reported in the X-API-Warnings response header.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the File Attachment.
|
Use the id from the attachment list. The API finds the record the file belongs to, so no record ID is sent. An Invoice Attachment is not selected by this method.
|
Good to know
Removes one General File Attachment from this Travel Reservation. Other attached files and the record's details stay in place.
After the removal
Only the selected file association is removed. Its physical file is scheduled for cleanup after a confirmed save; cleanup may finish later. Other attached files stay in place.
Send only the file's id; the API finds the record it belongs to. A missing, already removed or unavailable attachment returns HTTP 404 Not Found. Do not send file parts with DELETE.
Access
Current record and file-removal permissions and applicable Event/tab locks must allow this change. Permitted removals remain available on the Free plan.
History and retries
A confirmed file change is recorded in history. expected_revision is not supported by these file methods. DELETE does not use Idempotency-Key replay. If the save outcome cannot be confirmed, retrieve the current file list before deciding whether to retry; the API does not automatically repeat an uncertain change.
Supporting File Attachments have no PATCH replacement. To replace one, add the new file and remove the old one using their separate requests; each request has its own outcome.
Hidden or locked tab
If the Event's Travel tab is hidden or locked, this request returns HTTP 400 (not_allowed), and the message names the tab. Show or unlock the tab in ExhibitDay first.
curl -X DELETE "https://api.exhibitday.com/v1/events/travel_reservations/attachments?id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/attachments?" + new URLSearchParams({ "id": "12345" }), {
method: "DELETE",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.delete(
"https://api.exhibitday.com/v1/events/travel_reservations/attachments",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"id": 12345},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.DeleteAsync("https://api.exhibitday.com/v1/events/travel_reservations/attachments?id=12345");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/attachments?id=12345"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/attachments?id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/attachments?id=12345')
request = Net::HTTP::Delete.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("DELETE", "https://api.exhibitday.com/v1/events/travel_reservations/attachments?id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"status_code": 200,
"status": "OK",
"message": "Attachment removed.",
"errors": []
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is hidden on this Event, so its records can't be added, changed or deleted. Show the tab in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again.",
"error_code": "not_allowed",
"errors": [
"The Travel tab is locked on this Event. Unlock it in ExhibitDay before trying again."
],
"error_params": [
"event_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Attachment not found. Use an Attachment ID from GET /v1/events/travel_reservations/attachments.",
"error_code": "not_found",
"errors": [
"Attachment not found. Use an Attachment ID from GET /v1/events/travel_reservations/attachments."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying.",
"error_code": "record_changed",
"errors": [
"The attachment state changed or the invoice slot is occupied. Retrieve its current state before retrying."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Download a Travel Reservation General File Attachment #
|
Downloads a General File Attachment from a Travel Reservation.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the File Attachment.
|
Use the id from the attachment list. The API finds the record the file belongs to, so no record ID is sent. An Invoice Attachment is not selected by this method.
|
Good to know
Downloads one original General File Attachment from this Travel Reservation. Select the file using its ID from the attachment list.
Download response
A successful response contains the original uploaded file with a safe download filename. API errors use the usual JSON response. A missing or unavailable file returns HTTP 404.
Send only the file's id from the attachment list to download that one file; the API finds the record it belongs to. The download leaves the record unchanged.
Access
The record's Event and tab must be available, and the tab must not be hidden. A locked tab can still be read.
Files still being copied
If this file is still being copied, the download returns HTTP 409 with file_copy_pending. Try the download again in a few minutes.
Hidden tab
If the Event's Travel tab is hidden, this request returns HTTP 400 (not_allowed), and the message says the tab is hidden. Show the tab in ExhibitDay first. A locked tab can still be read.
# bash; inspect an error body instead of saving it as the requested file.
status=$(curl --silent --show-error -X GET "https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345" -H "Authorization: Bearer YOUR_API_KEY" --output response-body.tmp --write-out "%{http_code}")
if [ "$status" != 200 ]; then cat response-body.tmp; exit 1; fi
mv response-body.tmp 'attachment.pdf'
// Node.js 18+; use a local file only for a declared multipart operation.
import { readFile, writeFile } from 'node:fs/promises';
const response = await fetch("https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345", { method: "GET", headers: { Authorization: 'Bearer YOUR_API_KEY' } });
if (response.status !== 200) throw new Error(`${response.status}: ${await response.text()}`);
await writeFile("attachment.pdf", new Uint8Array(await response.arrayBuffer()));
import requests
import json
response = requests.request("GET", "https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345", headers={'Authorization': 'Bearer YOUR_API_KEY'}, timeout=30)
if response.status_code != 200:
raise RuntimeError(f'{response.status_code}: {response.text}')
with open("attachment.pdf", 'wb') as destination:
destination.write(response.content)
using System;
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
using var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345");
using var response = await client.SendAsync(request);
if ((int)response.StatusCode != 200) throw new Exception(await response.Content.ReadAsStringAsync());
await File.WriteAllBytesAsync("attachment.pdf", await response.Content.ReadAsByteArrayAsync());
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.nio.charset.StandardCharsets;
import java.io.ByteArrayOutputStream;
import java.util.UUID;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpRequest.Builder request = HttpRequest.newBuilder(URI.create("https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345")).header("Authorization", "Bearer YOUR_API_KEY");
HttpResponse<byte[]> response = HttpClient.newHttpClient().send(request.method("GET", HttpRequest.BodyPublishers.noBody()).build(), HttpResponse.BodyHandlers.ofByteArray());
if (response.statusCode() != 200) throw new RuntimeException(new String(response.body(), StandardCharsets.UTF_8));
Files.write(Path.of("attachment.pdf"), response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) throw new RuntimeException(curl_error($curl));
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status !== 200) throw new RuntimeException($response);
file_put_contents('attachment.pdf', $response);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') { |http| http.request(request) }
raise response.body unless response.code == '200'
File.binwrite('attachment.pdf', response.body)
package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
)
func main() {
request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/events/travel_reservations/attachments/download?id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
if response.StatusCode != 200 { log.Fatalf("%d %s", response.StatusCode, data) }
if err := os.WriteFile("attachment.pdf", data, 0600); err != nil { log.Fatal(err) }
fmt.Println("File saved")
}
Example response
Content type: application/octet-stream
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "File not found.",
"error_code": "not_found",
"errors": [
"File not found."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "This file is still being copied. Try again in a few minutes.",
"error_code": "file_copy_pending",
"errors": [
"This file is still being copied. Try again in a few minutes."
],
"error_params": [
"file"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}