How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Spotnana Companies API

APIs to onboard and manage company.

Spotnana Companies API is one of 33 APIs that Spotnana publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Companies. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 21 operations across 9 paths, and defines 119 schemas. It is described by OpenAPI 3.2.0, at version v2.

Requests are made against a single base URL, https://api-ext-sboxmeta.partners.spotnana.com.

21 operations 9 paths 119 schemas 4 DELETE8 GET1 PATCH2 POST6 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v2
Base URL
https://apis.spotnana.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Spotnana Companies API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (Bearer). By default, every request must be authenticated.

Paths & Operations 21

Across 9 paths, the API surfaces 21 operations — 4 DELETE, 8 GET, 1 PATCH, 2 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

Companies 21

APIs to onboard and manage company.

POST
/v2/companies
Create company
createCompany body → 201400401403
GET
/v2/companies
List companies
listCompanies 7 params → 200401403
GET
/v2/companies/{companyId}
Get company
readCompany 2 params → 200401403404
PUT
/v2/companies/{companyId}
Update company
updateCompany 1 param body → 204400401403404
DELETE
/v2/companies/{companyId}
Delete company
deleteCompany 1 param → 204401403404
GET
/v2/companies/{companyId}/features
Get company features
getCompanyFeatures 3 params → 200401403404
PATCH
/v2/companies/{companyId}/features
Update Company Features
updateCompanyFeaturesPatch 3 params body → 200401403404
GET
/v2/companies/{companyId}/travel-content-config
Get company travel content config
getCompanyTravelContentConfig 1 param → 200401403404
PUT
/v2/companies/{companyId}/travel-content-config
Update company travel content config
updateCompanyTravelContentConfig 1 param body → 200401403404
DELETE
/v2/companies/{companyId}/travel-content-config
Delete company travel content config
deleteCompanyTravelContentConfig 1 param → 200401403404
PUT
/v2/companies/{companyId}/white-label-config
Updates white label config
updateCompanyWhiteLabelConfig 2 params body → 200400401403404
GET
/v2/companies/{companyId}/white-label-config
Get white label config
getCompanyWhiteLabelConfig 3 params → 200401403404
DELETE
/v2/companies/{companyId}/white-label-config
Delete white label config
deleteCompanyWhiteLabelConfig 2 params → 200400401403404
PUT
/v2/companies/{companyId}/managers-config
Updates company managers config
updateCompanyManagersConfig 2 params body → 200400401403404
GET
/v2/companies/{companyId}/managers-config
Get company managers config
getCompanyManagersConfig 2 params → 200401403404
DELETE
/v2/companies/{companyId}/managers-config
Delete company managers config
deleteCompanyManagersConfig 2 params → 200400401403404
PUT
/v2/companies/{companyId}/color-config
Updates Color config
updateColorConfig 2 params body → 200401403404
GET
/v2/companies/{companyId}/color-config
Get color config
getColorConfig 2 params → 200401403404
POST
/v2/companies/{companyId}/vendor-preferences
Upload company vendor preferences csv file
uploadCompanyPreferences 1 param body → 200401403404
PUT
/v2/companies/{companyId}/preference-tiers
Store tier levels with labels
storePreferenceTiers 1 param body → 200400401403404
GET
/v2/companies/{companyId}/preference-tiers
Read company preference tiers
listPreferenceTiers 1 param → 200400401403404

Schemas 119

The contract defines 119 schemas that model the data the API accepts and returns. The most detailed are Company (37 properties), CreateCompanyRequest (33 properties), WebLinksConfig (27 properties), PostalAddress (19 properties). Each schema is shown below with its type and property counts.

WebLinksConfig
object
Weblinks which are parts of WhiteLabelConfig.
27 properties
CabinViewFareCategory
string
NameSuffix
string
Suffix for name
AppDownloadLinksConfig
object
App store or QR links for downloading app.
3 properties
SecondaryServiceProviderTmc
object
Secondary service provider TMC info
3 properties 3 required
TmcInfo
object
TMC config information.
4 properties 2 required
CompanyRole
string
Role of the company.
ErrorResponse
object
2 properties
BrandingVisibility
object
Per-surface visibility of branding elements. Additive — default shows everything.
2 properties
ColorConfig
object
Color configuration for customizable colors in the UI.
1 property
PaymentMethod
string
Payment method
UserInfoEndpointResponseAttribute
object
auth Code metadata to get the user authenticated.
2 properties 2 required
CreateCompanyRequest
object
Request for company create.
33 properties 3 required
Tier
string
Tier of User. Note: In default UI, BASIC is displayed as Standard, and SEAT1A is displayed as VIP.
TmcBasicInfo
object
TMC related basic information.
2 properties 2 required
VerifierDetails
object
UpdateFeaturesRequest
object
2 properties
EmailClientType
string
FreshdeskCredentials
object
Mobile and web Credentials related to freshdesk.
2 properties
PrimaryServiceProviderTmc
object
Primary service provider TMC info
1 property 1 required
FeatureNameEnum
string
Name of the feature.
Weight
object
Specifies weight unit and weight amount.
2 properties 2 required
ExpenseOwner
object
Determines who should the expense be reported against.
2 properties
ThemeBorderTokens
object
6 properties
PreferenceTier
object
The level of preference with the display label.
4 properties 3 required
UserOrgId
object
User and user's organization information.
5 properties 2 required
Reference
object
Reference of an entity
2 properties 1 required
FareCategory
object
2 properties
NGSFareCategory
string
RewardsProgram
object
Rewards program details.
4 properties
SocialMediaLinksConfig
object
Social media links.
3 properties
ListPreferenceTiersResponse
object
List of preference tiers
1 property 1 required
PreferenceEntityType
string
Different type of entities at which one can store vendor preference.
OAuthPartnerConfig
object
Config for token exchange in case of partner's have their own IDP.
4 properties 3 required
OrganizationId
object
Organization id for traveler.
1 property 1 required
CompanySpecifiedAttributeCompany
object
Company-specified custom attribute.
2 properties 2 required
OrganizationAgencyId
object
Agency id for the organization.
1 property 1 required
Company
object
Company information.
37 properties 4 required
FlightPassPaymentMetadataWrapper
object
Wrapper for Flight Pass payment metadata.
2 properties 1 required
UpdateFeatureConfig
object
Feature enabled for company.
2 properties 2 required
EmailClientCredentials
object
Email client credentials for the company.
1 property 1 required
Connector
object
Connectors related to company.
2 properties 2 required
EmailClientSecretKey
object
EmailClientSecretKey
2 properties
RoleType
string
ThemeButtonOverride
object
1 property
DesignationNode
object
Designation tree for company showing who reports whom.
2 properties
Dimensions
object
Image dimensions ie width and height.
2 properties
FlightPassPaymentAmounts
object
Fare breakdown for the flight pass booking.
4 properties
TravelType
string
Travel Type
EntityId
object
Identifier of an object
1 property 1 required
ThemeIconTokens
object
1 property
EmergencyContactInfo
object
Emergency contact information.
6 properties 1 required
UploadCompanyVendorPreferencesRequest
object
Request for uploading company vendor preferences.
2 properties 1 required
TokenVerifier
object
Method to verify the external token sent by partners.
3 properties 1 required
WhiteLabelConfig
object
Whitelabel configuration.
14 properties
ExternalEndpoint
object
Generic object to encapsulate information about any external endpoint.
4 properties 2 required
ThemePalette
object
Semantic palette split by color mode. Empty token = use the Blocks default.
2 properties
CustomFieldType
string
The type of custom field.
PrivacyDisclaimer
object
Html to shown on the the login page. This will be text with hyper links.
2 properties
FreshdeskCredentialDetails
object
Credentials related to freshdesk.
3 properties 3 required
FreshdeskConfig
object
Configuration for freshdesk.
3 properties 2 required
LocationType
string
Type of the location object.
LocationItem
object
Object representing a single location object.
3 properties 3 required
EmailConfig
object
The email configuration part of the ExpensePartnerConfig.
4 properties 1 required
Money
object
Money object containing details such as the amount, the currency code, and the converted amount.
5 properties 2 required
ExpensePartner
string
The expense partner name as enum.
FareCategoryFilterConfig
object
Air fare category filter
4 properties 4 required
ThemeColorTokens
object
Semantic-role-based tokens (bg / text / border / icon).
4 properties
TmcPartnerRoleMapping
object
Mapping between spotnana role and partner company's role
2 properties 2 required
PreferenceTierLevel
string
Different levels of tier.
CompanyManagerInfo
object
Detailed information about a manager
5 properties 1 required
Announcement
object
Announcement details
4 properties 2 required
ColorWhiteLabelConfig
object
Whitelabel configuration related to colours.
15 properties
ThemeBgTokens
object
Background tokens. surface is the app/page background.
5 properties
FlightPassPaymentMetadata
object
Metadata specific to Flight Pass payment method in OtherCoinage.
2 properties
StorePreferenceTiersRequest
object
Request object to store preference tiers.
1 property 1 required
ThemeTextTokens
object
4 properties
TmcDefaultConfiguration
object
Default TMC configuration.
2 properties
TravelContentConfig
object
Travel content config
1 property
SupplierType
string
Supplier type like Sabre, TravelFusion etc.
ErrorParameter
object
Error parameter
2 properties
LocationMetadata
object
Metadata of the location object.
2 properties 2 required
ExpensePartnerConfig
object
Expense Partner Configuration
9 properties 1 required
PrivacySettings
object
Privacy settings for a company.
1 property
UserId
object
User identifier
1 property 1 required
VendorType
string
Types of vendors supported for company preferences.
ColorTitle
string
Title of the color.
PersonalCardConfig
object
Configuration for bookings done with Personal card.
2 properties
UserIdentifierType
string
Type of identifier for auth code Authentication
CarbonCostConfig
object
The config is used to calculate carbon cost of CO2 emission.
2 properties 2 required
OktaJwtVerifier
object
Details of Okta JWT verifier such as okta oauth endpoint, audience for which the token is issued.
2 properties 2 required
FeatureConfig
object
Feature enabled for company.
4 properties 2 required
FeatureConfigs
object
Features related to company.
2 properties
PreferenceTiersPerBookingType
object
List of preference tiers with respective labels for given booking type.
3 properties 3 required
ThemeButtonRadius
object
Border radius by button size. Empty = use the Blocks default.
3 properties
CompanyId
object
Company ID
1 property 1 required
ThemeOverrides
object
Per-component style overrides. Extensible — start with button.
1 property
Name
object
Full name containing first, middle, last (family) names, and suffix.
6 properties 2 required
Image
object
An image with meta data. Either the data or url property must be supplied to load the image.
3 properties
AirConfig
object
Air content config
1 property
RoutingConfig
object
App routing configuration.
1 property
FareCategoryOptionConfig
object
Fare category option to disable
2 properties 2 required
PhoneNumber
object
Properly formatted phone number.
10 properties
EmailClientConfig
object
Email Client Config
4 properties 3 required
SurfaceVisibility
object
Visibility of one branding element across surfaces. Each surface renderer honors only its own flag (e.g. email ignores hideOnWeb).
1 property
CompanyManagersConfig
object
Configuration for company managers (account managers and customer success managers).
2 properties
Latlng
object
Latitude and Longitude for a Location
2 properties 2 required
TitledColor
object
Color with associated title.
2 properties 2 required
FlightPassTax
object
A single tax component of the flight pass fare.
2 properties
ThemeConfigV2
object
Theming V2 config — maps 1:1 to the FE TWhiteLabelConfigV2 shape. Additive and opt-in.
3 properties
ProfileColors
array
The list of colors relating to profile.
SupportConfigs
object
2 properties
OktaJwtVerifierWrapper
object
1 property
BookingType
string
What type of travel booking it is.
PostalAddress
object
Postal Address Details
19 properties 2 required
SupportConfig
object
Support Configuration for company
10 properties
CompanyRef
object
Basic information about a company.
3 properties 1 required
ArrayOfReference
object
3 properties
ItineraryConfig
object
Itinerary configuration to control what expenses to send to the partner
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

spotnana-companies-api-openapi.yml Raw ↑

Other APIs Spotnana publishes across the network.

Spotnana Air API
Spotnana Air Credits API
Spotnana API User API
Spotnana Approval API
Spotnana Authentication API
Spotnana Autocomplete API
Spotnana Company Enrollment API
Spotnana Company Policies API
Spotnana Company Tier API
Spotnana Cost Centers API
Spotnana Custom Fields API
Spotnana Departments API
Where this information came from

This is an independent, third-party profile of Spotnana Companies API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.