API reference
/
Trip
/
Approval

Trip API (v2)

Download OpenAPI description
TripApi.json
TripApi.yaml
Languages
Servers
Staging URL
https://apis.spotnana.com/
Spotnana mock server
https://developer.spotnana.com/_mock/openapi/tripapi/

Trips

APIs to manage trips.

Operations

PNRs

APIs to manage PNRs within trips.

Invoicing

APIs to manage invoicing.

Operations

Approval

APIs to manage approvals.

Operations

List approval data for an approver

Request

Retrieves the list of approval data associated with an approver.

Path
userIdstring(uuid)required

Identifier for the approver whose approval data is requested.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/jsonrequired
paginationRequestParamsobject(OffsetBasedPaginationRequestParams)

Pagination parameters for requests.

includePnrSummariesboolean

Boolean flag to include PNR summaries in the response

Example: true
approvalFiltersArray of objects(ApprovalFilterV2)

Filter for the approval data list request.

curl -i -X POST \
  https://apis.spotnana.com/v3/approvals/approvers/4974a66b-7493-4f41-908c-58ba81093947/list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "paginationRequestParams": {
      "offset": 0,
      "limit": 100
    },
    "includePnrSummaries": true,
    "approvalFilters": [
      {
        "filterType": "APPROVAL_STATUS_FILTER",
        "approvalStatuses": [
          "APPROVED"
        ]
      }
    ]
  }'

Responses

OK

Bodyapplication/json
paginationResponseParamsobject(OffsetBasedPaginationResponseParams)required

Pagination parameters for response.

paginationResponseParams.​totalNumResultsinteger(int32)required

Total number of results.

approvalDataListArray of objects(ApprovalDataV2)

List of Approval Data

Response
application/json
{
  "paginationResponseParams": {
    "totalNumResults": 0
  },
  "approvalDataList": [
    { … }
  ]
}

List approval data for a company

Request

Retrieves the list of approval data associated with a company.

Path
companyIdstring(uuid)required

Identifier for the company whose approvals are requested.

Example: 4974a66b-7493-4f41-908c-58ba81093947
Bodyapplication/jsonrequired
paginationRequestParamsobject(OffsetBasedPaginationRequestParams)

Pagination parameters for requests.

includePnrSummariesboolean

Boolean flag to include PNR summaries in the response

Example: true
approvalFiltersArray of objects(ApprovalFilterV2)

Filter for the approval data list request.

curl -i -X POST \
  https://apis.spotnana.com/v3/approvals/companies/4974a66b-7493-4f41-908c-58ba81093947/list \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "paginationRequestParams": {
      "offset": 0,
      "limit": 100
    },
    "includePnrSummaries": true,
    "approvalFilters": [
      {
        "filterType": "APPROVAL_STATUS_FILTER",
        "approvalStatuses": [
          "APPROVED"
        ]
      }
    ]
  }'

Responses

OK

Bodyapplication/json
paginationResponseParamsobject(OffsetBasedPaginationResponseParams)required

Pagination parameters for response.

paginationResponseParams.​totalNumResultsinteger(int32)required

Total number of results.

approvalDataListArray of objects(ApprovalDataV2)

List of Approval Data

Response
application/json
{
  "paginationResponseParams": {
    "totalNumResults": 0
  },
  "approvalDataList": [
    { … }
  ]
}
Copyright © 2025 Spotnana Technology, Inc.