Retrieve Profile Map Views

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "iFormBuilder V80 MCP server": {
    "url": "https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/mcp"
  }
}

Close
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.

Headers

  • Authorization string

    e.g. Bearer {access_token}

Query parameters

  • profile_id integer Required

    id of the profile

  • start string Required

    start of the period, ISO-8601 date or date-time

  • end string Required

    end of the period, ISO-8601 date or date-time; not before start

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • profile_id integer Required
    • dates array[string] Required

      the start of each day, as Mapbox reports it

    • mapviews array[integer] Required

      map views per day, aligned with dates

    • total integer Required

      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.

GET /mapbox/mapviews
curl \
 --request GET 'https://api.iformbuilder.com/exzact/api/v80/[servername]/mapbox/mapviews?profile_id=123456&start=2026-10-01&end=2026-10-31' \
 --header "Authorization: Bearer {access_token}"
Response examples (200)
{
  "profile_id": 123456,
  "dates": [
    "2026-10-01T00:00:00.000Z",
    "2026-10-02T00:00:00.000Z",
    "2026-10-03T00:00:00.000Z"
  ],
  "mapviews": [
    3,
    0,
    12
  ],
  "total": 15
}