Skip to content
API reference
/
Events
/
/
Set traveler RSVP

Event API (v2)

Download OpenAPI description
EventApi.json
EventApi.yaml
Languages
Servers
Sandbox URL
https://api-ext-sboxmeta.partners.spotnana.com/
Spotnana mock server
https://developer.spotnana.com/_mock/openapi/eventapi/

Events

APIs to create and manage events.

Operations

Update event booking guidelines

Request

Update the booking guidelines for an event. You can update booking guidelines such as maximum number of guests allowed to accompany a traveler, arrival and departure window for the event, payment methods, and allowed travel types.

Security
Bearer
Path
eventIdstringrequired

Event ID

Example: 6926658168
Bodyapplication/json
bookingGuidelinesArray of AirBookingGuidelineWrapper (object) or HotelBookingGuidelineWrapper (object) or CarBookingGuidelineWrapper (object) or RailBookingGuidelineWrapper (object)(EventBookingGuideline)required

A list of booking guideline for the event.

One of:

Booking details allowed for the event

bookingGuidelines[].​airBookingGuideLineobject(AirBookingGuideline)

Air related guidelines

bookingGuidelines[].​numGuestsAllowedinteger

Number of guests allowed to be booked for this booking

Example: 1
allowedBookingTypesArray of strings(EventAllowedBookingType)

Allowed booking types for the event group

Items Enum"AIR""HOTEL""CAR""RAIL"
allowedPaymentConfigArray of objects(AllowedPaymentConfig)
paymentMappingsArray of objects(PaymentAccessMapping)

Mappings i.e. access level, travel type information etc.

eventTypestring(EventType)
Enum"GENERIC""PROGRAM""PROGRAM_SESSION""PROGRAM_TRIP"
curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/events/6926658168/edit-booking-guidelines \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "bookingGuidelines": [
      {
        "numGuestsAllowed": 1,
        "airBookingGuideLine": {
          "allowedAirports": [
            {
              "airportCode": "WRA",
              "airportName": "Warder Airport",
              "cityName": "Werder",
              "countryName": "Ethiopia",
              "countryCode": "ET",
              "zoneName": "Africa/Addis_Ababa",
              "stateCode": "CA"
            }
          ],
          "allowedCityCodes": [
            "NYC"
          ],
          "arrivalBookingWindow": {
            "startDateTime": {
              "iso8601": "2017-07-21T17:32"
            },
            "endDateTime": {
              "iso8601": "2017-07-21T17:32"
            }
          },
          "departureBookingWindow": {
            "startDateTime": {
              "iso8601": "2017-07-21T17:32"
            },
            "endDateTime": {
              "iso8601": "2017-07-21T17:32"
            }
          },
          "allowedFlightGuidelines": [
            {
              "allowedFlightType": "ROUND_TRIP",
              "numberOfLegs": 2
            }
          ]
        }
      }
    ],
    "allowedBookingTypes": [
      "AIR"
    ],
    "allowedPaymentConfig": [
      {
        "travelType": "AIR",
        "paymentConfig": "TRAVELER_DEFAULT"
      }
    ],
    "paymentMappings": [
      {
        "id": "f49d00fe-1eda-4304-ba79-a980f565281d",
        "accessTypeAttributes": {
          "travelTypeFilter": {
            "travelTypes": [
              {
                "travelType": "AIR",
                "isRequired": true,
                "allowPostPaidBookings": false,
                "metadata": {
                  "vendors": []
                }
              }
            ]
          }
        }
      }
    ],
    "eventType": "GENERIC"
  }'

Responses

OK

Bodyapplication/json
idstring
Example: "some-id"
Response
application/json
{
  "id": "some-id"
}

Set traveler RSVP

Request

Update the RSVP status and the RSVP response for a traveler.

Security
Bearer
Path
eventIdstringrequired

Event ID

Example: 6926658168
travelerIdstring(uuid)required

Traveler User ID

Example: f49d00fe-1eda-4304-ba79-a980f565281d
Bodyapplication/json
typestring(EventType)
Enum"GENERIC""PROGRAM""PROGRAM_SESSION""PROGRAM_TRIP"
eventRsvpStatestring(EventRsvpState)
Enum"ADDED""INVITED""INVITE_ACCEPTED""INVITE_DECLINED""REMOVED"
eventRsvpResponseobject(EventRsvpResponse)
curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/events/6926658168/travelers/f49d00fe-1eda-4304-ba79-a980f565281d/rsvp \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "GENERIC",
    "eventRsvpState": "ADDED",
    "eventRsvpResponse": {
      "air": {
        "notNeeded": true
      },
      "hotel": {
        "notNeeded": true
      },
      "car": {
        "notNeeded": true
      },
      "rail": {
        "notNeeded": true
      }
    }
  }'

Responses

OK

Response
No content

Get traveler RSVP

Request

Get the RSVP status and the RSVP response for a traveler.

Security
Bearer
Path
eventIdstringrequired

Event ID

Example: 6926658168
travelerIdstring(uuid)required

Traveler User ID

Example: f49d00fe-1eda-4304-ba79-a980f565281d
curl -i -X GET \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/events/6926658168/travelers/f49d00fe-1eda-4304-ba79-a980f565281d/rsvp \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
userIdobject(UserId)
eventRsvpStatestring(EventRsvpState)
Enum"ADDED""INVITED""INVITE_ACCEPTED""INVITE_DECLINED""REMOVED"
eventRsvpResponseobject(EventRsvpResponse)
invitedAtobject(DateTimeOffset)
airBookingStatusstring(BookingStatusType)
Enum"BOOKED""NOT_BOOKED""OPTED_OUT"
railBookingStatusstring(BookingStatusType)
Enum"BOOKED""NOT_BOOKED""OPTED_OUT"
carBookingStatusstring(BookingStatusType)
Enum"BOOKED""NOT_BOOKED""OPTED_OUT"
hotelBookingStatusstring(BookingStatusType)
Enum"BOOKED""NOT_BOOKED""OPTED_OUT"
Response
application/json
{
  "userId": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  },
  "eventRsvpState": "ADDED",
  "eventRsvpResponse": {
    "air": { … },
    "hotel": { … },
    "car": { … },
    "rail": { … }
  },
  "invitedAt": {
    "iso8601": "2017-07-21T17:32Z"
  },
  "airBookingStatus": "BOOKED",
  "railBookingStatus": "BOOKED",
  "carBookingStatus": "BOOKED",
  "hotelBookingStatus": "BOOKED"
}
Copyright © 2025 Spotnana Technology, Inc.