Skip to main content
POST
/
v1
/
pricing
/
get-pricing-for-trip
{
"trip_id": 123,
"trip_start_date": "2023-09-15T00:00:00.000Z",
"extra_costs": {
  "trip_extras": [
    {
      "extra_id": 1,
      "units": 2
    }
  ],
  "day_extras": [
    {
      "day_id": 1,
      "extra_id": 2,
      "units": 1
    }
  ]
},
"travellers": [
  {
    "date_of_birth": "1990-01-01T00:00:00.000Z",
    "citizenship": "Foreigner",
    "uuid": "123e4567-e89b-12d3-a456-426614174000"
  }
]
}

{
  "nett_rate": {
    "travellers": [
      {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "trip_cost": [
          {
            "name": "Basic Safari",
            "cost": 1200,
            "currency": "USD"
          }
        ],
        "extra_costs": [
          {
            "name": "Hot Air Balloon Ride",
            "cost": 300,
            "currency": "USD"
          }
        ],
        "day_costs": [
          {
            "name": "Day Trip to Ngorongoro",
            "cost": 200,
            "currency": "USD"
          }
        ]
      }
    ],
    "trip_cost": [
      {
        "name": "Total Trip Cost",
        "cost": 1200,
        "currency": "USD"
      }
    ],
    "extra_cost": [
      {
        "name": "Total Extra Activities",
        "cost": 300,
        "currency": "USD"
      }
    ],
    "day_cost": [
      {
        "name": "Total Day Costs",
        "cost": 200,
        "currency": "USD"
      }
    ]
  },
  "rack_rate": {
    "travellers": [
      {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "trip_cost": [
          {
            "name": "Basic Safari Retail",
            "cost": 1440,
            "currency": "USD"
          }
        ],
        "extra_costs": [
          {
            "name": "Hot Air Balloon Ride Retail",
            "cost": 360,
            "currency": "USD"
          }
        ],
        "day_costs": [
          {
            "name": "Day Trip to Ngorongoro Retail",
            "cost": 240,
            "currency": "USD"
          }
        ]
      }
    ],
    "trip_cost": [
      {
        "name": "Total Trip Cost Retail",
        "cost": 1440,
        "currency": "USD"
      }
    ],
    "extra_cost": [
      {
        "name": "Total Extra Activities Retail",
        "cost": 360,
        "currency": "USD"
      }
    ],
    "day_cost": [
      {
        "name": "Total Day Costs Retail",
        "cost": 240,
        "currency": "USD"
      }
    ]
  }
}
This endpoint will return the trip price. There are two sets of pricing that’s returned via this endpoint. The first trip price returned is the Nett Rate and the second price possibly returned is the Rack Rate.

​
Nett Rate

The Nett Rate is the basic cost of the trip. This is the amount that you will require to send to us when a trip is ready to be booked. We’ve negotiated Nett rates with our suppliers to get you the best price for a trip. This will give you a competitive edge to markup and then sell a trip at your price. The Nett Rate includes a fee from CloudSafaris that’s decided when CloudSafari, Inc. and your company enter into a contractual agreement together.

​
Rack Rate

The Rack Rate is the minimum rate you’re required to sell a trip at. Our suppliers have base rates (rack rates) that they will sell to customers if a customer was to inquire directly with them. Based on the contracts, you are legally obliged to sell at a minimum of this price so that you do not compete directly with the suppliers.
If the Rack Rate is not returned, you are free to markup and sell a trip with no minimum amount. I.e. you would be allowed to sell a trip at the Nett rate.

​
Header Parameters

​
CloudSafaris-API-Version
string
default:"v1"
Currently the only acceptable value is v1.

​
Request Body Parameters

​
trip_id
number
required
The unique identifier for the trip.
​
trip_start_date
string
required
The start date for the trip (ISO formatted) as selected by the traveller.
​
extra_costs
object
required
​
travellers
object
required
A minimum of 1 traveller is required.
{
"trip_id": 123,
"trip_start_date": "2023-09-15T00:00:00.000Z",
"extra_costs": {
  "trip_extras": [
    {
      "extra_id": 1,
      "units": 2
    }
  ],
  "day_extras": [
    {
      "day_id": 1,
      "extra_id": 2,
      "units": 1
    }
  ]
},
"travellers": [
  {
    "date_of_birth": "1990-01-01T00:00:00.000Z",
    "citizenship": "Foreigner",
    "uuid": "123e4567-e89b-12d3-a456-426614174000"
  }
]
}

​
Response Body Parameters

​
data
object
​
nett_rate
object
required
The Nett Rate is the cost required to pay CloudSafari, Inc. to operate this trip.
​
rack_rate
object
The Rack Rate is the minimum rate you’re allowed to advertise this trip at. If this field is not returned back, you’re free to sell this trip at the Nett Rate provided.
{
  "nett_rate": {
    "travellers": [
      {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "trip_cost": [
          {
            "name": "Basic Safari",
            "cost": 1200,
            "currency": "USD"
          }
        ],
        "extra_costs": [
          {
            "name": "Hot Air Balloon Ride",
            "cost": 300,
            "currency": "USD"
          }
        ],
        "day_costs": [
          {
            "name": "Day Trip to Ngorongoro",
            "cost": 200,
            "currency": "USD"
          }
        ]
      }
    ],
    "trip_cost": [
      {
        "name": "Total Trip Cost",
        "cost": 1200,
        "currency": "USD"
      }
    ],
    "extra_cost": [
      {
        "name": "Total Extra Activities",
        "cost": 300,
        "currency": "USD"
      }
    ],
    "day_cost": [
      {
        "name": "Total Day Costs",
        "cost": 200,
        "currency": "USD"
      }
    ]
  },
  "rack_rate": {
    "travellers": [
      {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "trip_cost": [
          {
            "name": "Basic Safari Retail",
            "cost": 1440,
            "currency": "USD"
          }
        ],
        "extra_costs": [
          {
            "name": "Hot Air Balloon Ride Retail",
            "cost": 360,
            "currency": "USD"
          }
        ],
        "day_costs": [
          {
            "name": "Day Trip to Ngorongoro Retail",
            "cost": 240,
            "currency": "USD"
          }
        ]
      }
    ],
    "trip_cost": [
      {
        "name": "Total Trip Cost Retail",
        "cost": 1440,
        "currency": "USD"
      }
    ],
    "extra_cost": [
      {
        "name": "Total Extra Activities Retail",
        "cost": 360,
        "currency": "USD"
      }
    ],
    "day_cost": [
      {
        "name": "Total Day Costs Retail",
        "cost": 240,
        "currency": "USD"
      }
    ]
  }
}
⌘I