API reference
/
Trip
/
Approval
/
List approval data for an approver

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 and PNRs.

Operations

Invoicing

Operations

Approval

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.