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

# Retrieve Profile Map Views

> GET /mapbox/mapviews
> 
> Returns a profile's daily Mapbox map views over a period, with their sum. The profile's Mapbox token is looked up server-side; token ids are never returned.
> 
> `start` and `end` are each a date (`YYYY-MM-DD`, read as midnight UTC) or a date-time with a zone (`2026-10-01T00:00:00Z`, `2026-10-01T00:00:00.000+02:00`). Both are passed to Mapbox in UTC.
> 
> ### Authorization
> 
> Internal API clients only, and SERVER users only, whatever the server's ZWS mode.



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


## Authentication methods
- Oauth2


## Parameters
### Headers

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



### Query parameters

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

- **start** (string)
  start of the period, ISO-8601 date or date-time

- **end** (string)
  end of the period, ISO-8601 date or date-time; not before `start`



## Responses
### 200
OK

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

- **dates** (array[string])
  the start of each day, as Mapbox reports it

- **mapviews** (array[integer])
  map views per day, aligned with `dates`

- **total** (integer)
  the sum of `mapviews`


### 400
Bad Request - `profile_id` is missing or not a positive integer, `start` or `end` is missing or not an ISO-8601 date or date-time, or `start` is after `end`.

### 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 has no Mapbox token on this server.

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

### 502
Bad Gateway - Mapbox could not be reached, answered with an error (its HTTP status is in `error_message`), or returned an unexpected response.

### 503
Service Unavailable - the Mapbox user or key is not configured on this server.


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