Cities

Cities Management

This section provides a comprehensive guide to managing the cities in our system. You will find various options for retrieving, filtering, and setting city information, each tailored to different requirements.

City Retrieval

Get All Cities

  • Endpoint: /get_cities
  • Description: This endpoint is designed to retrieve the complete list of cities available in our database, providing a comprehensive overview of all cities without applying any filters.
  • Usage Notes:
    • Pagination: To manage data effectively, this endpoint supports fetching up to 50 cities at a time.
    • Parameters:
    • offset - Specify the starting point of the row from which to begin fetching cities.
    • limit - Control the number of cities returned in a single request. The maximum limit is 50, but you can opt for a smaller number based on your needs.
    • Method: This functionality can be utilized by including payload or parameters in your POST request to manage the offset and limit.

These features are particularly useful for handling large datasets and for applications requiring batch processing of city information.

  • Full Documentation and Practical Examples: Get Cities




Filters

IN / NOT_IN Filter

  • Endpoint: /get_cities
  • Description: Use this endpoint to filter cities based on specific city IDs. It supports both inclusion (IN) and exclusion (NOT_IN) filters for city IDs.
  • Parameters:
    • IN - Specify the city IDs to include specific cities.
    • NOT_IN - Specify the city IDs to exclude specific cities.
    • You can use these parameters as arrays or single integers for more flexibility.

Setting City Information

Set Cities

  • Endpoint: /set_cities
  • Description: This is a crucial endpoint for updating or adding new cities to the database. It supports both insertion of new city details and updating existing ones.

For further assistance or API integration support, please refer to our API Documentation or contact our technical support team.