> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/llms.txt)

# Retrieve Profile Map View Settings

> GET /mapbox/profiles/{profile_id}
> 
> Returns a profile's map-view settings: whether map views are enabled, its monthly map-view threshold, and whether it has a Mapbox token. The token itself is never returned.
> 
> `allocated` is the sum of every profile's threshold on the server, enabled or not; `unallocated` is `server_mapview_limit` minus `allocated`, or `null` when the server has no cap (a negative `server_mapview_limit`).
> 
> ### Authorization
> 
> Internal API clients only, and SERVER users only, whatever the server's ZWS mode.



## Servers
- https://api.iformbuilder.com/exzact/api/v80/[servername]: https://api.iformbuilder.com/exzact/api/v80/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}


### Path parameters

- **profile_id** (integer)
  id of the profile




## Responses
### 200
OK

#### Body: application/json (object)
- **profile_id** (integer)

- **enabled** (boolean)
  whether map views are enabled for the profile

- **threshold** (integer)
  the profile's monthly map-view threshold

- **has_token** (boolean)
  `true` when the profile has a Mapbox token

- **server_mapview_limit** (integer)
  the server-wide map-view cap; negative means no cap

- **allocated** (integer)
  the sum of every profile's threshold on the server

- **unallocated** (integer | null)
  `server_mapview_limit` minus `allocated`; `null` when the server has no cap


### 401
Unauthorized - missing or invalid bearer token.

### 403
Forbidden - the client is not internal, or the user is not a SERVER user.

### 404
Not Found - the profile does not exist or has no company info.

### 409
Conflict - Mapbox is not enabled on this server.


[Powered by Bump.sh](https://bump.sh)
