---
title: "Get voice listings for a location"
method: GET
path: "/locations/{locationId}/voice-assistants"
tags: ["Listings", "Voice Listings"]
---

# Get voice listings for a location

`GET /locations/{locationId}/voice-assistants`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/{locationId}/voice-assistants`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/:locationId/voice-assistants/get.ts> (a function with typed inputs; its response is checked against the schema)

This API retrieves all voice assistant listings associated with a specific location.

**Available Voice Assistants:**
- Google Assistant
- Cortana
- Alexa
- Siri
- Bixby

**Response Includes:**
- Sync status – Indicates whether the listing is successfully synced.
- Connection details – Provides integration status with each voice assistant.
- Potential issues – Highlights any errors preventing successful sync.

## Path parameters

- `locationId` string, required

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Response `200`

Voice listings retrieved successfully

- object
  - `data` object
    - `voiceAssistantsForLocation` object[]
      - `databaseId` string: Internal database identifier
      - `actionRequired` boolean: Indicates if user action is needed
      - `connectedAccountId` string, nullable: ID of the connected account if available
      - `errors` string[]: Array of error messages if any
      - `voiceIdentifier` 'GOOGLE_ASSISTANT' | 'CORTANA' | 'ALEXA' | 'SIRI' | 'BIXBY': Unique identifier for the voice assistant
      - `name` string: Display name of the voice assistant
      - `syncStatus` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': Current sync status
      - `syncIssue` string, nullable: Description of any sync issues
      - `__typename` string: GraphQL type name

## Other responses

- `400`: Bad request - invalid location ID
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - insufficient permissions
- `404`: Location not found

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)