---
title: "Search spaces"
method: POST
path: "/maps-service/spaces/search"
tags: ["Spaces"]
---

# Search spaces

`POST /maps-service/spaces/search`

## Request

- Base URL: `https://api.therr.com/v1`
- URL: `https://api.therr.com/v1/maps-service/spaces/search`
- Auth: API key in header `x-api-key`

Search for spaces by location. Returns spaces within proximity of the given coordinates.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `itemsPerPage` integer
- `pageNumber` integer

## Response `200`

Search results

- SpaceSearchResponse
  - `results` Space[]
    - `id` string, uuid
    - `fromUserId` string, uuid
    - `organizationId` string, uuid, nullable
    - `message` string
    - `notificationMsg` string
    - `category` string
    - `latitude` number
    - `longitude` number
    - `radius` number
    - `region` string: Country code
    - `isPublic` boolean
    - `isDraft` boolean
    - `addressReadable` string
    - `phoneNumber` string
    - `businessEmail` string
    - `websiteUrl` string
    - `menuUrl` string
    - `orderUrl` string
    - `reservationUrl` string
    - `priceRange` integer
    - `openingHours` object
    - `hashTags` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `pagination` object
    - `itemsPerPage` integer
    - `pageNumber` integer

---

[API](https://skmtc.dev/therr/apis/therr-public-api.md) - [All operations](https://skmtc.dev/therr/apis/therr-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/therr/apis/therr-public-api/revisions/542ee3d6e214?raw)