Get asset

GET

/assets/{assetId}

curl --request GET \
  --url https://safe-api.safetyradar.com/v2/assets/123e4567-e89b-12d3-a456-426614174000 \
  --header 'Authorization: Bearer <token>'

• Production

Get a single asset (location or equipment) by UUID or external ID.

Authorizations

• Bearer

Parameters

Path Parameters

assetId

required

Asset ID (UUID) or external ID

string

Example

123e4567-e89b-12d3-a456-426614174000

Asset ID (UUID) or external ID

Responses

200

Asset found

Media typeapplication/json

object

data

required

object

id

required

string format: uuid

organizationId

required

string format: uuid

name

required

string

description

required

string

nullable

slug

required

string

address1

required

string

nullable

address2

required

string

nullable

city

required

string

nullable

state

required

string

nullable

zip

required

string

nullable

latitude

required

number

nullable >= -140737488355328 <= 140737488355327

longitude

required

number

nullable >= -140737488355328 <= 140737488355327

status

required

string

Allowed values: active inactive

type

required

string

Allowed values: equipment location

parentId

required

string format: uuid

nullable

externalId

required

string

nullable

createdById

required

string format: uuid

nullable

lastEditedById

required

string format: uuid

nullable

searchText

nullable

createdAt

required

string

updatedAt

required

string

deletedAt

required

string

nullable

externalParentId

External ID of the parent asset (computed from parentId lookup)

string

nullable

Example

{
  "data": {
    "status": "active",
    "type": "equipment"
  }
}

401

Unauthorized

Media typeapplication/json

object

code

required

string

message

required

string

details

object

key

additional properties

nullable

Example^generated

{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

404

Asset not found

Media typeapplication/json

object

code

required

string

message

required

string

details

object

key

additional properties

nullable

Example^generated

{
  "code": "example",
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}