1. Locations
  • Getting Started
  • Locations
    • Location Attributes
      MARKDOWN
    • Photo specifications for your business location
      MARKDOWN
    • Star and Unstar Photos
      MARKDOWN
    • Create a new business location
      POST
    • Update business location
      POST
    • List all locations
      GET
    • List particular locations
      GET
    • Search locations
      GET
    • Get locations by store codes
      GET
    • Get Photos by Location IDs
      GET
    • Upload Photos to a Location
      POST
    • Check Bulk Photo Upload Status
      GET
    • Star/Unstar Location Photos
      POST
    • Delete Location Photos
      POST
    • Archive multiple locations
      POST
    • Cancel scheduled location archival
      POST
    • Activate archived locations
      POST
    • List Active Subscriptions
      GET
    • Get a list of supported countries and their states
      GET
    • Get SubCategories and AdditionalCategories
      GET
    • Get Site Details for Your Plan
      GET
    • Location Indexing Rate
      GET
  • Organizing locations
    • Organizing locations
      MARKDOWN
    • Create a new folder
      POST
    • List all folders
      GET
    • List all folders under an account in hierarchical structure
      GET
    • Get details of a folder
      GET
    • Rename a folder
      POST
    • Add locations to a folder
      POST
    • Remove locations from a folder
      POST
    • Delete a folder
      POST
    • List locations under a folder
      GET
    • List all tags
      GET
    • List locations by tags
      GET
    • Add location to a tag
      POST
    • Remove location from a tag
      POST
  • User Management
    • User Attributes
    • Create User with Role
    • List Users
    • List Users by ID
    • Add Locations to User
    • Add User and folder
    • List User Roles
    • Add folders to user
    • List User Resources
    • Update a User
    • Remove Folders for User
    • Remove Locations for User
  • Grid Rank
    • Local Rank Grid
    • Create Rank Grid Report
    • Fetch All Grid Reports for Location
    • Fetch Rank Grid Report By ID
  • Review Campaigns
    • Review Campaign Info Attributes
    • Create a review campaign
    • Add customers to a review campaign
    • List review campaigns
    • List review campaign customers
  • Listings
    • Listings
    • Listing Status Webhooks
    • Get premium listings
    • Get voice listings for a location
    • Get duplicate listings for a location
    • Get all duplicate listings for an account
    • Mark listings as duplicates
    • Mark listings as not duplicates
    • Get AI listings
  • Connected Accounts
    • Connected Accounts
    • Connect Google Profile to Account
    • Connect Facebook Page to Account
    • List all connected accounts
    • List folders under a Google account
    • Create GMB Listing
    • Disconnect GMB Profile
    • Disconnect Facebook Account
    • Fetch Connected Account Details
    • Trigger New Matches
    • List Connection Suggestions
    • Fetch Connected Account Listings
    • Confirm Connected Account Matches
    • Connect a location with a listing of a connected account
    • Disconnect Location from Listing
    • create location from connected account listing
  • Rankings
    • Rankings Analytics Attributes
    • Add keywords
    • List Keywords
    • Get keywords performance
    • Archive a keyword
    • Get Rollup Keyword Performance
    • Get Rankings Distribution By Time
  • Profile Analytics
    • Profile Analytics
    • Get Bing Analytics
    • Get Facebook Page Analytics
    • Get Google My Business Analytics
  • Reviews
    • Reviews
    • Review Sources
      • Get a list of interaction sources for location
      • Get a list of interaction sources for account
      • Add / Edit interaction source
    • Fetch all interactions
    • List Interactions by IDs
    • Respond to an Interaction
    • Edit Response for Interaction
    • Archive Response for Interaction
    • Get Interaction Analytics
    • Add Review Widget
    • Edit Review Widget
    • Rollup Review API
  • Automations
    • Temporary Close Location with a reopening date
  • Error Codes
    • ERROR CODES
  • Schemas
    • Sample Schemas
      • Pet
      • Category
    • Schemas
      • FolderSchema
        • Schemas
          • ListFoldersResponse
          • FolderInfo
      • LocationResponseSchema
      • LocationResponseErrorSchema
      • SubCategory
      • SubscriptionsResponse
      • CreateFolderRequest
      • FolderNode
      • ListingsResponse
      • LocationListResponse
      • ConnectGoogleInput
      • ConnectFacebookInput
      • DisconnectGoogleRequest
      • TriggerMatchesRequest
      • FetchListingsRequest
      • ConfirmMatchesRequest
      • ConnectListingRequest
      • DisconnectListingRequest
      • ConnectedAccountDetailsResponse
      • ConnectionSuggestionsResponse
      • Keyword
      • Keyword
      • Keyword
      • UnauthorizedError
      • UnauthorizedError
      • UnauthorizedError
      • UnauthorizedError
      • InsightMetric
      • InsightMetric
      • CreateGridReportInput
      • AllGridReportsResponse
      • GridReportResponse
      • CreateUserInput
      • UsersResponse
      • UsersResponse
      • UsersByIdsResponse
      • AnalyticsOverview
      • Interaction
      • Interaction
      • InteractionsResponse
      • ResponseInteraction
      • AddLocationsInput
      • UserRole
      • UserRole
      • CreateReviewCampaignRequest
      • ReviewCampaignsResponse
      • ReviewCampaignCustomersResponse
      • PremiumListing
      • Subscription
      • CreateFolderResponse
      • Listing
      • ConnectGoogleResponse
      • ConnectFacebookResponse
      • DisconnectGoogleResponse
      • ConnectedAccount
      • TriggerMatchesResponse
      • ConfirmMatchesResponse
      • ConnectListingResponse
      • DisconnectListingResponse
      • Error
      • Error
      • BadRequestError
      • BadRequestError
      • BadRequestError
      • NotFoundError
      • UnauthorizedError
      • UnauthorizedError
      • CreateGridReportResponse
      • GridReport
      • GridReport
      • CreateUserResponse
      • PageInfo
      • PageInfo
      • UserDetail
      • AnalyticsTimeline
      • Response
      • Response
      • PageInfo
      • AddLocationsResponse
      • Pagination
      • Pagination
      • CustomerInput
      • ReviewCampaign
      • ReviewCampaignInfo
      • Tag
      • SearchResponse
      • LocationPhoto
      • CustomAttribute
      • Folder
      • Site
      • ConnectedAccountsResponse
      • LocationListing
      • ListingRecord
      • ConnectionSuggestion
      • NotFoundError
      • NotFoundError
      • RankPoint
      • RankPoint
      • CreatedUser
      • UserEdge
      • UserEdge
      • SiteWiseAnalytics
      • InteractionEdge
      • LocationAddStatus
      • LandingPageTemplate
      • EmailTemplate
      • ReviewCampaignCustomer
      • LocationEdge
      • Error
      • FetchListingsResponse
      • LocationInfo
      • User
      • User
      • MetricWithDelta
      • Interaction
      • EmailTemplate
      • SmsTemplate
      • SuggestedLocationInfo
      • SMSTemplate
      • CampaignStat
      • PageInfo
      • ReviewSite
      • BusinessHours
      • AddCustomersRequest
    • Business hours
    • paymentMethods
    • Contact Support
  1. Locations

List particular locations

GET
https://api.synup.com/api/v4/locations-by-ids

This API retrieves detailed information for one or more specified location IDs.
It provides comprehensive data about each location, including its name, address, contact details, business hours, categories, nedia and other relevant attributes.
It support for both active and archived locations.

Request

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.synup.com/api/v4/locations-by-ids?ids=["TG9jYXRpb246MQ==", "TG9jYXRpb246Mg=="]' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx'

Responses

🟢200Success response
application/json
Body

Example
{
    "data": {
        "getLocationsByIds": [
            {
                "accountId": 11073,
                "addOns": [
                    {
                        "id": "1",
                        "name": "Yelp Lite"
                    }
                ],
                "additionalCategoryIds": [
                    609
                ],
                "additionalCategoryNames": [
                    "Framing"
                ],
                "additionalInfo": null,
                "additionalPhones": [
                    "6036610058"
                ],
                "approved": "APPROVED",
                "archivalScheduledAt": null,
                "archived": false,
                "archivedAt": null,
                "bizUrl": "www.easports222.com",
                "bizUrlUtm": false,
                "bookingUrl": null,
                "businessHours": [
                    {
                        "day": "SUNDAY",
                        "slots": null,
                        "specialDate": null,
                        "type": "CLOSED"
                    },
                    {
                        "day": "MONDAY",
                        "slots": [
                            {
                                "end": "05:00pm",
                                "start": "09:00am"
                            }
                        ],
                        "specialDate": null,
                        "type": "OPEN"
                    },
                    {
                        "day": "TUESDAY",
                        "slots": [
                            {
                                "end": "01:00pm",
                                "start": "09:00am"
                            },
                            {
                                "end": "05:00pm",
                                "start": "02:00pm"
                            }
                        ],
                        "specialDate": null,
                        "type": "OPEN"
                    },
                    {
                        "day": "WEDNESDAY",
                        "slots": null,
                        "specialDate": null,
                        "type": "OPEN_24x7"
                    },
                    {
                        "day": "THURSDAY",
                        "slots": null,
                        "specialDate": null,
                        "type": "OPEN_24x7"
                    },
                    {
                        "day": "FRIDAY",
                        "slots": null,
                        "specialDate": null,
                        "type": "CLOSED"
                    },
                    {
                        "day": "SATURDAY",
                        "slots": null,
                        "specialDate": null,
                        "type": "CLOSED"
                    }
                ],
                "cancellationScheduledAt": null,
                "categoryId": 1,
                "city": "New York",
                "contentPreferredLanguage": "ENGLISH",
                "countryCode": "1",
                "countryIso": "US",
                "createErrors": [],
                "createdDate": "December 15, 2025",
                "customAttributes": [
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "Atributo",
                        "slug": "atributo",
                        "type": "STRING",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "offers_online_appointments",
                        "slug": "offers_online_appointments",
                        "type": "BOOLEAN",
                        "value": [
                            "false"
                        ]
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "welcomes_lgbtq",
                        "slug": "welcomes_lgbtq",
                        "type": "BOOLEAN",
                        "value": [
                            "true"
                        ]
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "has wheelchair",
                        "slug": "has_wheelchair",
                        "type": "BOOLEAN",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "utm",
                        "slug": "utm",
                        "type": "STRING",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "Slug",
                        "slug": "slug",
                        "type": "STRING",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "Name",
                        "slug": "name",
                        "type": "STRING",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "accept digital rupee",
                        "slug": "accept_digital_rupee",
                        "type": "INTEGER",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "has_onsite_parking",
                        "slug": "has_onsite_parking",
                        "type": "BOOLEAN",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "Test 23",
                        "slug": "test_23",
                        "type": "STRING",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "lead_photo_drive",
                        "slug": "lead_photo_drive",
                        "type": "STRING",
                        "value": []
                    },
                    {
                        "archived": false,
                        "enumValues": [],
                        "name": "Test French Locale 4",
                        "slug": "test_french_locale_4",
                        "type": "STRING",
                        "value": []
                    }
                ],
                "databaseId": 88350,
                "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor. This is a sample description which is used to complete the 200 characters. Let us believe this has exceeded the character limit otherwise it is going to be a headache to go and change it again. But still to be on the careful side, I am adding a few more line of characters because of which this is going to work.",
                "enabledSiteIds": [],
                "facebookUrl": "https://www.facebook.com/journeywithanthony/",
                "folderId": "57e34303-e9fd-422d-ad39-383849df7ea9",
                "folderName": "hello12341",
                "franchise": null,
                "googleAdsPhone": "8289989989",
                "googleVerificationStatus": {
                    "message": null,
                    "status": null
                },
                "googleplusUrl": null,
                "hideAddress": false,
                "id": "TG9jYXRpb246ODgzNTA=",
                "instagramUrl": "https://www.instagram.com/rajinikanth/",
                "isRestaurant": false,
                "lastUpdatedDate": "December 15, 2025",
                "latitude": "40.712775",
                "linkedinUrl": "https://www.linkedin.com/company/synup/",
                "locationPhotos": [],
                "longitude": "-74.005973",
                "managedServiceSiteBuckets": [],
                "managedServiceSites": [],
                "moreHours": [],
                "name": "Spinka Group",
                "offeringsUrl": null,
                "ownerEmail": "pttqa1+212@gmail.com",
                "ownerName": "John Doe",
                "package": "PREMIUM",
                "paymentMethods": [
                    "VISA",
                    "MASTERCARD",
                    "AMEX",
                    "CASH",
                    "CHEQUE",
                    "CRYPTO",
                    "DINERS_CLUB",
                    "DISCOVER",
                    "FINANCING",
                    "INVOICE",
                    "TRAVELERS_CHECK",
                    "APPLE_PAY",
                    "SAMSUNG_PAY",
                    "PAYPAL",
                    "ANDROID_PAY"
                ],
                "phone": "6036610058",
                "pinterestUrl": "https://pinterest.com/cozylivin77/",
                "planId": 59,
                "planName": null,
                "postalCode": "60605",
                "publisherAttributes": [],
                "reservationUrl": null,
                "serviceItems": [],
                "stateIso": "NY",
                "stateName": "New York",
                "storeId": "995si",
                "street": "123 Jump Street",
                "street1": null,
                "subCategoryId": 20,
                "subCategoryName": "Pilates",
                "tagline": "We Exist",
                "tags": [
                    "all",
                    "pk"
                ],
                "temporarilyClosed": false,
                "tiktokUrl": null,
                "toplineMessage": null,
                "toplineMessageText": null,
                "twitterUrl": "https://twitter.com/elonmusk",
                "uid": "0afc0561-04e0-4e72-b679-318310c1a8f1",
                "updatedAt": "2025-12-15T10:06:47.776Z",
                "videos": [
                    "https://www.youtube.com/watch?v=QKmrDUJFRkM"
                ],
                "voiceStatus": 1,
                "yearOfIncorporation": 1179,
                "youtubeUrl": null
            }
        ]
    }
}
🟠400Bad Request
🟠401Unauthorized
🟠404Record Not Found
Modified at 2025-12-15 10:24:59
Previous
List all locations
Next
Search locations
Built with