Skip to content
API reference
/
/Approval

Trip API (v2)

Download OpenAPI description
TripApi.json
TripApi.yaml
Languages
Servers
Sandbox URL
https://api-ext-sboxmeta.partners.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.

Operations

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.

Security
Bearer
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 ApprovalStatusFilterV2 (object) or ApproverUserIdFilter (object) or ApprovalTypeFilter (object) or ApprovalDeadlineDateRangeFilter (object) or PrimaryTravelerIdFilter (object) or PnrTypeFilterV2 (object) or OutOfPolicyFilter (object) or ApprovalTripIdFilter (object)(ApprovalFilterV2)

Filter for the approval data list request.

curl -i -X POST \
  https://api-ext-sboxmeta.partners.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.

Security
Bearer
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 ApprovalStatusFilterV2 (object) or ApproverUserIdFilter (object) or ApprovalTypeFilter (object) or ApprovalDeadlineDateRangeFilter (object) or PrimaryTravelerIdFilter (object) or PnrTypeFilterV2 (object) or OutOfPolicyFilter (object) or ApprovalTripIdFilter (object)(ApprovalFilterV2)

Filter for the approval data list request.

curl -i -X POST \
  https://api-ext-sboxmeta.partners.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.