# Get Insights Warnings

Get the Insights warnings. The list of locations/accounts connected/unconnected, which need a user action to be able collecting insights for.

Endpoint: GET /dashboard/insights-data/warnings
Version: 20250708
Security: X-API-KEY, Authorization

## Query parameters:

  - `businessIds` (array)
    The ids of the businesses you want insights data warnings for

  - `locationIds` (array)
    The ids of the locations you want insights data warnings for

  - `textFilter` (string)
    Filter locations to get insights data warnings for by name, zip, street, city, label
    Example: "Berlin"

  - `type` (string)
    The directory you want insights warnings for

  - `max` (integer)
    Used for pagination. Maximum number of results per page

  - `offset` (integer)
    Offset used for pagination. Default: 0

## Response 200 fields (*/*):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `warnings` (array)
    (optional) Holds further warnings

  - `response` (object, required)
    UserMissingConnectionWarnings Model
    Example: {"connectedLocations":[{"type":"GOOGLE","count":100},{"type":"FACEBOOK","count":50}],"notConnectedLocations":[{"type":"GOOGLE","count":5},{"type":"FACEBOOK","count":10}],"warnings":{"missingConnection":{"locations":[{"id":1,"type":"FACEBOOK","name":"Example Location","city":"Sample City","country":"XX","addressLine1":"123 Sample Street"},{"id":2,"type":"GOOGLE","name":"Another Location","city":"Testville","country":"XX","addressLine1":"456 Test Road"}],"totalLocationsCount":10,"totalBusinessesCount":1},"missingPermission":{"accounts":[],"totalLocationsCount":0}},"totalItemsCount":160,"max":20,"offset":0}

  - `response.warnings` (object)
    A Map with keys as missingConnection and missingPermission. 
missingConnection is a Map with list of all connections missing connection. 
missingPermission is a Map with the list of accounts connected, but missing a required permission for insights.
    Example: {"missingConnection":{"locations":[{"id":1,"type":"FACEBOOK","name":"Example Location","city":"Sample City","country":"XX","addressLine1":"123 Sample Street"},{"id":2,"type":"GOOGLE","name":"Another Location","city":"Testville","country":"XX","addressLine1":"456 Test Road"}],"totalLocationsCount":10,"totalBusinessesCount":1},"missingPermission":{"accounts":[],"totalLocationsCount":0}}

  - `response.warnings.missingConnection` (object)
    Details about missing permissions

  - `response.warnings.missingConnection.totalLocationsCount` (integer)
    Total number of locations affected

  - `response.warnings.missingConnection.accounts` (array)
    List of affected accounts

  - `response.warnings.missingConnection.accounts.id` (integer)
    ID of the account
    Example: 123

  - `response.warnings.missingConnection.accounts.name` (string)
    Name of the account
    Example: "Sample Account"

  - `response.warnings.missingConnection.accounts.type` (string)
    Type of the directory
    Enum: "FOURSQUARE", "UBER", "GOOGLE", "WAZE", "GOOGLE_MAPS", "YELP", "YELP_API", "MEINESTADT", "YELLOW_MAP", "FOCUS", "LOKALEAUSKUNFT", "WEB_DE", "GMX", "ONE_AND_ONE", "FREIEAUSKUNFT", "POINTOO", "NOKIA_HERE", "FACEBOOK", "TOMTOM", "STADTBRANCHENBUCH", "CYLEX", "UNTERNEHMENSAUSKUNFT", "ACOMPIO", "BUSINESSBRANCHENBUCH", "YALWA", "THE_PHONEBOOK", "SCOOT", "CENTRAL_INDEX", "CITIPAGES", "ONE_NINE_TWO", "ONE_ONE_EIGHT", "THE_DAILY_RECORD", "THE_EVENING_STANDARD", "THE_SCOTSMAN", "LIVERPOOL_ECHO", "THE_SUN", "THE_INDEPENDENT", "TOUCH_LOCAL", "THE_MIRROR", "ANNUAIRE", "INFOBEL", "US_INFO_COM", "GARMIN", "FACTUAL", "BING", "WO_GIBTS_WAS", "KOOMIO", "ABCLOCAL", "YELLBO", "JELLOO", "GUIDELOCAL", "OEFFNUNGSZEITENBUCH", "APPLE_MAPS", "LOOCAL", "REGIONAL_DE", "WHERE_TO", "TUPALO", "GELBE_SEITEN", "DAS_OERTLICHE", "DIALO", "BUNDES_TELEFONBUCH", "BRANCHENBUCH_DEUTSCHLAND", "MARKTPLATZ_MITTELSTAND", "BUSQUEDA_LOCAL", "RICERCARE_IMPRESE", "PAGES24", "NAVMII", "AUDI", "BMW", "MERCEDES", "VW", "TOYOTA", "FORD", "FIAT", "GM", "ETRUSTED", "INSTAGRAM", "SHOPPING_TIME_NETWORK", "CITY_SQUARES", "SHOWMELOCAL", "LOCALSTACK", "CHAMBER_OF_COMMERCE", "JUDYS_BOOK", "BROWNBOOK", "MY_LOCAL_SERVICES", "YA_SABE", "UNIVISION", "AL_DIA_TX", "LA_VOZ_TX", "CHRON", "STATESMAN", "PALM_BEACH_POST", "MUNDO_HISPANICO", "EL_TIEMPO_LATINO", "LATINOS_US", "HOTFROG", "INFO_IS_INFO", "MANTA", "US_CITY", "GO_YELLOW", "N49", "PRATIQUE", "JUSTACOTE", "EZLOCAL", "ELOCAL", "TRUE_LOCAL", "START_LOCAL", "WOMO", "AUSSIE_WEB", "YELLOW_PAGES", "SUPER_PAGES", "WHITE_PAGES", "DEX_KNOWS", "KAUFDA_MANUAL", "I_GLOBAL", "BRANCHEN_INFO_MANUAL", "GUTE_BANKEN_MANUAL", "D_11880_COM_MANUAL", "BANKOEFFNUNGSZEITEN_DE_MANUAL", "BANK_OEFFNUNGSZEITEN_DE_MANUAL", "CYLEX_MANUAL", "FINDE_OFFEN_MANUAL", "MEIN_PROSPEKT_MANUAL", "DAS_SCHNELLE", "SENSIS_WHITE_PAGES", "SENSIS_TRUE_LOCAL", "SENSIS_YELLOW_PAGES", "FIND_OPEN", "WAND", "BELL_CA", "GO_LOCAL", "MEINUNGSMEISTER", "YANDEX", "YAHOO_MANUAL", "HOLIDAY_CHECK", "TRIP_ADVISOR", "BONIAL_FR", "ZIP_CH", "PAGES_JAUNES", "YELLOW_PAGES_SINGAPORE", "INFOGROUP", "WAZE_NEW", "UBER_NEW", "NEUSTAR", "TRUSTPILOT", "AUSKUNFT", "BAIDU", "NEXT_DOOR", "MICROSOFT_CORTANA", "GOOGLE_ASSISTANT", "CBANQUE", "ORANGE_118_712", "SIRI", "HUAWEI", "DOCTOR_COM", "CARE_DASH", "DENTAL_PLANS", "DOC_SPOT", "HEALTHGRADES", "SHARE_CARE", "VITALS", "WEB_MD", "WELLNESS", "ZOC_DOC", "ZWIVEL", "YP_COM_HEALTH", "BING_HEALTH", "NPPES", "RATE_MDS", "CITYSEARCH", "INSIDER_PAGES", "TWITTER", "ALEXA", "MAP_QUEST", "WEBSITE_WIDGETS", "ECO_MOVEMENT", "GOOGLE_EV", "APPLE_EV", "TESLA_EV", "EUROWAG_EV", "OPIS_EV", "TOMTOM_EV", "HERE_EV", "YELLOW_PAGES_CANADA", "BBB", "UBERALL_SOCIAL_ADS", "APPLE_APPS", "CONSUMER_AFFAIRS", "CREDIT_KARMA", "DELIVERY", "GLASSDOOR", "PLAY_GOOGLE", "GRUBHUB", "INDEED", "LENDING_TREE", "MENUISM", "OPEN_TABLE", "OPEN_TABLE_USA", "WALLET_HUB", "ZILLOW", "ZOMATO", "WHATS_APP", "FOUR_SCREEN", "AND_CHARGE", "LINKED_IN"

  - `response.warnings.missingConnection.accounts.totalLocationsCount` (integer)
    Total number of locations associated with this account
    Example: 42

  - `response.warnings.missingConnection.accounts.url` (string)
    URL for the account
    Example: "https://example.com"

  - `response.warnings.missingConnection.locations` (array)
    List of affected locations

  - `response.warnings.missingConnection.locations.id` (integer)
    ID of the entity
    Example: 123

  - `response.warnings.missingConnection.locations.name` (string)
    Name of the entity
    Example: "Sample Business"

  - `response.warnings.missingConnection.locations.addressLine1` (string)
    Street and number
    Example: "123 Main St"

  - `response.warnings.missingConnection.locations.city` (string)
    City name
    Example: "New York"

  - `response.warnings.missingConnection.locations.zip` (string)
    ZIP/Postal code
    Example: "10001"

  - `response.warnings.missingConnection.locations.country` (string)
    Country code
    Example: "US"

  - `response.warnings.missingConnection.locations.streetNo` (string)
    Street Number
    Example: "123"

  - `response.warnings.missingConnection.locations.street` (string)
    Street
    Example: "Main St"

  - `response.warnings.missingConnection.locations.businessId` (integer)
    Business ID
    Example: 456

  - `response.warnings.missingConnection.locations.connectSecret` (string)
    Connection secret for authentication

  - `response.warnings.missingConnection.locations.listingId` (integer)
    Listing ID
    Example: 789

  - `response.warnings.missingConnection.businesses` (array)
    List of affected businesses

  - `response.warnings.missingConnection.totalBusinessesCount` (integer)
    Total number of businesses affected

  - `response.warnings.missingPermission` (object)
    Details about missing permissions

  - `response.warnings.missingChatbotConnection` (object)
    Details about missing chatbot connections

  - `response.totalItemsCount` (integer)
    Used for pagination. Total number of results of the request
    Example: 160

  - `response.max` (integer)
    Used for pagination. Maximum number of results per page
    Example: 20

  - `response.offset` (integer)
    Offset used for pagination. Default: 0

  - `response.connectedLocations` (array)
    A Map with key as directory types and values the number of connected locations
    Example: [{"type":"GOOGLE","count":100},{"type":"FACEBOOK","count":50}]

  - `response.connectedLocations.type` (string)
    The directory type
    Enum: "FOURSQUARE", "UBER", "GOOGLE", "WAZE", "GOOGLE_MAPS", "YELP", "YELP_API", "MEINESTADT", "YELLOW_MAP", "FOCUS", "LOKALEAUSKUNFT", "WEB_DE", "GMX", "ONE_AND_ONE", "FREIEAUSKUNFT", "POINTOO", "NOKIA_HERE", "FACEBOOK", "TOMTOM", "STADTBRANCHENBUCH", "CYLEX", "UNTERNEHMENSAUSKUNFT", "ACOMPIO", "BUSINESSBRANCHENBUCH", "YALWA", "THE_PHONEBOOK", "SCOOT", "CENTRAL_INDEX", "CITIPAGES", "ONE_NINE_TWO", "ONE_ONE_EIGHT", "THE_DAILY_RECORD", "THE_EVENING_STANDARD", "THE_SCOTSMAN", "LIVERPOOL_ECHO", "THE_SUN", "THE_INDEPENDENT", "TOUCH_LOCAL", "THE_MIRROR", "ANNUAIRE", "INFOBEL", "US_INFO_COM", "GARMIN", "FACTUAL", "BING", "WO_GIBTS_WAS", "KOOMIO", "ABCLOCAL", "YELLBO", "JELLOO", "GUIDELOCAL", "OEFFNUNGSZEITENBUCH", "APPLE_MAPS", "LOOCAL", "REGIONAL_DE", "WHERE_TO", "TUPALO", "GELBE_SEITEN", "DAS_OERTLICHE", "DIALO", "BUNDES_TELEFONBUCH", "BRANCHENBUCH_DEUTSCHLAND", "MARKTPLATZ_MITTELSTAND", "BUSQUEDA_LOCAL", "RICERCARE_IMPRESE", "PAGES24", "NAVMII", "AUDI", "BMW", "MERCEDES", "VW", "TOYOTA", "FORD", "FIAT", "GM", "ETRUSTED", "INSTAGRAM", "SHOPPING_TIME_NETWORK", "CITY_SQUARES", "SHOWMELOCAL", "LOCALSTACK", "CHAMBER_OF_COMMERCE", "JUDYS_BOOK", "BROWNBOOK", "MY_LOCAL_SERVICES", "YA_SABE", "UNIVISION", "AL_DIA_TX", "LA_VOZ_TX", "CHRON", "STATESMAN", "PALM_BEACH_POST", "MUNDO_HISPANICO", "EL_TIEMPO_LATINO", "LATINOS_US", "HOTFROG", "INFO_IS_INFO", "MANTA", "US_CITY", "GO_YELLOW", "N49", "PRATIQUE", "JUSTACOTE", "EZLOCAL", "ELOCAL", "TRUE_LOCAL", "START_LOCAL", "WOMO", "AUSSIE_WEB", "YELLOW_PAGES", "SUPER_PAGES", "WHITE_PAGES", "DEX_KNOWS", "KAUFDA_MANUAL", "I_GLOBAL", "BRANCHEN_INFO_MANUAL", "GUTE_BANKEN_MANUAL", "D_11880_COM_MANUAL", "BANKOEFFNUNGSZEITEN_DE_MANUAL", "BANK_OEFFNUNGSZEITEN_DE_MANUAL", "CYLEX_MANUAL", "FINDE_OFFEN_MANUAL", "MEIN_PROSPEKT_MANUAL", "DAS_SCHNELLE", "SENSIS_WHITE_PAGES", "SENSIS_TRUE_LOCAL", "SENSIS_YELLOW_PAGES", "FIND_OPEN", "WAND", "BELL_CA", "GO_LOCAL", "MEINUNGSMEISTER", "YANDEX", "YAHOO_MANUAL", "HOLIDAY_CHECK", "TRIP_ADVISOR", "BONIAL_FR", "ZIP_CH", "PAGES_JAUNES", "YELLOW_PAGES_SINGAPORE", "INFOGROUP", "WAZE_NEW", "UBER_NEW", "NEUSTAR", "TRUSTPILOT", "AUSKUNFT", "BAIDU", "NEXT_DOOR", "MICROSOFT_CORTANA", "GOOGLE_ASSISTANT", "CBANQUE", "ORANGE_118_712", "SIRI", "HUAWEI", "DOCTOR_COM", "CARE_DASH", "DENTAL_PLANS", "DOC_SPOT", "HEALTHGRADES", "SHARE_CARE", "VITALS", "WEB_MD", "WELLNESS", "ZOC_DOC", "ZWIVEL", "YP_COM_HEALTH", "BING_HEALTH", "NPPES", "RATE_MDS", "CITYSEARCH", "INSIDER_PAGES", "TWITTER", "ALEXA", "MAP_QUEST", "WEBSITE_WIDGETS", "ECO_MOVEMENT", "GOOGLE_EV", "APPLE_EV", "TESLA_EV", "EUROWAG_EV", "OPIS_EV", "TOMTOM_EV", "HERE_EV", "YELLOW_PAGES_CANADA", "BBB", "UBERALL_SOCIAL_ADS", "APPLE_APPS", "CONSUMER_AFFAIRS", "CREDIT_KARMA", "DELIVERY", "GLASSDOOR", "PLAY_GOOGLE", "GRUBHUB", "INDEED", "LENDING_TREE", "MENUISM", "OPEN_TABLE", "OPEN_TABLE_USA", "WALLET_HUB", "ZILLOW", "ZOMATO", "WHATS_APP", "FOUR_SCREEN", "AND_CHARGE", "LINKED_IN"

  - `response.connectedLocations.count` (integer)
    The number of accounts

  - `response.notConnectedLocations` (array)
    A Map with key as directory types and values the number of not connected locations
    Example: [{"type":"GOOGLE","count":5},{"type":"FACEBOOK","count":10}]

## Response 400 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 401 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 403 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 404 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "QUOTA_LIMIT_EXCEED", "NOT_AUTHORIZED", "FORBIDDEN", "BAD_ACCESS_TOKEN", "BAD_PRIVATE_KEY", "BAD_PUBLIC_KEY", "MISSING_PARAMETER", "INVALID_PARAMETER", "WRONG_PARAMETER_TYPE", "CONFLICT", "RESOURCE_LOCKED", "SERVER_ERROR", "ERROR", "NOT_FOUND", "BAD_REQUEST", "USER_ERROR", "PARTIAL_ERROR"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response