Skip to main content
GET
cURL
Este endpoint retorna os dados completos para um ativo, dado seu ID.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

id
string
required

Identificador do equipamento na plataforma Salvy (UUID)

Examples:

"123e4567-e89b-12d3-a456-426614174000"

"123e4567-e89b-12d3-a456-426614174001"

enrollmentId
string
required

Número de patrimônio do equipamento

Example:

"SLY-12345"

status
enum<string>
required

Situação do equipamento

Available options:
available,
in-use,
allocated,
maintenance,
broken,
lost,
stolen,
sold,
donated,
discarded,
archived,
obsolete,
blocked,
pending-verification,
awaiting-quote
Example:

"in-use"

createdAt
string<date-time>
required

Data de criação do equipamento

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Example:

"2025-01-01T00:00:00.000Z"

source
enum<string>
required

Fonte de criação do equipamento

Available options:
manual,
sheets-import,
nfe-import,
desktop-client,
mobile-app,
android-mdm
Example:

"desktop-client"

customFields
object[]
required

Campos personalizados do equipamento

Example:
category
string

Categoria do equipamento

Example:

"notebook"

brand
string

Marca do equipamento

Example:

"Dell"

model
string

Modelo do equipamento

Example:

"XPS 13"

vendorName
string

Nome do fornecedor do equipamento

Example:

"Tech Supplier Inc."

serialNumber
string

Número de série do equipamento

Example:

"SN1234567890"

deviceId
string

ID do dispositivo coletado pelo aplicativo mobile da Salvy

Example:

"8A1D30F4-8C87-44CD-A663-2229DE6F64BD"

acquisitionDate
string<date-time>

Data de aquisição do equipamento

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Example:

"2025-12-10T03:00:00.000Z"

acquisitionType
enum<string>

Tipo de aquisição do equipamento

Available options:
bought,
rented,
other
Example:

"bought"

priceCents
number

Preço de aquisição do equipamento em centavos

Example:

250000

nfeNumber
string

Número da nota fiscal de aquisição do equipamento

Example:

"000123456789"

contractId
string

Identificador do contrato relacionado ao equipamento

Example:

"CT-2024-0001"

warrantyExpirationDate
string<date-time>

Data de expiração da garantia do equipamento

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Example:

"2025-12-24T03:00:00.000Z"

allocatedLocation
string

Local de alocação do equipamento

Example:

"Sala do RH"

employeeId
string

Id do colaborador ao qual o equipamento está associado

Examples:

"123e4567-e89b-12d3-a456-426614174000"

"123e4567-e89b-12d3-a456-426614174001"

employeeAttachedAt
string<date-time>

Data de vinculação do colaborador ao equipamento. Removido automaticamente se o colaborador for desvinculado.

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Example:

"2025-01-01T00:00:00.000Z"