# Developer - Users Documentation ## API Reference - [Managed User Endpoints](https://docs.foursquare.com/fsq-developers-users/reference/managed-user-endpoints.md) - [Create a Managed User](https://docs.foursquare.com/fsq-developers-users/reference/managed-user-create.md): Create a managed user for your project. This endpoint will create a managed user, and return the user's user_id and access_token. - [Delete a Managed User](https://docs.foursquare.com/fsq-developers-users/reference/managed-user-delete.md): Deletes a managed user. - [Refresh a Managed User's Access Token](https://docs.foursquare.com/fsq-developers-users/reference/managed-user-refresh-token.md): Refreshes an existing managed user's access token. Returns a new access token. - [Release Notes - Users API](https://docs.foursquare.com/fsq-developers-users/reference/release-notes-users-api.md) - [User Authentication Endpoints](https://docs.foursquare.com/fsq-developers-users/reference/user-authentication-endpoints.md) - [Create a Session Token](https://docs.foursquare.com/fsq-developers-users/reference/session-token-create.md): Create a short-lived session token for a user. The session token is used to authenticate a user on Placemaker Tools UI on behalf of a third-party app. Session tokens expire after 10 minutes. - [Users API Overview](https://docs.foursquare.com/fsq-developers-users/reference/users-api-overview.md) - [Authentication](https://docs.foursquare.com/fsq-developers-users/reference/authentication.md) - [Errors](https://docs.foursquare.com/fsq-developers-users/reference/errors.md) - [Foursquare APIs Overview](https://docs.foursquare.com/fsq-developers-users/reference/foursquare-apis-overview.md) - [Getting Started](https://docs.foursquare.com/fsq-developers-users/reference/getting-started.md) - [Localization](https://docs.foursquare.com/fsq-developers-users/reference/localization.md) - [Migration Guide](https://docs.foursquare.com/fsq-developers-users/reference/migration-guide.md) - [Pagination](https://docs.foursquare.com/fsq-developers-users/reference/pagination.md) - [Place Photo Guides](https://docs.foursquare.com/fsq-developers-users/reference/places-photo-guides.md) - [Rate Limits](https://docs.foursquare.com/fsq-developers-users/reference/rate-limits.md) - [Usage Guidelines](https://docs.foursquare.com/fsq-developers-users/reference/usage-guidelines.md) - [Visual Crediting Policy](https://docs.foursquare.com/fsq-developers-users/reference/visual-crediting-policy.md) # Developer - Places Documentation ## API Reference - [Autocomplete](https://docs.foursquare.com/fsq-developers-places/reference/autocomplete.md): Returns a list of top places, geos, and/or searches partially matching the provided keyword and location inputs. - [Find Geotagging Candidates](https://docs.foursquare.com/fsq-developers-places/reference/geotagging-candidates.md): Utilize Foursquare's Snap to Place technology to detect where your user's device is and what is around them. This endpoint will intentionally return lower quality results not found in Place Search. It is not intended to replace Place Search as the primary way to search for top, recommended POIs. - [Confirm Geotagging Candidate Selection](https://docs.foursquare.com/fsq-developers-places/reference/geotagging-confirm.md): Report the selection of a place as the result of a Geotagging Candidates request. - [Place Match](https://docs.foursquare.com/fsq-developers-places/reference/batch-place-match-1.md) - [Transaction Match](https://docs.foursquare.com/fsq-developers-places/reference/batch-transaction-match.md) - [Offline Jobs Guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-apis.md) - [Offline Jobs Onboarding Guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-onboarding-guide.md) - [Refresh Offline Job Credentials](https://docs.foursquare.com/fsq-developers-places/reference/offline-jobs-credentials-refresh.md): Refreshes temporary AWS credentials for an existing offline job. This is useful if your original credentials have expired. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-onboarding-guide). - [Execute an Offline Job](https://docs.foursquare.com/fsq-developers-places/reference/offline-jobs-execute.md): Execute a previously initialized offline job. Note you may not execute jobs that are already running or have completed, but you may use this endpoint to re-execute failed jobs. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-onboarding-guide). - [Initialize an Offline Job](https://docs.foursquare.com/fsq-developers-places/reference/offline-jobs-initialize.md): Initialize an offline job and generate temporary AWS credentials for uploading and reading data. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-onboarding-guide). - [Get Offline Jobs Status](https://docs.foursquare.com/fsq-developers-places/reference/offline-jobs-status.md): Check the status of previously submitted Places API offline jobs. Jobs and their statuses are retained for 90 days after initialization. For more details on how to use the Offline Jobs Endpoints, please refer to the [onboarding guide](https://docs.foursquare.com/fsq-developers-places/reference/offline-job-onboarding-guide). - [Flag a Place](https://docs.foursquare.com/fsq-developers-places/reference/place-flag.md): Flag a field(s) on a Place as incorrect. Does not require you to provide the correct value. - [Edit a Place](https://docs.foursquare.com/fsq-developers-places/reference/place-suggest-edit.md): Suggest edits to an existing Place?s information such as address, phone number, and hours of operation via its `fsq_place_id`. Providing values for the parameters below constitute the proposed edit. - [Remove a Place](https://docs.foursquare.com/fsq-developers-places/reference/place-suggest-remove.md): Flag an entire place for removal for reasons such as closed, doesn't exist, inappropriate, or private. - [Get Suggestion Status](https://docs.foursquare.com/fsq-developers-places/reference/place-suggest-status.md): Monitor the status of the places edits provided by your users or service keys. - [Get Places With Pending Suggested Edits](https://docs.foursquare.com/fsq-developers-places/reference/place-top-venue-woes.md): Get a list of the top places that need review for a given location. - [Suggest a New Place](https://docs.foursquare.com/fsq-developers-places/reference/places-suggest-place.md): Add a new place that does not currently exist. We will first attempt to find a match in our database. If we do not find a match, we will create a new suggested place. - [Merge Places](https://docs.foursquare.com/fsq-developers-places/reference/suggest-merge.md): Suggest the merge of two or more places. - [Places API Overview](https://docs.foursquare.com/fsq-developers-places/reference/places-api-overview.md) - [Release Notes - Places API](https://docs.foursquare.com/fsq-developers-places/reference/places-api-release-notes.md) - [Places Response Fields](https://docs.foursquare.com/fsq-developers-places/reference/response-fields.md) - [Ask](https://docs.foursquare.com/fsq-developers-places/reference/ask.md): Ask is a natural language place search that returns a list of places matching a natural-language question. Provide `query` with what the user wants (e.g., "best cocktail lounge in Williamsburg"). Ask needs a search area from one of three places: a place mentioned in `query`, `ll` (lat,lng), or `location` (geocodable string). If the query does not contain a place, you should provide either `ll` or `location`. You may also pass `context` to describe preferences (e.g., "traveling with kids, need outdoor seating"). **Note: The Ask Endpoint has different Pay as You Go [pricing](https://foursquare.com/pricing/#places_api) and [rate limits](https://docs.foursquare.com/fsq-developers-places/reference/rate-limits#ask-endpoint) than the rest of the Places API.** - [Get Place Details](https://docs.foursquare.com/fsq-developers-places/reference/place-details.md): Retrieve comprehensive information and metadata for a FSQ Place using the fsq_place_id. - [Place Match](https://docs.foursquare.com/fsq-developers-places/reference/place-match.md): Return the Foursquare record of a POI (via fsq_place_id) given a name and location. - [Get Place Photos](https://docs.foursquare.com/fsq-developers-places/reference/place-photos.md): Retrieve photos for a FSQ Place using the fsq_place_id. To retrieve photos from a Photos response, learn [how to assemble photo URLs](https://docs.foursquare.com/fsq-developers-places/reference/place-photo-guides#assembling-a-photo-url). - [Place Search](https://docs.foursquare.com/fsq-developers-places/reference/place-search.md): Search for places in the FSQ Places database using a location and querying by name, category name, telephone number, taste label, or chain name. For example, search for "coffee" to get back a list of recommended coffee shops. You may pass a location with your request by using one of the following options. If none of the following options are passed, Place Search defaults to geolocation using ip biasing with the optional radius parameter. - [Get Place Tips](https://docs.foursquare.com/fsq-developers-places/reference/place-tips.md): Retrieve tips for a FSQ Place using the fsq_place_id. - [Authentication](https://docs.foursquare.com/fsq-developers-places/reference/authentication.md) - [Errors](https://docs.foursquare.com/fsq-developers-places/reference/errors.md) - [Foursquare APIs Overview](https://docs.foursquare.com/fsq-developers-places/reference/foursquare-apis-overview.md) - [Getting Started](https://docs.foursquare.com/fsq-developers-places/reference/getting-started.md) - [Localization](https://docs.foursquare.com/fsq-developers-places/reference/localization.md) - [Migration Guide](https://docs.foursquare.com/fsq-developers-places/reference/migration-guide.md) - [Pagination](https://docs.foursquare.com/fsq-developers-places/reference/pagination.md) - [Place Photo Guides](https://docs.foursquare.com/fsq-developers-places/reference/place-photo-guides.md) - [Rate Limits](https://docs.foursquare.com/fsq-developers-places/reference/rate-limits.md) - [Usage Guidelines](https://docs.foursquare.com/fsq-developers-places/reference/usage-guidelines.md) - [Visual Crediting Policy](https://docs.foursquare.com/fsq-developers-places/reference/visual-crediting-policy.md)