Skip to content

Company 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/companyapi

Companies

APIs to onboard and manage company.

Operations

Cost Centers

APIs to create and manage company cost centers.

Operations

Offices

APIs to create and manage company offices.

Operations

Departments

APIs to create and manage departments.

Operations

Service Charge Plan

APIs to manage service charge plans.

Operations

Partner Public Keys

APIs to manage partner public keys for token exchange authentication.

Operations

Add partner public key

Request

Adds one or more public keys for a partner organization to use for token exchange authentication. Accessible to TMC, company, and global admins.

Security
Bearer
Path
companyIdstring(uuid)required

Organization identifier.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/jsonrequired
keyTypestring(PartnerPublicKeyType)required

The type of public key being registered.

Value"JWKS"
jwksobject(PartnerJwks)

JWKS containing the RSA public key. Required when keyType is JWKS.

curl -i -X POST \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/partner-public-keys \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "keyType": "JWKS",
    "jwks": {
      "keys": [
        {
          "kty": "RSA",
          "use": "sig",
          "alg": "RS256",
          "kid": "string",
          "n": "string",
          "e": "string"
        }
      ]
    }
  }'

Responses

Keys created successfully.

Bodyapplication/json
keysArray of objects(PartnerPublicKeyInfo)

List of added partner public keys.

Response
application/json
{ "keys": [ {} ] }

List partner public keys

Request

Lists partner public keys for a TMC. Accessible to TMC, company, and global admins.

Security
Bearer
Path
companyIdstring(uuid)required

Organization identifier.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Query
statusstring

Filter keys by status. Defaults to ACTIVE.

Enum"ACTIVE""REVOKED"
curl -i -X GET \
  'https://api-ext-sboxmeta.partners.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/partner-public-keys?status=ACTIVE' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json
keysArray of objects(PartnerPublicKeyInfo)

List of partner public keys.

Response
application/json
{ "keys": [ {} ] }

Revoke partner public key

Request

Revokes a partner public key identified by kid. Accessible to TMC, company, and global admins.

Security
Bearer
Path
companyIdstring(uuid)required

Organization identifier.

Example: 4974a66b-7493-4f41-908c-58ba81093947
kidstringrequired

Key ID (kid field from the JWK).

Example: my-key-1
curl -i -X DELETE \
  https://api-ext-sboxmeta.partners.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/partner-public-keys/my-key-1 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Key revoked successfully.

Response
No content

Service Charge

Operations

Company Enrollment

Operations

Company Tier

Operations

Stealth Config

Operations