API reference

/

Company

/

Company API (v2)

Download OpenAPI description

CompanyApi.json

CompanyApi.yaml

Servers

Staging URL

https://apis.spotnana.com/

Spotnana mock server

https://developer.spotnana.com/_mock/openapi/companyapi/

Companies

APIs to onboard and manage company.

Operations

Legal Entities

APIs to create and manage company legal entities.

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

Create department

Request

This endpoint creates a department.

Path

companyIdstring(uuid)required

Identifier for company.

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

Bodyapplication/jsonrequired

namestringrequired

Name of the department

externalIdstring

External id of the department

Example: "department-external-id"

curl -i -X POST \
  https://apis.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/departments \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "string",
    "externalId": "department-external-id"
  }'

Responses

OK

Bodyapplication/json

idstring(uuid)required

Response

application/json

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
}

Get department

Request

This endpoint gets a department by ID.

Path

companyIdstring(uuid)required

Identifier for company.

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

departmentIdstring(uuid)required

Identifier for department.

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

curl -i -X GET \
  https://apis.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/departments/4974a66b-7493-4f41-908c-58ba81093947 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json

idstring(uuid)required

namestringrequired

Name of the department

Example: "IT Department"

externalIdstring

External id of the department

Example: "department-ext-id"

Response

application/json

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "IT Department",
  "externalId": "department-ext-id"
}

Update department

Request

This endpoint updates department by ID.

Path

companyIdstring(uuid)required

Identifier for company.

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

departmentIdstring(uuid)required

Identifier for department.

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

Bodyapplication/jsonrequired

idstring(uuid)required

namestringrequired

Name of the department

Example: "IT Department"

externalIdstring

External id of the department

Example: "department-ext-id"

curl -i -X PUT \
  https://apis.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/departments/4974a66b-7493-4f41-908c-58ba81093947 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "IT Department",
    "externalId": "department-ext-id"
  }'

Responses

Updated Successfully

Response

No content

Delete department

Request

This endpoint deletes department by ID.

Path

companyIdstring(uuid)required

Identifier for company.

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

departmentIdstring(uuid)required

Identifier for department.

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

Query

detachUsersboolean

Whether to remove this entity's reference from associated user entities.

Default false

curl -i -X DELETE \
  'https://apis.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/departments/4974a66b-7493-4f41-908c-58ba81093947?detachUsers=false' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Deleted Successfully

Response

No content

List departmentsDeprecated

Request

This endpoint lists departments of a company.

Path

companyIdstring(uuid)required

Identifier for company.

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

Query

externalIdstring

External id of the department.

Example: externalId=department-external-id

curl -i -X GET \
  'https://apis.spotnana.com/v2/companies/4974a66b-7493-4f41-908c-58ba81093947/departments?externalId=department-external-id' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Bodyapplication/json

lengthinteger(int32)

elementsArray of objects(Reference object containing uuid and name of the entity.)

List of references containing id and name.

totalNumResultsinteger(int32)

Total number of results

Response

application/json

{
  "length": 0,
  "elements": [
    { … }
  ],
  "totalNumResults": 0
}

Service Charge Plan

APIs to manage service charge plans.

Operations

Service Charge

Operations

Company Enrollment

Operations

Company Tier

Operations