Skip to content

User Management API (v2)

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

Users

APIs to onboard and manage users.

Operations

Get user travel arrangers

Request

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
curl -i -X GET \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/travel-arrangers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
travelArrangersArray of objects(TravelArrangerBasicInfo)required
travelArrangers[].​nameobject(Name)

Full name containing first, middle, last (family) names, and suffix.

travelArrangers[].​emailstring(email)
Example: "example@email.com"
travelArrangers[].​phoneNumbersArray of objects(PhoneNumber)
travelArrangers[].​userIdobject(UserId)required

User identifier

travelArrangers[].​userId.​idstring(uuid)required
travelArrangers[].​statusstring(TravelerArrangerStatus)

Status of the traveler-arranger assignment.

Enum"PENDING""ACCEPTED""DENIED"
Response
application/json
{ "travelArrangers": [ {} ] }

Approve or deny travel arrangers

Request

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/jsonrequired
arrangersArray of objects(UserIdWithArrangerStatus)required

Arrangers to be approved.

arrangers[].​userIdobject(UserId)required

User identifier

arrangers[].​userId.​idstring(uuid)required
arrangers[].​statusstring(TravelerArrangerStatus)required

Status of the traveler-arranger assignment.

Enum"PENDING""ACCEPTED""DENIED"
curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/travel-arrangers/approve \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "arrangers": [
      {
        "userId": {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        },
        "status": "PENDING"
      }
    ]
  }'

Responses

OK

Response
No content

Get travelers managed by the user.

Request

Security
Bearer
Path
userIdstring(uuid)required

Identifier for user.

Example: 4974a66b-7493-4f41-908c-58ba81093947
curl -i -X GET \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/users/4974a66b-7493-4f41-908c-58ba81093947/managed-travelers \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
travelersArray of objects(ManagedTravelerInfo)required
travelers[].​nameobject(Name)

Full name containing first, middle, last (family) names, and suffix.

travelers[].​emailstring(email)
Example: "example@email.com"
travelers[].​phoneNumbersArray of objects(PhoneNumber)
travelers[].​userIdobject(UserId)required

User identifier

travelers[].​userId.​idstring(uuid)required
travelers[].​statusstring(TravelerArrangerStatus)

Status of the traveler-arranger assignment.

Enum"PENDING""ACCEPTED""DENIED"
travelers[].​receiveEmailsboolean

Whether to receive emails of booking, flight notifications etc.

Default true
Response
application/json
{ "travelers": [ {} ] }

Roles

Operations