# List locations under a folder

```http
GET https://api.synup.com/api/v4/folder-locations
```

This API retrieves all locations within a specified folder and its subfolders.

**Response Includes:**
- Business details (name, category, address)
- Contact information (phone, email, website)
- Metadata (tags, attributes, custom fields)

:::info[]

Note: Either folderId or folderName must be provided.

:::

Source: https://developer.synup.com/api/organizing-locations/list-locations-under-a-folder

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `folderName` | string | optional | Name of the folder to fetch locations from |
| `folderId` | string | optional | Unique identifier of the folder |

## Example request

```bash
curl -X GET 'https://api.synup.com/api/v4/folder-locations' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successfully retrieved locations |
| `400` | Bad request - Invalid parameters |
| `403` | Unauthorized - insufficient permissions to access folder |
| `404` | Folder not found |