Retrieve a Location

GET

/businesses/{businessId}/locations/{locationId}

curl --request GET \
  --url https://api.upvio.com/v1/businesses/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/locations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

• production

Retrieve a specific location by its ID.

Authorizations

• apiKey

Parameters

Path Parameters

businessId

required

string format: uuid

Business ID

locationId

required

string format: uuid

Location ID

Responses

200

The requested location.

Media type application/json

object

data

Location

A physical or virtual location where services can be provided

object

id

required

Unique identifier across the platform.

string format: uuid

name

required

The name of the location

string

description

A description of the location

string

nullable

instructions

Instructions for finding or accessing the location

string

nullable

address

The physical address of the location

string

nullable

lat

Latitude of the location

number format: float

nullable

lng

Longitude of the location

number format: float

nullable

timezone

The timezone of the location

string

phone

Phone number of the location

string

nullable

email

Email address of the location

string format: email

nullable

pictureUrl

URL of the location’s picture

string format: uri

nullable

services

Services offered at the location

Array<object>

object

id

Unique identifier across the platform.

string format: uuid

name

Name of the service

string

createdAt

Timestamp of when the location was created

string format: date-time

updatedAt

Timestamp of when the location was last updated

string format: date-time

Example

{
  "data": {
    "name": "Downtown Office",
    "description": "Our main office in the city center",
    "instructions": "Enter through the main entrance and take the elevator to the 5th floor",
    "address": "123 Main St, New York, NY 10001",
    "timezone": "America/New_York"
  }
}

401

Location requires authentication

Media type application/json

object

error

object

code

number

title

string

Example

{
  "error": {
    "code": 404,
    "title": "Not Found"
  }
}

404

Location not found

Media type application/json

object

error

object

code

number

title

string

Example

{
  "error": {
    "code": 404,
    "title": "Not Found"
  }
}