Retrieve a Vitals Link

GET

/businesses/{businessId}/vitals/links/{linkId}

const url = 'https://api.upvio.com/v1/businesses/example/vitals/links/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.upvio.com/v1/businesses/example/vitals/links/example \
  --header 'Authorization: Bearer <token>'

Retrieve a vitals link by ID.

Authorizations

apiKey

Parameters

Path Parameters

businessId

required

The ID of the Business.

string

linkId

required

The ID of the Vitals Link.

string

Responses

200

A Vitals Link.

application/json

object

data

object

required

Unique identifier across the platform.

string format: uuid

createdAt

required

Time when the resource was created (ISO 8601 format).

string format: date-time

updatedAt

required

Time when the resource was last updated (ISO 8601 format).

string format: date-time

name

required

The name of the link.

string

description

An optional description of the link.

string

nullable

slug

required

The unique slug used in the link URL.

string

status

required

The status of the link.

string

Allowed values: ACTIVE ARCHIVED DISABLED

vitalsTemplateId

required

The ID of the template this link uses.

string

scansCount

required

The number of scans performed using this link.

integer

maxScans

The maximum number of scans allowed for this link.

integer

nullable

expiresAt

When the link expires, if applicable.

string format: date-time

nullable

url

required

The full URL for this vitals link.

string format: uri

Example

{
  "data": {
    "status": "ACTIVE"
  }
}

404

Vitals Link not found.

application/json

object

error

object

code

number

title

string

Example

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