{
  "openapi" : "3.0.3",
  "info" : {
    "title" : "foursquare",
    "version" : "0.0.1-dev",
    "description" : "Foursquare API"
  },
  "servers" : [
    {
      "url" : "https://api.foursquare.com/v2"
    }
  ],
  "paths" : {
    "/venues/explore" : {
      "get" : {
        "description" : "Fetches venues nearby for a given query",
        "parameters" : [
          {
            "name" : "client_id",
            "in" : "query",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          },
          {
            "name" : "client_secret",
            "in" : "query",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          },
          {
            "name" : "v",
            "in" : "query",
            "description" : "Version parameter",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          },
          {
            "name" : "near",
            "in" : "query",
            "description" : "Search near this location",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          },
          {
            "name" : "query",
            "in" : "query",
            "description" : "What to search for",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          }
        ],
        "responses" : {
          "200" : {
            "description" : "List of venues",
            "content" : {
              "application/json" : {
                "schema" : {
                  "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenueExploreResponseWrapper"
                }
              }
            }
          }
        }
      }
    },
    "/venues/{venue_id}" : {
      "get" : {
        "description" : "Venue details",
        "parameters" : [
          {
            "name" : "venue_id",
            "in" : "path",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          },
          {
            "name" : "client_id",
            "in" : "query",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          },
          {
            "name" : "client_secret",
            "in" : "query",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          },
          {
            "name" : "v",
            "in" : "query",
            "description" : "Version parameter",
            "required" : true,
            "schema" : {
              "type" : "string"
            }
          }
        ],
        "responses" : {
          "200" : {
            "description" : "Venue detials",
            "content" : {
              "application/json" : {
                "schema" : {
                  "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenueDetailsResponseWrapper"
                }
              }
            }
          }
        }
      }
    }
  },
  "components" : {
    "schemas" : {
      "NataliaFoursquareV0ModelsPhoto" : {
        "description" : "Photo of venues",
        "type" : "object",
        "required" : [
          "prefix",
          "suffix",
          "width",
          "height"
        ],
        "properties" : {
          "prefix" : {
            "example" : "https://irs2.4sqi.net/img/general/",
            "type" : "string"
          },
          "suffix" : {
            "example" : "/5293444_GBJkT8dTt_lCCu2qbwK5vm6uX64LWoDUzvMh6tG3kxY",
            "type" : "string"
          },
          "width" : {
            "example" : 640,
            "type" : "integer",
            "format" : "int32"
          },
          "height" : {
            "example" : 640,
            "type" : "integer",
            "format" : "int32"
          }
        }
      },
      "NataliaFoursquareV0ModelsVenueDetailsResponse" : {
        "description" : "Venue details response",
        "type" : "object",
        "required" : [
          "venue"
        ],
        "properties" : {
          "venue" : {
            "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenue"
          }
        }
      },
      "NataliaFoursquareV0ModelsVenue" : {
        "description" : "Venue",
        "type" : "object",
        "required" : [
          "name",
          "id"
        ],
        "properties" : {
          "name" : {
            "description" : "Name",
            "example" : "The Beerhouse",
            "type" : "string"
          },
          "id" : {
            "description" : "Id",
            "example" : "51b2504c498e537d84ee84c3",
            "type" : "string"
          },
          "bestPhoto" : {
            "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsPhoto",
            "description" : "Best photo of venue"
          }
        }
      },
      "NataliaFoursquareV0ModelsVenueExploreResponse" : {
        "description" : "Explore venue response",
        "type" : "object",
        "required" : [
          "groups"
        ],
        "properties" : {
          "groups" : {
            "description" : "List of venue groups i.e. Recommended Places",
            "type" : "array",
            "items" : {
              "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenueGroup"
            }
          }
        }
      },
      "NataliaFoursquareV0ModelsVenueGroup" : {
        "description" : "Venue group",
        "type" : "object",
        "required" : [
          "items"
        ],
        "properties" : {
          "items" : {
            "description" : "Venue item",
            "type" : "array",
            "items" : {
              "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenueItem"
            }
          }
        }
      },
      "NataliaFoursquareV0ModelsVenueExploreResponseWrapper" : {
        "description" : "Explore venue response wrapper",
        "type" : "object",
        "required" : [
          "response"
        ],
        "properties" : {
          "response" : {
            "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenueExploreResponse",
            "description" : "Response content"
          }
        }
      },
      "NataliaFoursquareV0ModelsVenueDetailsResponseWrapper" : {
        "description" : "Venue details response wrapper",
        "type" : "object",
        "required" : [
          "response"
        ],
        "properties" : {
          "response" : {
            "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenueDetailsResponse"
          }
        }
      },
      "NataliaFoursquareV0ModelsVenueItem" : {
        "description" : "Venue item",
        "type" : "object",
        "required" : [
          "venue"
        ],
        "properties" : {
          "venue" : {
            "$ref" : "#/components/schemas/NataliaFoursquareV0ModelsVenue",
            "description" : "Venue"
          }
        }
      }
    }
  }
}