# Get filtered map markers for a public webpage

Resolves map markers for a public map component. Object-bound sources are filtered in Cypher before the 500-marker cap.

Endpoint: POST /api/v2/webpages/public/maps/{pageUuid}/{componentUuid}
Version: 2.0
Security: bearerAuth

## Header parameters:

  - `X-Caraer-Subdomain` (string, required)

  - `X-Caraer-Environment` (string)

  - `X-Caraer-Primary-Environment` (string)

  - `Authorization` (string)

  - `X-Caraer-Webpage-Access` (string)

## Query parameters:

  - `access` (string)

  - `token` (string)

## Path parameters:

  - `pageUuid` (string, required)

  - `componentUuid` (string, required)

## Request fields (application/json):

  - `page` (integer)
    The page index (one-based) to request.
    Example: 1

  - `limit` (integer)
    The number of records to retrieve per page.
    Example: 10

  - `filter` (object)
    Filters applied to the query.
    Example: {"groups":[]}

  - `sort` (array)
    Sorting options for the query.
    Example: [{"object":"user","property":"createdAt","direction":"DESC"}]

  - `show` (array)
    Specifies what data to show in the response.
    Example: [{"object":"user","property":"name"}]

  - `query` (string)
    A free-text search query applied to the records.
    Example: "keyword"

  - `preview` (string)
    Preview information for the records, if supported.

  - `mainObject` (string)
    The main object for categorization or context.
    Example: "user"

  - `column` (string)
    The column to group the records by.

## Response 200 fields (application/json):

  - `message` (string)
    A message detailing the result of the operation.
    Example: "Success"

  - `data` (object)
    The data payload of the response, if any.

  - `data.mapLocations` (array)
    Concrete markers after applying public filters

  - `data.mapLocations.latitude` (number)

  - `data.mapLocations.longitude` (number)

  - `data.mapLocations.propertyUuid` (string)
    UUID of a location property

  - `data.mapLocations.propertyName` (string)
    Name of a location property (fallback if uuid missing)

  - `data.mapLocations.objectUuid` (string)
    When set, resolve markers from published records of this object. Exclusive with propertyUuid and custom lat/lng.

  - `data.mapLocations.objectName` (string)
    Object name fallback when uuid is missing

  - `data.mapLocations.icon` (string)
    FontAwesome icon key for the marker

  - `data.mapLocations.iconColor` (string)
    Marker icon color (hex or rgba)

  - `data.mapLocations.iconBackgroundColor` (string)
    Marker pin background fill color (hex or rgba)

  - `data.mapLocations.markerSize` (number)
    Marker pin size in CSS pixels

  - `data.mapLocations.iconSize` (number)
    Marker glyph size in CSS pixels

  - `data.mapLocations.label` (string)
    Text shown when hovering the marker (supports smart content)

  - `data.mapLocations.labelPropertyUuid` (string)
    UUID of a property whose value is shown as hover text

  - `data.mapLocations.labelPropertyName` (string)
    Name of a property whose value is shown as hover text

  - `data.mapLocations.hoverPreviewUuid` (string)
    UUID of the preview shown when hovering a bound marker

  - `data.mapLocations.hoverPreviewName` (string)
    Name of the preview shown when hovering a bound marker

  - `data.mapLocations.recordUuid` (string)
    Record this concrete public marker was resolved from

  - `data.mapLocations.clickLinkType` (string)
    Marker click target: liveUrl, custom, or unset

  - `data.mapLocations.clickLinkUrl` (string)
    Custom URL used when clickLinkType is custom

  - `data.mapLocations.clickLinkOpenInNewWindow` (boolean)
    Open the marker link in a new tab

  - `data.mapLocations.href` (string)
    Resolved public URL for this concrete marker

  - `data.mapLocations.filterProperties` (array)
    Properties exposed as public filters for object-bound markers

  - `data.mapLocations.filterProperties.uuid` (string, required)
    Unique identifier for the entity

  - `data.mapLocations.filterProperties.name` (string)
    The name identifier of the property

  - `data.mapLocations.filterProperties.label` (string)
    Display label for the property

  - `data.mapLocations.filterProperties.createdAt` (integer)
    Unix timestamp when the entity was created

  - `data.mapLocations.filterProperties.createdBy` (object)
    Identifier of the user who created the entity

  - `data.mapLocations.filterProperties.createdBy.name` (string, required)

  - `data.mapLocations.filterProperties.createdBy.label` (string)

  - `data.mapLocations.filterProperties.createdBy.createdAt` (integer)

  - `data.mapLocations.filterProperties.createdBy.updatedAt` (integer)

  - `data.mapLocations.filterProperties.createdBy.deletedAt` (integer)

  - `data.mapLocations.filterProperties.createdBy.createdByUuid` (string)

  - `data.mapLocations.filterProperties.createdBy.updatedByUuid` (string)

  - `data.mapLocations.filterProperties.createdBy.deletedByUuid` (string)

  - `data.mapLocations.filterProperties.createdBy.index` (integer)

  - `data.mapLocations.filterProperties.createdBy.deleted` (boolean)

  - `data.mapLocations.filterProperties.createdBy.complete` (boolean)

  - `data.mapLocations.filterProperties.createdBy.uuid` (string, required)

  - `data.mapLocations.filterProperties.createdBy.properties` (array)

  - `data.mapLocations.filterProperties.createdBy.properties.icon` (string)

  - `data.mapLocations.filterProperties.createdBy.properties.name` (string)

  - `data.mapLocations.filterProperties.createdBy.properties.value` (any)

  - `data.mapLocations.filterProperties.createdBy.properties.type` (string)

  - `data.mapLocations.filterProperties.createdBy.properties.label` (string)

  - `data.mapLocations.filterProperties.createdBy.objects` (object)

  - `data.mapLocations.filterProperties.createdBy.user` (object)

  - `data.mapLocations.filterProperties.createdBy.user.uuid` (string)

  - `data.mapLocations.filterProperties.createdBy.user.email` (string)

  - `data.mapLocations.filterProperties.createdBy.user.firstname` (string)

  - `data.mapLocations.filterProperties.createdBy.user.lastname` (string)

  - `data.mapLocations.filterProperties.createdBy.user.initials` (string)

  - `data.mapLocations.filterProperties.createdBy.user.scopes` (array)

  - `data.mapLocations.filterProperties.createdBy.user.filters` (object)

  - `data.mapLocations.filterProperties.createdBy.user.role` (string)

  - `data.mapLocations.filterProperties.createdBy.user.record` (object)

  - `data.mapLocations.filterProperties.updatedAt` (integer)
    Unix timestamp when the entity was last updated

  - `data.mapLocations.filterProperties.updatedBy` (object)
    Identifier of the user who last updated the entity

  - `data.mapLocations.filterProperties.updatedBy.name` (string, required)

  - `data.mapLocations.filterProperties.updatedBy.label` (string)

  - `data.mapLocations.filterProperties.updatedBy.createdAt` (integer)

  - `data.mapLocations.filterProperties.updatedBy.updatedAt` (integer)

  - `data.mapLocations.filterProperties.updatedBy.deletedAt` (integer)

  - `data.mapLocations.filterProperties.updatedBy.createdByUuid` (string)

  - `data.mapLocations.filterProperties.updatedBy.updatedByUuid` (string)

  - `data.mapLocations.filterProperties.updatedBy.deletedByUuid` (string)

  - `data.mapLocations.filterProperties.updatedBy.index` (integer)

  - `data.mapLocations.filterProperties.updatedBy.deleted` (boolean)

  - `data.mapLocations.filterProperties.updatedBy.complete` (boolean)

  - `data.mapLocations.filterProperties.updatedBy.uuid` (string, required)

  - `data.mapLocations.filterProperties.updatedBy.properties` (array)

  - `data.mapLocations.filterProperties.updatedBy.properties.icon` (string)

  - `data.mapLocations.filterProperties.updatedBy.properties.name` (string)

  - `data.mapLocations.filterProperties.updatedBy.properties.value` (any)

  - `data.mapLocations.filterProperties.updatedBy.properties.type` (string)

  - `data.mapLocations.filterProperties.updatedBy.properties.label` (string)

  - `data.mapLocations.filterProperties.updatedBy.objects` (object)

  - `data.mapLocations.filterProperties.updatedBy.user` (object)

  - `data.mapLocations.filterProperties.updatedBy.user.uuid` (string)

  - `data.mapLocations.filterProperties.updatedBy.user.email` (string)

  - `data.mapLocations.filterProperties.updatedBy.user.firstname` (string)

  - `data.mapLocations.filterProperties.updatedBy.user.lastname` (string)

  - `data.mapLocations.filterProperties.updatedBy.user.initials` (string)

  - `data.mapLocations.filterProperties.updatedBy.user.scopes` (array)

  - `data.mapLocations.filterProperties.updatedBy.user.filters` (object)

  - `data.mapLocations.filterProperties.updatedBy.user.role` (string)

  - `data.mapLocations.filterProperties.updatedBy.user.record` (object)

  - `data.mapLocations.filterProperties.deletedAt` (integer)
    Unix timestamp when the entity was deleted (null if not deleted)

  - `data.mapLocations.filterProperties.deletedBy` (object)
    Identifier of the user who deleted the entity

  - `data.mapLocations.filterProperties.deletedBy.name` (string, required)

  - `data.mapLocations.filterProperties.deletedBy.label` (string)

  - `data.mapLocations.filterProperties.deletedBy.createdAt` (integer)

  - `data.mapLocations.filterProperties.deletedBy.updatedAt` (integer)

  - `data.mapLocations.filterProperties.deletedBy.deletedAt` (integer)

  - `data.mapLocations.filterProperties.deletedBy.createdByUuid` (string)

  - `data.mapLocations.filterProperties.deletedBy.updatedByUuid` (string)

  - `data.mapLocations.filterProperties.deletedBy.deletedByUuid` (string)

  - `data.mapLocations.filterProperties.deletedBy.index` (integer)

  - `data.mapLocations.filterProperties.deletedBy.deleted` (boolean)

  - `data.mapLocations.filterProperties.deletedBy.complete` (boolean)

  - `data.mapLocations.filterProperties.deletedBy.uuid` (string, required)

  - `data.mapLocations.filterProperties.deletedBy.properties` (array)

  - `data.mapLocations.filterProperties.deletedBy.properties.icon` (string)

  - `data.mapLocations.filterProperties.deletedBy.properties.name` (string)

  - `data.mapLocations.filterProperties.deletedBy.properties.value` (any)

  - `data.mapLocations.filterProperties.deletedBy.properties.type` (string)

  - `data.mapLocations.filterProperties.deletedBy.properties.label` (string)

  - `data.mapLocations.filterProperties.deletedBy.objects` (object)

  - `data.mapLocations.filterProperties.deletedBy.user` (object)

  - `data.mapLocations.filterProperties.deletedBy.user.uuid` (string)

  - `data.mapLocations.filterProperties.deletedBy.user.email` (string)

  - `data.mapLocations.filterProperties.deletedBy.user.firstname` (string)

  - `data.mapLocations.filterProperties.deletedBy.user.lastname` (string)

  - `data.mapLocations.filterProperties.deletedBy.user.initials` (string)

  - `data.mapLocations.filterProperties.deletedBy.user.scopes` (array)

  - `data.mapLocations.filterProperties.deletedBy.user.filters` (object)

  - `data.mapLocations.filterProperties.deletedBy.user.role` (string)

  - `data.mapLocations.filterProperties.deletedBy.user.record` (object)

  - `data.mapLocations.filterProperties.index` (integer)
    Index number for ordering entities

  - `data.mapLocations.filterProperties.description` (string)
    Detailed description of the property's purpose and usage

  - `data.mapLocations.filterProperties.type` (string)
    The data type of the property (e.g., 'string', 'number', 'date', etc.)

  - `data.mapLocations.filterProperties.options` (array)
    List of predefined options for properties that support selection

  - `data.mapLocations.filterProperties.options.name` (string)

  - `data.mapLocations.filterProperties.options.label` (string)

  - `data.mapLocations.filterProperties.options.icon` (string)

  - `data.mapLocations.filterProperties.options.color` (string)

  - `data.mapLocations.filterProperties.options.disabled` (boolean)

  - `data.mapLocations.filterProperties.options.completed` (boolean)

  - `data.mapLocations.filterProperties.options.usedIn` (object)

  - `data.mapLocations.filterProperties.options.usedIn.recordUuids` (array)

  - `data.mapLocations.filterProperties.options.usedIn.count` (integer)

  - `data.mapLocations.filterProperties.group` (string)
    Group name for organizing related properties

  - `data.mapLocations.filterProperties.format` (any)
    Format configuration for the property's display and validation

  - `data.mapLocations.filterProperties.rules` (array)
    Collection of validation rules applied to the property

  - `data.mapLocations.filterProperties.immutable` (boolean)
    Indicates if the property value cannot be modified after initial creation

  - `data.mapLocations.filterProperties.hidden` (boolean)
    Indicates if the property should be hidden from view

  - `data.mapLocations.filterProperties.lifecycleActive` (boolean)
    When true, property value changes are tracked as lifecycle records

  - `data.mapLocations.filterProperties.requiredFilter` (object)
    When this filter matches the record being saved, the property becomes required

  - `data.mapLocations.filterProperties.requiredFilter.groups` (array)
    A collection of filter groups.

  - `data.mapLocations.filterProperties.requiredFilter.groups.items` (object)
    A set of filter items included in the group.

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.object` (string)
    The name of the object to which this pagination item belongs.
    Example: "User"

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.relation` (string)
    The relationship between objects.
    Example: "hasProperty"

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.relationDirection` (string)
    Optional relation direction: outgoing (related→main), incoming (main→related), or omit for undirected.
    Example: "outgoing"

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.property` (string)
    The name of the property within the object.
    Example: "email"

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.relationIncluded` (boolean)
    Specifies whether the relation is included.
    Example: true

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.operator` (string)
    Defines the operator used in the filter. Available operators are defined in the API documentation.
    Example: "EQUALS"

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.value` (any)
    Represents the value to filter against.
    Example: 12345

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.smartContent` (boolean)
    When true, filter fields contain smart content placeholders resolved at runtime.
    Example: true

  - `data.mapLocations.filterProperties.requiredFilter.groups.items.edgeProperty` (boolean)
    When true, propertyName refers to a property stored on the relation edge itself (declared on the relation schema, e.g. partstat on attendees) instead of a property of the related record. Requires relation and propertyName.

  - `data.mapLocations.filterProperties.nonPublic` (boolean)
    Indicates if the property should be excluded from public APIs

  - `data.mapLocations.filterProperties.indexed` (boolean)
    Indicates if the property should be indexed for searching

  - `data.mapLocations.filterProperties.editable` (boolean)
    Indicates if the property value can be modified

  - `data.mapLocations.filterProperties.formatSettings` (object)
    Additional format-specific settings for the property

  - `data.mapLocations.filterProperties.usedIn` (object)
    Information about where this property is used in the system

  - `data.mapLocations.filterProperties.usedIn.recordUuids` (array)

  - `data.mapLocations.filterProperties.usedIn.count` (integer)

  - `data.mapLocations.filterProperties.icon` (string)
    Icon identifier for visual representation of the property

  - `data.mapLocations.filterProperties.webpagePublic` (boolean)
    Indicates if the property can be used in webpages

  - `data.mapLocations.filterProperties.sensitive` (boolean)
    When true, exclude from advanced query evidence

  - `data.mapLocations.filterProperties.minAndMaxValue` (object)
    The minimum and maximum value of the property

  - `data.mapLocations.filterProperties.minAndMaxValue.t1` (integer)

  - `data.mapLocations.filterProperties.minAndMaxValue.t2` (integer)

  - `data.mapLocations.filterProperties.pinned` (boolean)
    Indicates if the property is pinned by the logged-in user

  - `data.mapLocations.filterProperties.embeddable` (boolean)
    Indicates if the property can be embedded in other properties

  - `data.mapLocations.filterValues` (object)
    Resolved property values used to filter this concrete marker

## Response 401 fields (application/json):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (array)
    A list of error types providing further details about the error.

  - `errors.message` (string, required)
    The error message providing details about the failure.
    Example: "Invalid file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Roles the caller is missing when the failure is an authorization error.
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)
    Scopes the caller is missing when the failure is an authorization error.

  - `requestId` (string)
    Request correlation ID for support and log tracing.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

## Response 403 fields (application/json):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (array)
    A list of error types providing further details about the error.

  - `errors.message` (string, required)
    The error message providing details about the failure.
    Example: "Invalid file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Roles the caller is missing when the failure is an authorization error.
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)
    Scopes the caller is missing when the failure is an authorization error.

  - `requestId` (string)
    Request correlation ID for support and log tracing.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

## Response 404 fields (application/json):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (array)
    A list of error types providing further details about the error.

  - `errors.message` (string, required)
    The error message providing details about the failure.
    Example: "Invalid file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Roles the caller is missing when the failure is an authorization error.
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)
    Scopes the caller is missing when the failure is an authorization error.

  - `requestId` (string)
    Request correlation ID for support and log tracing.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

## Response 500 fields (application/json):

  - `message` (string)
    The error message providing details about the failure.
    Example: "Resource not found."

  - `errors` (array)
    A list of error types providing further details about the error.

  - `errors.message` (string, required)
    The error message providing details about the failure.
    Example: "Invalid file type."

  - `errors.type` (string, required)
    The type of error.
    Enum: "VALIDATION", "NOT_FOUND", "TEST", "RELATION_NOT_ALLOWED", "INVALID_VALUE", "GENERAL", "INVALID_FILE_TYPE", "INTERNAL_SERVER_ERROR", "CARAER_ERROR", "INVALID_EMAIL", "INVALID_DATE"

  - `errors.correctionSuggestion` (string, required)
    A suggestion on how to correct the error.
    Example: "Try uploading a different file type."

  - `status` (integer)
    The HTTP status code associated with the error.
    Example: 400

  - `stackTrace` (string)

  - `roles` (array)
    Roles the caller is missing when the failure is an authorization error.
    Enum: "USER", "ADMIN", "RESELLER", "DEVELOPER", "SUPER_ADMIN"

  - `scopes` (array)
    Scopes the caller is missing when the failure is an authorization error.

  - `requestId` (string)
    Request correlation ID for support and log tracing.
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"