# Get Next Best Actions

Get the Next Best Actions recommended to the current user

Endpoint: GET /dashboard/next-best-actions/{id}
Version: 20250708
Security: X-API-KEY, Authorization

## Path parameters:

  - `id` (string, required)
    The uberall unique id for the location

## 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)
    LocationTask Model

  - `response.type` (string)
    The type of the task. The value could be on of [LISTING_FACEBOOK_CONNECTION_MISSING, LISTING_GOOGLE_CONNECTION_MISSING, LISTING_GOOGLE_VERIFICATION_MISSING, LISTING_GOOGLE_PIN_MISSING, LISTING_FIELDS_MISSING, DATAPOINT_UNREPLIED_RECENT, DATAPOINT_UNREAD, DATAPOINT_UNREPLIED_OLD, LOCATION_PROPERTIES_MISSING, LOCATION_ADD_PHOTOS, LOCATION_SOCIAL_POST_MISSING, LOCATION_RICH_DATA_MISSING, LOCATION_ADD_NEW_PHOTOS]
    Enum: "LOCATION_START_FIRST_SYNC", "LOCATION_START_NEW_SYNC", "LISTING_FACEBOOK_CONNECTION_MISSING", "LISTING_GOOGLE_CONNECTION_MISSING", "LISTING_GOOGLE_VERIFICATION_MISSING", "LISTING_GOOGLE_PIN_MISSING", "LISTING_FIELDS_MISSING", "DATAPOINT_UNREPLIED_RECENT", "DATAPOINT_UNREAD", "DATAPOINT_UNREPLIED_OLD", "LOCATION_SUGGESTIONS_PROPERTIES", "LOCATION_PROPERTIES_MISSING", "LOCATION_SOCIAL_POST_MISSING", "LOCATION_RICH_DATA_MISSING", "LOCATION_ADD_NEW_PHOTOS"

  - `response.properties` (object)
    A Map with info related to the specific task

  - `response.properties.listing` (object)
    Listing details containing directory information and connection status

  - `response.properties.missingField` (string)
    Missing field identifier (e.g., OPENING_HOURS, DESCRIPTION, PHONE)
    Example: "OPENING_HOURS"

  - `response.properties.lastPhotoUploadedAt` (string)
    Timestamp when the last photo was uploaded to the location

  - `response.properties.fields` (array)
    List of suggested field changes from user suggestions
    Enum: "NAME", "NAME_DESCRIPTOR", "STREET_NO", "STREET", "STREET_TYPE", "ADDRESS_EXTRA", "PROVINCE", "ZIP", "CITY", "COUNTRY", "LATITUDE", "LONGITUDE", "ADDRESS_DISPLAY", "SERVICE_AREAS", "CATEGORIES", "OPENING_DATE", "PHONE", "CELLPHONE", "FAX", "WEBSITE", "WEBSITE_EXTRA", "EMAIL", "OPENINGHOURS", "OPENINGHOURS_NOTES", "SPECIAL_OPENINGHOURS", "MORE_HOURS", "KEYWORDS", "DESCRIPTION_SHORT", "DESCRIPTION_LONG", "IMPRINT", "LEGAL_IDENT", "TAX_NUMBER", "ATTRIBUTION", "IS_PUBLISHED", "SOCIAL_PROFILES", "ATTRIBUTES", "PAYMENT_OPTIONS", "BRANDS", "LANGUAGES", "SERVICES", "CONTENT_LISTS", "PHOTOS", "VIDEOS", "SOCIAL_POST", "DOCTOR_CATEGORIES", "NPI", "EV_DATA", "TRANSACTION_LINKS", "SUBLOCALITY", "CUSTOM_FIELDS"

  - `response.properties.locationId` (integer)
    Location ID related to this task
    Example: 123

  - `response.properties.count` (integer)
    Count of items (e.g., unread datapoints, unreplied reviews)
    Example: 10

  - `response.properties.queryString` (string)
    Query string for filtering content
    Example: "timeSpan=LAST_30_DAYS&dataPointTypes=review&status=unresolved"

  - `response.priority` (integer)
    The priority of the task to be performed on the location. The value is from 1 to 90 and depends on the Task's type

  - `response.locationId` (integer)
    The location id which the next best action refers to

## 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