Skip to main content
GET
/
api
/
v1
/
assets
/
{id}
cURL
curl --request GET \
  --url https://api.salvy.com.br/api/v1/assets/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "enrollmentId": "SLY-12345",
  "status": "in-use",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "source": "desktop-client",
  "customFields": [
    {
      "label": "teste",
      "type": "text",
      "value": "teste"
    }
  ],
  "category": "notebook",
  "brand": "Dell",
  "model": "XPS 13",
  "vendorName": "Tech Supplier Inc.",
  "serialNumber": "SN1234567890",
  "deviceId": "8A1D30F4-8C87-44CD-A663-2229DE6F64BD",
  "acquisitionDate": "2025-12-10T03:00:00.000Z",
  "acquisitionType": "bought",
  "priceCents": 250000,
  "nfeNumber": "000123456789",
  "contractId": "CT-2024-0001",
  "warrantyExpirationDate": "2025-12-24T03:00:00.000Z",
  "allocatedLocation": "Sala do RH",
  "employeeId": "123e4567-e89b-12d3-a456-426614174000",
  "employeeAttachedAt": "2025-01-01T00:00:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt

Use this file to discover all available pages before exploring further.

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
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
Example:

"desktop-client"

​
customFields
object[]
required

Campos personalizados do equipamento

Example:
[
  {
    "label": "teste",
    "type": "text",
    "value": "teste"
  }
]
​
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"