API Reference
/
Locations Data
/
Create a Location

Uberall API (20250204)

Enhance your application with Uberall's comprehensive API documentation

Download OpenAPI description
swagger.json
swagger.yaml
Overview
URL

https://uberall.com

Support

api@uberall.com

License

Licensed under Uberall

Languages
Servers
Mock server

https://docs.uberall.com/_mock/apis/swagger/

https://uberall.com/api/

Users

Set up - Users

Operations

Business Connections

Set up - Business Connections

Operations

Businesses

Set up - Businesses

Operations

Configuration

Set up - Configuration

Operations

Sales Partners

Set up - Tenancy - Sales Partners

Operations

Monitoring

Set up - API Status

Operations

Product Plans

Set up - Tenancy - Product Plans

Operations

Webhooks

Set up - Tenancy - Sales Partners - Webhooks

Operations

Auto Response

Products - Auto Response

Operations

Brand Data Points

Products - Brand Data Points

Operations

Dashboard

Products - Analytics - Dashboard

Operations

Dashboard Exports

Products - Analytics - Dashboard Exports

Operations

Data Points

Products - Data Points

Operations

Data Point Filters

Products - Data Points - Data Point Filters

Operations

Templates

Products - Response Library - Templates

Operations

Social Posting

Products - Social Posting

Operations

Social Posting Templates

Products - Social Posting - Social Posting Templates

Operations

Digital Asset Management

Products - Digital Asset Management

Operations

Status Check

Products - Status Check

Operations

Store Finder

Products - Store Finder

Operations

Batch Operation

Locations Hub - Locations - Batch Operations (excel)

Operations

Categories

Locations Hub - Categories

Operations

Collection Management

Locations Hub - Collections - Collection Management

Operations

Content List

Locations Hub - Collections - Content List

Operations

Locations Data

Locations Hub - Locations Data

Operations

Get Several Locations

Request

Get locations managed by the current API user. Some fields are omitted (such as paymentOptions and services). For a full list use the GET/api/locations/$id endpoint.

Query
businessIdArray of integers(int64)

Only return locations in the business identified by businessId. Allowed multiple businessIds

Example: businessId=/api/locations?businessId=123&businessId=456
businessIdsArray of integers(int64)

Returns all locations associated with multiple business ids

citiesArray of strings

Get locations in the requested cities

classificationstring

Possible values: REQUIRED, BASIC, ADVANCED, BONUS and COMPLETE

countriesArray of strings

Get locations in the requested country

endDateMaxstring(date-time)

Only locations with an endDate less than or equal to endDateMax will be returned

Example: endDateMax=2020-02-05T12:18:12.000+01:00
endDateMinstring(date-time)

Only locations with an endDate greater than or equal to endDateMin will be returned.

Example: endDateMin=2018-02-05T12:18:12.000+01:00
excludedLocationIdsArray of integers(int64)

List of locationIds that should be excluded from the result

Example: excludedLocationIds=excludedLocationIds=20&excludedLocationIds=21 for multiple locations
facebookStatusstring

Possible values: CONNECTED, NOT_CONNECTED

fieldMaskArray of strings

Possible fieldMask options ( 'id', 'name', 'identifier', 'street', 'streetNo', 'streetAndNumber', 'addressExtra', 'zip', 'city', 'country', 'dateCreated', 'endDate', 'province', 'lat', 'lng', 'addressDisplay', 'phone', 'fax', 'timeZone', 'cellphone', 'website', 'email', 'legalIdent', 'taxNumber', 'descriptionShort', 'descriptionLong', 'imprint', 'openingHoursNotes', 'status', 'photos', 'attributes', 'firstSyncStarted', 'lastUpdated', 'lastSyncStarted', 'autoSync', 'locationSyncable', 'businessId', 'businessName', 'productPlanName', 'googleInsights', 'labels', 'customFields', 'features', 'groups', 'openingHours', 'specialOpeningHours', 'nameDescriptor', 'actionsRequired', 'profileCompleteness', 'suggestionsForFieldsAvailable', 'listingsInSync', 'activeListingsCount', 'dataPoints', 'averageRating', 'directoriesMissingConnect' )

Example: fieldMask=fieldMask=city&fieldMask=zip
googleDirectoryStatusstring

Possible values: VERIFIED (the Google listing is verified and fully managed by us), UNVERIFIED (the Google listing is not verified), DISABLED (the Google listing is disabled), SUSPENDED (the Google listing is suspended), DUPLICATE (the Google listing is a duplicate), PENDING_VERIFICATION (a verification pin has been requested for the Google listing), NEEDS_REVERIFICATION (the verification process for the Google listing needs to be reverified), PENDING_REVIEW (there is no Google account connected for the listing)

googleStatusstring

Possible values: VERIFIED (the Google listing is verified and fully managed by us), VERIFICATION_STARTED (a verification pin has been requested for the Google listing), VERIFICATION_NOT_STARTED (the verification process has not been start for the Google listing), NOT_CONNECTED (there is no Google account connected for the listing), VERIFIED_BY_THIRD_PARTY (there is a verified listing on Google but we do not manage it)

groupIdsArray of integers(int64)

The groupId to which the location belongs

groupsArray of strings

The name of the group to which the location belongs

identifierstring

Only return one location (per business) based on your internal identification system

labelsArray of strings

Only return locations that contain at least one of the given labels

locationIdsArray of integers(int64)

Only return locations identified by ids listed in locationIds

Example: locationIds=?locationIds=20&locationIds=22 for multiple locations
maxinteger(int64)

Used for pagination. Maximum number of results per page. Default: 50 (Without a defined FieldMask the maximum number of results is 50.)

missingDirectoryFieldArray of strings

Only return locations that have no value for the given field

needsReviewboolean

If set to true, only return locations with faulty data in need of review. Default: false.

offsetinteger(int64)

Offset used for pagination. Default: 0

orderstring

use asc for ascending sort or desc for descending sort

postcodesArray of strings

Get locations in the requested post / zip codes

provincesArray of strings

Get locations in the requested province / state

querystring

Filter by name, zip, street, city, label

Example: query=Berlin
queryFieldsArray of strings

The fields that will be searched to contain the value provided in the 'query' query parameter.

selectAllboolean

Setting selectAll to true allows finding ALL locations for any given businessId, locationIds and labels. In other words these fields are OR joined.

sortstring

The location property to sort by (ascending unless order is specified). One of name, street, streetNo, zip, city, phone, cellphone, fax, website, email, lastSyncStarted, country

statusArray of strings

Filter by locations status. One of ACTIVE, INACTIVE, CANCELLED

syncNeededboolean

If set to true, filter locations that have been updated but did not start a sync yet

syncStartedboolean

If set to true, filter locations that started a sync. If set to false, filter locations that never synced

temporarilyClosedboolean

Filter for locations that are currently set to temporarily closed (True) or are not temporarily closed (False)

curl -i -X GET \
  'https://docs.uberall.com/_mock/apis/swagger/locations?businessId=%2Fapi%2Flocations%3FbusinessId%3D123%26businessId%3D456&businessIds=0&cities=string&classification=string&countries=string&endDateMax=2020-02-05T12%3A18%3A12.000%2B01%3A00&endDateMin=2018-02-05T12%3A18%3A12.000%2B01%3A00&excludedLocationIds=excludedLocationIds%3D20%26excludedLocationIds%3D21%20for%20multiple%20locations&facebookStatus=string&fieldMask=fieldMask%3Dcity%26fieldMask%3Dzip&googleDirectoryStatus=string&googleStatus=string&groupIds=0&groups=string&identifier=string&labels=string&locationIds=%3FlocationIds%3D20%26locationIds%3D22%20for%20multiple%20locations&max=0&missingDirectoryField=string&needsReview=true&offset=0&order=string&postcodes=string&provinces=string&query=Berlin&queryFields=string&selectAll=true&sort=string&status=string&syncNeeded=true&syncStarted=true&temporarilyClosed=true' \
  -H 'accessToken: YOUR_API_KEY_HERE'

Responses

Locations successfully retrieved

Bodyapplication/json
statusstringrequired
Enum"SUCCESS""QUOTA_LIMIT_EXCEED""NOT_AUTHORIZED""FORBIDDEN""BAD_ACCESS_TOKEN""BAD_PRIVATE_KEY""BAD_PUBLIC_KEY""MISSING_PARAMETER""INVALID_PARAMETER""WRONG_PARAMETER_TYPE"
messagestring

(optional) Holds further information about the response

warningsArray of strings

(optional) Holds further warnings

responseobjectrequired

The actual response object of the response

response.​offsetinteger(int32)

Offset for pagination

Example: 0
response.​maxinteger(int32)

Maximum number of results per page

Example: 10
response.​countinteger(int32)

Total count of results

Example: 100
response.​locationsArray of objects(LocationSearchResult)
Response
application/json
{
  "status": "SUCCESS",
  "message": "string",
  "warnings": [
    "string"
  ],
  "response": {
    "offset": 0,
    "max": 10,
    "count": 100,
    "locations": [ … ]
  }
}

Create a Location

Request

Create a location and add it to an existing business

Bodyapplication/jsonrequired

Location object

idinteger(int64)

Output only. The uberall unique id for the location

listingsArray of objects(Listing)unique

Output only. List of this location's online listings together with their sync status

openingHoursArray of objects(OpeningHours)unique

The location's opening hours: e.g.

[ { 
    "dayOfWeek": 1,
    "closed": false,
    "from1": "08:00",
    "to1": "11:00"
  }, 
  {
    "dayOfWeek": 2,
    "closed": false,
    "from1": "08:00",
    "to1": "11:00",
    "from2": "13:00",
    "to2": "21:00"
  },
  {
    "dayOfWeek": 3,
    "closed": true
  }
]

Please note that having more than 2 time periods for each day is not possible.

Example: [{"dayOfWeek":1,"closed":false,"from1":"08:00","to1":"11:00"},{"dayOfWeek":2,"closed":false,"from1":"08:00","to1":"11:00","from2":"13:00","to2":"21:00"},{"dayOfWeek":3,"closed":true}]
specialOpeningHoursArray of objects(SpecialOpeningHours)unique

The location's special opening hours: e.g.

[ {
"date": "2017-06-29",
"closed": true
},
{
"date": "2017-06-30",
"from1": "11:00",
"to1": "14:00",
"from2": 16:00",
"to2": "20:00"
}
]

Please note that having more than 2 time periods for each day is not possible.

Example: [{"date":"2017-06-29","closed":true},{"date":"2017-06-30","from1":"11:00","to1":"14:00","from2":"16:00","to2":"20:00"}]
namestringrequired

The location's name

streetstringrequired

The location's street address

streetNostring

The location's street number

streetTypestring

Required for Spain. One of ALAMEDA, AVENIDA, CALLE, CAMINO, CARRER, CARRETERA, GLORIETA, KALEA, PASAJE, PASEO, PLACA, PLAZA, RAMBLA, RONDA, RUA, SECTOR, TRAVESERA, TRAVESIA, URBANIZACION

Enum"ALAMEDA""AVENIDA""CALLE""CAMINO""CARRER""CARRETERA""GLORIETA""KALEA""PASAJE""PASEO"
addressExtrastring

An address extra: e.g. building, floor...

Example: "building, floor, ..."
zipstring

Zip code, optional only for some countries.

citystringrequired

City

provincestring

Province. Only send when not blank

countrystringrequired

Country of the location

Enum"AF""AX""AL""DZ""AS""AD""AO""AI""AQ""AG"
latnumber(double)

The latitude coordinate of the location

lngnumber(double)

The longitude coordinate of the location

addressDisplayboolean

Indicates if the address should be displayed or hidden

phonestring

The location's contact phone number, a valid phone number has to be provided.

faxstring

The location fax number

cellphonestring

A contact mobile phone number

websitestring

A valid url for the location's website (use UTMs to add tracking)

emailstring

A contact email for the location

legalIdentstring

A legal identifier of the location. SIRET number in France

taxNumberstring

The tax number of the location. CIF/NIF in Spain

emailVerificationstring

The locations verification status

Enum"UNVERIFIED""VERIFIED"
descriptionShortstring

A short description - up to 200 characters, all characters must match this regexp: 

[0-9\p'{'L'}'()[] ?:;/!\,.-%\&=\r\n\t_*§²`´·"'+¡¿@°€£$]

descriptionLongstring

A long description - up to 1000 characters, all characters must match this regexp: 

[0-9\p'{'L'}'()[] ?:;/!\,.-%\&=\r\n\t_*§²³`´·"'+¡¿@°€^£$]

imprintstring

The imprint of the location

openingHoursNotesstring

Additional info about opening hours: e.g. 'We never open on bank holidays' - max. 255 characters, all characters must match this regexp: 

[0-9\p'{'L'}'()[] ?:;/!\,.-%\&\r\n\t_*§²`´·"'+¡¿@]

Example: "We never open on bank holidays"
keywordsArray of strings

Keywords describing the location's activity

labelsArray of objects(Label)unique

Labels grouping similar locations

Example: "['Campaign2018', 'EastCoast']"
brandsArray of strings

The brands offered by the location to its customers

paymentOptionsArray of stringsunique

The payment options accepted at the location (eg. cash, bank transfer, ...)

Example: ["cash","credit card","invoice"]
languagesArray of stringsunique

The language(s) in which customers can interact with the location's staff

categoriesArray of objects(Category)

Required to start location sync - A list of category IDs describing the location

statusstring

The status of the location. One of:

  • ACTIVE - will be synced and renewed
  • INACTIVE - will not be synced anymore, claims of listings will be released where possible
  • CANCELLED - will be synced, will not be renewed. Once endDate is reached, location will switch to INACTIVE
  • CLOSED - location has shut down, we'll mark listings as permanently closed or remove listings from the internet where permanently closed status is not supported
Enum"CREATED""ACTIVE""INACTIVE""CANCELLED""DELETED""CLOSED"
lastSyncStartedstring(date-time)

Output only. Date of the last sync for the location

identifierstring

The location identifier based on your internal identification system

photosArray of objects(LocationPhoto)

The location's photos

dateCreatedstring(date-time)

Output only. The date and time the location was created in our database

lastUpdatedstring(date-time)

Output only. Date of the last changes made to the location. Includes updates by users, API, location cleansing, and duplicate checks

autoSyncboolean

When autosync is set to true, information changed for the location in Uberall will automatically be syncronized to all connected listings without the need to explicitly start a sync again after it's been started once.

openingDatestring(date)

The date the location will first open. Must be formatted YYYY-MM-DD

serviceAreasArray of objects(ServiceArea)

Service areas available on the location.

callTrackingNumbersArray of objects(CallTrackingNumber)unique

Add call tracking numbers for distribution to Google, Facebook, and Bing. The call tracking numbers must be different from the location's primary phone number

utmsArray of objects(UTM)unique

UTM parameter to be appended to the location's website. Codes can be sent to Google, Facebook, and Bing.

transactionLinksArray of objects(LocationTransactionLink)unique

Links that appear on some directories for specific types of customer actions, such as food ordering, appointment setting, and booking reservations. Only available for specific business categories.

temporarilyClosedobject

Location Temporarily Closed

featuresArray of stringsunique

Output only. List of features available to the location

Items Enum"NEW_PHOTO_TYPES""ADS""ADS_READ""ADS_WRITE""ADVANCED_ANALYTICS""ADVANCED_ANALYTICS_2_0""AI_KNOWLEDGEBASE""AI_LOCALISATION""AI_LOCATION_INFORMATION""AI_SUGGESTED_REPLIES"
nameDescriptorstring

An addition to the location's name which gives specific info about the location's address (e.g. Mall level 2 OR Inside Departures). Sent only to FACEBOOK

evDataobject

EV Data

doctorComDataobject

Description of the provider

socialPostIdinteger(int64)
customFieldsArray of objects(CustomFieldsDetails)

A Map for identifying the value input for a specific custom field name on the location. Custom fields are created at the business level.


  "customFields": [
    '{'
      "name": "foo",
      "value": "bar"
    '}',
    '{'
      "name": "baz",
      "value": "qux"
    '}'
  ]
servicesArray of objects(ServiceItem)

Services offered at the location. Do not use if Content Collections is enabled. Instead use the Service Item and Collection endpoints

timeZonestring

The location's timezone

videosArray of objects(Video)

The location's videos

visibilityIndexinteger(int32)

Output only. The location's latest visibility index

activeDirectoriesCountinteger(int32)

Output only. Number of active directories

activeListingsCountinteger(int32)

Output only. Number of active listings

attributesArray of objects(AttributeWrapper)

Google attributes

businessIdinteger(int32)

ID of the business this location is linked to. Mandatory when creating a location. Sending a different ID than the current businessId when updating will lead to changing the business. This is only possible in case all connected accounts (Facebook, Google, …) are compatible.

Example: 1234
cleansingCommentstring

Cleansing comment by user, set only when cleansingStatus is INVALID_DATA. Possible Values (ADDRESS_DETAILS_VERIFIED, NAME_ADDRESS_DETAILS_UPDATED, NON_CLOSURE_CONFIRMATION,)

Enum"ADDRESS_DETAILS_VERIFIED""NAME_ADDRESS_DETAILS_UPDATED""NON_CLOSURE_CONFIRMATION"
cleansingInvalidDataReasonstring

Output only. Invalid Cleansing Reason (eg. INCOMPLETE_ADDRESS,ADDRESS_ IS_PO_BOX,ADDRESS_ DOES_NOT_EXIST, LOCATION_IS_CLOSED, INFORMATION_IS_WRONG, LOCATION_IS_MOVED, NON_LATIN_CHARACTERS_ADDRESS, OTHER). Guide on how to fix invalid data issues - http://ubr.al/fix_invalid_data

cleansingStatusstring

Output only. Current cleansing status for the location. Possible values: NOT_CLEANSED, PENDING, CLEANSED, INVALID_DATA

Enum"NOT_CLEANSED""PENDING""CLEANSED""INVALID_DATA"
contentListsArray of integers(int32)

The content list IDs (EVENTS, PRODUCTS, MENU, PEOPLE) describing the location

dataPointsinteger(int32)

Output only. Number of dataPoints (reviews, photos) left by users at this location

listingsBeingUpdatedinteger(int32)

Output only. Number of listings still being updated

listingsInSyncinteger(int32)

Output only. The number of listings in sync

mainPhotoobject

Location Photo

missingMandatoryFieldsArray of stringsunique

Output only. Compile all the fields that are currently missing but mandatory for some directories. They have to be set in the Location object, so that the Listing can be created / updated on the respective platform. List of Strings, e.g. [NAME, ZIP, PHONE]

Items Enum"NAME""NAME_DESCRIPTOR""STREET_NO""STREET""STREET_TYPE""ADDRESS_EXTRA""PROVINCE""ZIP""CITY""COUNTRY"
moreHoursArray of objects(MoreHoursResponse)unique

The location's additional service hours, such as delivery, pickup, happy hours etc. Submitted to Google. e.g.

[{
    "type": "ONLINE_SERVICE_HOURS",
    "hours": [{
        "dayOfWeek": 1,
        "from1": "09:00",
        "to1": "18:00"
    }, {
        "dayOfWeek": 2,
        "from1": "09:00",
        "to1": "13:00"
    }]
}, {
    "type": "ACCESS",
    "hours": [{
        "dayOfWeek": 1,
        "from1": "06:00",
        "to1": "20:00"
    }]
}]
profileCompletenessinteger(int32)

Output only. Number representing completeness of location data, up to 100

publishedListingsCountinteger(int32)

Output only. Number of published listings

socialProfilesArray of objects(SocialProfile)unique

The profiles of the location on social and professional networks (FACEBOOK, FOURSQUARE, INSTAGRAM, LINKEDIN, PINTEREST, TWITTER, VIMEO, XING, YOUTUBE)

curl -i -X POST \
  https://docs.uberall.com/_mock/apis/swagger/locations \
  -H 'Content-Type: application/json' \
  -H 'accessToken: YOUR_API_KEY_HERE' \
  -d '{
    "id": 0,
    "listings": [
      {
        "id": 0,
        "type": "FOURSQUARE",
        "syncStatus": "IN_SYNC",
        "claimStatus": "CLAIMABLE",
        "listingId": "string",
        "listingUrl": "string",
        "data": {},
        "lastChecked": "2019-08-24T14:15:22Z",
        "lastSuccessfulUpdate": "2019-08-24T14:15:22Z",
        "accountInfo": {},
        "connectSecret": "string",
        "connectStatus": "CONNECTED",
        "mandatoryFields": [
          "NAME"
        ],
        "status": "ACTIVE",
        "typeName": "string"
      }
    ],
    "openingHours": [
      {
        "dayOfWeek": 1,
        "closed": false,
        "from1": "08:00",
        "to1": "11:00"
      },
      {
        "dayOfWeek": 2,
        "closed": false,
        "from1": "08:00",
        "to1": "11:00",
        "from2": "13:00",
        "to2": "21:00"
      },
      {
        "dayOfWeek": 3,
        "closed": true
      }
    ],
    "specialOpeningHours": [
      {
        "date": "2017-06-29",
        "closed": true
      },
      {
        "date": "2017-06-30",
        "from1": "11:00",
        "to1": "14:00",
        "from2": "16:00",
        "to2": "20:00"
      }
    ],
    "name": "string",
    "street": "string",
    "streetNo": "string",
    "streetType": "ALAMEDA",
    "addressExtra": "building, floor, ...",
    "zip": "string",
    "city": "string",
    "province": "string",
    "country": "AF",
    "lat": 0.1,
    "lng": 0.1,
    "addressDisplay": true,
    "phone": "string",
    "fax": "string",
    "cellphone": "string",
    "website": "string",
    "email": "string",
    "legalIdent": "string",
    "taxNumber": "string",
    "emailVerification": "UNVERIFIED",
    "descriptionShort": "string",
    "descriptionLong": "string",
    "imprint": "string",
    "openingHoursNotes": "We never open on bank holidays",
    "keywords": [
      "string"
    ],
    "labels": "['\''Campaign2018'\'', '\''EastCoast'\'']",
    "brands": [
      "string"
    ],
    "paymentOptions": [
      "cash",
      "credit card",
      "invoice"
    ],
    "languages": [
      "string"
    ],
    "categories": [
      {
        "id": 0,
        "name": "string",
        "parent": {},
        "selectable": true
      }
    ],
    "status": "CREATED",
    "lastSyncStarted": "2019-08-24T14:15:22Z",
    "identifier": "string",
    "photos": [
      {
        "description": "string",
        "sourceUrl": "string",
        "identifier": "string",
        "cropOffsetX": 0,
        "cropOffsetY": 0,
        "cropWidth": 0,
        "cropHeight": 0,
        "type": "MAIN",
        "order": 0,
        "dateCreated": "2019-08-24T14:15:22Z",
        "lastUpdated": "2019-08-24T14:15:22Z",
        "url": "string"
      }
    ],
    "dateCreated": "2019-08-24T14:15:22Z",
    "lastUpdated": "2019-08-24T14:15:22Z",
    "autoSync": true,
    "openingDate": "2019-08-24",
    "serviceAreas": [
      {
        "name": "Berlin, Deutschland",
        "placeId": "ChIJAVkDPzdOqEcRcDteW0YgIQQ"
      }
    ],
    "callTrackingNumbers": [
      {
        "number": "string",
        "type": "FOURSQUARE"
      }
    ],
    "utms": [
      {
        "parameters": "string",
        "type": "FOURSQUARE"
      }
    ],
    "transactionLinks": [
      {
        "url": "string",
        "isPreferred": true,
        "type": "APPOINTMENT"
      }
    ],
    "temporarilyClosed": {
      "temporarilyClosed": true,
      "reopenDate": "string"
    },
    "features": [
      "NEW_PHOTO_TYPES"
    ],
    "nameDescriptor": "string",
    "evData": {
      "type": "ON_STREET",
      "owner": "string",
      "operator": "string",
      "subOperator": "string",
      "timezone": "string",
      "isChargingClosed": true,
      "updateTime": "2019-08-24T14:15:22Z",
      "supplyEquipments": [
        {
          "uid": "string",
          "evseId": "string",
          "physicalReference": "string",
          "updateTime": "2019-08-24T14:15:22Z",
          "connectors": [
            {
              "identifier": "string",
              "standard": "CHADEMO",
              "format": "CABLE",
              "powerType": "AC_1_PHASE",
              "voltage": 0,
              "amperage": 0,
              "updateTime": "2019-08-24T14:15:22Z"
            }
          ],
          "parkingRestrictions": [
            "CUSTOMERS"
          ]
        }
      ]
    },
    "doctorComData": {
      "npi": "string",
      "hospitals": [
        {
          "hospitalName": "string",
          "hospitalCity": "string",
          "hospitalState": "string"
        }
      ],
      "educations": [
        {
          "educationName": "string",
          "educationType": "string",
          "startedYear": 0,
          "graduationYear": 0
        }
      ],
      "insurances": [
        {
          "companyName": "string",
          "insurancePlan": "string"
        }
      ],
      "credentials": "string",
      "university": "string",
      "hospitalAffiliations": "string",
      "insurancesAccepted": "string",
      "isProvider": true,
      "practiceName": "string",
      "providerTitle": "string",
      "providerFirstname": "string",
      "providerMiddlename": "string",
      "providerSurname": "string",
      "doctorCategories": [
        0
      ]
    },
    "socialPostId": 0,
    "customFields": [
      {
        "name": "foo",
        "value": "bar"
      }
    ],
    "services": [
      {
        "title": "string",
        "description": "string",
        "identifier": "string",
        "listName": "string",
        "price": 0,
        "currency": {},
        "category": 0,
        "country": "string",
        "googleService": "string"
      }
    ],
    "timeZone": "string",
    "videos": [
      {
        "id": 0,
        "url": "string",
        "description": "string",
        "type": "YOUTUBE"
      }
    ],
    "visibilityIndex": 0,
    "activeDirectoriesCount": 0,
    "activeListingsCount": 0,
    "attributes": [
      {
        "externalId": "string",
        "value": "string",
        "displayName": "string",
        "groupDisplayName": "string",
        "valueMetadata": [
          {
            "value": "string",
            "displayName": "string"
          }
        ],
        "valueType": "BOOL, URL, ENUM, REPEATED_ENUM"
      }
    ],
    "businessId": 1234,
    "cleansingComment": "ADDRESS_DETAILS_VERIFIED",
    "cleansingInvalidDataReason": "string",
    "cleansingStatus": "NOT_CLEANSED",
    "contentLists": [
      0
    ],
    "dataPoints": 0,
    "listingsBeingUpdated": 0,
    "listingsInSync": 0,
    "mainPhoto": {
      "description": "string",
      "sourceUrl": "string",
      "identifier": "string",
      "cropOffsetX": 0,
      "cropOffsetY": 0,
      "cropWidth": 0,
      "cropHeight": 0,
      "type": "MAIN",
      "order": 0,
      "dateCreated": "2019-08-24T14:15:22Z",
      "lastUpdated": "2019-08-24T14:15:22Z",
      "url": "string"
    },
    "missingMandatoryFields": [
      "NAME"
    ],
    "moreHours": [
      {
        "type": {
          "id": 0
        },
        "hours": [
          {
            "dayOfWeek": 1,
            "from": "08:00",
            "to": "18:00"
          }
        ]
      }
    ],
    "profileCompleteness": 0,
    "publishedListingsCount": 0,
    "socialProfiles": [
      {
        "url": "string",
        "type": "FACEBOOK"
      }
    ]
  }'

Responses

Location successfully created

Bodyapplication/json
statusstringrequired
Enum"SUCCESS""QUOTA_LIMIT_EXCEED""NOT_AUTHORIZED""FORBIDDEN""BAD_ACCESS_TOKEN""BAD_PRIVATE_KEY""BAD_PUBLIC_KEY""MISSING_PARAMETER""INVALID_PARAMETER""WRONG_PARAMETER_TYPE"
messagestring

(optional) Holds further information about the response

warningsArray of strings

(optional) Holds further warnings

responseobjectrequired

The actual response object of the response

response.​locationobject

Location

Response
application/json
{
  "status": "SUCCESS",
  "message": "string",
  "warnings": [
    "string"
  ],
  "response": {
    "location": { … }
  }
}

Delete Several Locations

Request

Delete several locations identified by their uberall unique ids. Locations can be deleted only if they are inactivated (status = INACTIVE) and are no longer billed (endDate < now).

Query
locationsArray of stringsrequired

The uberall unique ids for the locations you want to delete

curl -i -X DELETE \
  'https://docs.uberall.com/_mock/apis/swagger/locations?locations=string' \
  -H 'accessToken: YOUR_API_KEY_HERE'

Responses

Locations successfully deleted

Body*/*
statusstringrequired
Enum"SUCCESS""QUOTA_LIMIT_EXCEED""NOT_AUTHORIZED""FORBIDDEN""BAD_ACCESS_TOKEN""BAD_PRIVATE_KEY""BAD_PUBLIC_KEY""MISSING_PARAMETER""INVALID_PARAMETER""WRONG_PARAMETER_TYPE"
messagestring

(optional) Holds further information about the response

warningsArray of strings

(optional) Holds further warnings

responseobjectrequired

The actual response object of the response

response.​deletedCountinteger(int32)

Total count of deleted items

Example: 10
response.​failedCountinteger(int32)

Total count of failed items

Example: 2
response.​deletedIdsArray of integers(int64)
response.​failedArray of strings
Response
No content

Custom Items

Locations Hub - Collections - Custom Items

Operations

Events

Locations Hub - Collections - Events

Operations

Listings

Locations Hub - Locations - Listings

Operations

Labels

Locations Hub - Labels

Operations

Location Groups

Locations Hub - Location Groups

Operations

Menu Items

Locations Hub - Locations - Menu Items

Operations

Persons

Locations Hub - Locations - Persons

Operations

Locations Photos

Locations Hub - Locations Photos

Operations

Products

Locations Hub - Locations - Product

Operations

Service Items

Locations Hub - Locations - Service Items

Operations

Suggestions

Locations Hub - Locations - Suggestions

Operations