Skip to main content
POST
/
v1
/
get-destinations-with-ids
{
  "ids": [1,5,20]
}

[
    {
        "id": 141,
        "country": "Tanzania",
        "name": "Serengeti National Park",
        "description": "A detailed description of Serengeti National Park, covering its vast ecosystems and rich wildlife.",
        "short_description": "Iconic national park known for its annual wildebeest migration.",
        "geographic_size": 14750,
        "altitude": 920,
        "population": 0,
        "best_time_to_visit": "June to October",
        "latitude": -2.3328,
        "longitude": 34.5665,
        "images": [
            "url_to_image1.jpg",
            "url_to_image2.jpg"
        ],
        "destination_type": "National Park",
        "faq": [
            {
                "question": "What is the best time to visit Serengeti National Park?",
                "answer": "The best time to visit is from June to October for the wildebeest migration."
            }
        ],
        "extra_details": [
            {
                "type": "Getting There",
                "title": "Accessing Serengeti National Park",
                "description": "Information on how to get to Serengeti National Park by air and land.",
                "url": "url_to_more_information.com"
            }
        ],
        "wildlife": [
            {
            "name": "Lion",
            "description": "Detailed description of lions in Serengeti, including their behavior and best places to see them.",
            "images": [
                "https://cloudsafaris.com/images/public/url_to_lion_image"
            ],
            "rarity": "Common"
            }
        ]
    }
]

​
Header Parameters

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

​
Request Body Parameters

​
ids
number[]
required
An array of numbers which corresponds to the unique identifiers (ids) of the destinations.
{
  "ids": [1,5,20]
}

​
Response Body Parameters

​
id
number
The unique identified for the destination.
​
country
string
The country that the destination is in.
​
name
string
The name of the destination.
​
description
string
The description for the destination.
​
short_description
string
A short description for the destination.
​
geographic_size
number
If this is a region, geographic size will give the size of the area (km^2).
​
altitude
number
If the destination is at a certain altitude this will return the altitude in meters.
​
population
number
Population data for the destination.
​
best_time_to_visit
string
Information related to the best time to visit a destination.
​
latitude
number
The latitude of the destination.
​
longitude
number
The longitude of a destination
​
images
string[]
The image URLs for a given destination.
​
destination_type
string
Takes on one of the following values: "National Park", "Wildlife Conservancy", "International Airport", "Domestic Airport", "Airstrip", "Mountain", "City", "Village", "Beach", "Market", "Museums and Art Galleries", "Vineyards and Wineries", "Not Specified", "Landmark", "Geographical feature", "Camp", "Region", "Peak", "Gate", "Lake"
​
faq
object[]
​
extra_details
object[]
Extra details contain information about a destination like “Getting Around” or “Visas”.
​
wildlife
object[]
An array of data pertaining to the wildlife at a particular destination.
[
    {
        "id": 141,
        "country": "Tanzania",
        "name": "Serengeti National Park",
        "description": "A detailed description of Serengeti National Park, covering its vast ecosystems and rich wildlife.",
        "short_description": "Iconic national park known for its annual wildebeest migration.",
        "geographic_size": 14750,
        "altitude": 920,
        "population": 0,
        "best_time_to_visit": "June to October",
        "latitude": -2.3328,
        "longitude": 34.5665,
        "images": [
            "url_to_image1.jpg",
            "url_to_image2.jpg"
        ],
        "destination_type": "National Park",
        "faq": [
            {
                "question": "What is the best time to visit Serengeti National Park?",
                "answer": "The best time to visit is from June to October for the wildebeest migration."
            }
        ],
        "extra_details": [
            {
                "type": "Getting There",
                "title": "Accessing Serengeti National Park",
                "description": "Information on how to get to Serengeti National Park by air and land.",
                "url": "url_to_more_information.com"
            }
        ],
        "wildlife": [
            {
            "name": "Lion",
            "description": "Detailed description of lions in Serengeti, including their behavior and best places to see them.",
            "images": [
                "https://cloudsafaris.com/images/public/url_to_lion_image"
            ],
            "rarity": "Common"
            }
        ]
    }
]
⌘I