# Places

Full detail for one or more places — hours, phone, website, photos, address, coordinates, activity data — by the `mapbox_id`s a Search Box API result already returned, from the [Places API](https://docs.mapbox.com/api/search/places/). The command also takes the common flags — `--username`/`-u`, `--token`/`-t`, `--profile`, `--id` — described in [Shared parameters](https://docs.mapbox.com/ja/cli/reference/#shared-parameters).

This API has no search of its own. It only resolves IDs that [`mapbox search forward`, `reverse`, or `category`](https://docs.mapbox.com/ja/cli/reference/search/) already returned: the detail view that follows a search result, not a way to find places by name or location.

-   [`mapbox places`](#mapbox-places)

## `mapbox places`

One or more full place records, as `{"results": [...]}` with one entry per ID that resolved. The command always sends a batch request, so one ID and many give the same response shape.

The Places API is in public preview, with a quota of 1,000 records per account per month.

If only some IDs resolve, the command still succeeds and the response lists the rest under `missing` and/or `unprocessed`. If none resolve, it exits non-zero and prints the unresolved IDs to stderr.

**Parameters:**

| Parameter | Description |
| --- | --- |
| `<mapbox-id>...` | Required. One or more Mapbox IDs from a Search Box API result, up to 100. More than 100 is a usage error before any request goes out. |

**Examples:**

```sh
mapbox places dXJuOm1ieHBvaTpmYTE5Y2NhMC0yZmQ3LTQwMzgtYTEzNy02MzFmNGEwZDI5ODA
mapbox places dXJuOm1ieHBvaTpmYTE5Y2NhMC0yZmQ3LTQwMzgtYTEzNy02MzFmNGEwZDI5ODA \
  dXJuOm1ieHBvaTo1NTM4ZTE2OC0yMDM1LTRjODItODBkOC01NjY2YWM0MzhkYmE
mapbox places dXJuOm1ieHBvaTpmYTE5Y2NhMC0yZmQ3LTQwMzgtYTEzNy02MzFmNGEwZDI5ODA -o json
```