Recuperar Uso del Limite

curl --request GET \
  --url https://tracer.sandbox.lerian.net/v1/limits/{id}/usage \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://tracer.sandbox.lerian.net/v1/limits/{id}/usage"

headers = {
    "Content-Type": "<content-type>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': '<content-type>', 'X-API-Key': '<api-key>'}
};

fetch('https://tracer.sandbox.lerian.net/v1/limits/{id}/usage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tracer.sandbox.lerian.net/v1/limits/{id}/usage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://tracer.sandbox.lerian.net/v1/limits/{id}/usage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://tracer.sandbox.lerian.net/v1/limits/{id}/usage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = '<content-type>'
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "limitId": "019c96a0-0c0d-7915-84b9-e497bfee9916",
  "limitAmount": "50000.00",
  "currentUsage": "15000.00",
  "utilizationPercent": 30,
  "nearLimit": false,
  "resetAt": "2026-01-31T00:00:00Z"
}

{
  "code": "TRC-0007",
  "title": "Invalid Path Parameter",
  "message": "The provided ID is not a valid UUID format. Please verify the ID and try again."
}

{
  "code": "Unauthenticated",
  "title": "Unauthorized",
  "message": "API Key missing or invalid. Provide a valid API Key in the X-API-Key header."
}

{
  "code": "TRC-0120",
  "title": "Limit Not Found",
  "message": "The requested limit does not exist. Please verify the limit ID and try again."
}

{
  "code": "TRC-0004",
  "title": "Internal Server Error",
  "message": "An unexpected error occurred. Please try again later or contact support if the issue persists."
}

GET

limits

{id}

usage

Recuperar Uso del Limite

curl --request GET \
  --url https://tracer.sandbox.lerian.net/v1/limits/{id}/usage \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://tracer.sandbox.lerian.net/v1/limits/{id}/usage"

headers = {
    "Content-Type": "<content-type>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': '<content-type>', 'X-API-Key': '<api-key>'}
};

fetch('https://tracer.sandbox.lerian.net/v1/limits/{id}/usage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tracer.sandbox.lerian.net/v1/limits/{id}/usage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: <content-type>",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://tracer.sandbox.lerian.net/v1/limits/{id}/usage"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Content-Type", "<content-type>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://tracer.sandbox.lerian.net/v1/limits/{id}/usage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Content-Type"] = '<content-type>'
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "limitId": "019c96a0-0c0d-7915-84b9-e497bfee9916",
  "limitAmount": "50000.00",
  "currentUsage": "15000.00",
  "utilizationPercent": 30,
  "nearLimit": false,
  "resetAt": "2026-01-31T00:00:00Z"
}

{
  "code": "TRC-0007",
  "title": "Invalid Path Parameter",
  "message": "The provided ID is not a valid UUID format. Please verify the ID and try again."
}

{
  "code": "Unauthenticated",
  "title": "Unauthorized",
  "message": "API Key missing or invalid. Provide a valid API Key in the X-API-Key header."
}

{
  "code": "TRC-0120",
  "title": "Limit Not Found",
  "message": "The requested limit does not exist. Please verify the limit ID and try again."
}

{
  "code": "TRC-0004",
  "title": "Internal Server Error",
  "message": "An unexpected error occurred. Please try again later or contact support if the issue persists."
}

Autorizaciones

X-API-Key

string

header

requerido

Autenticación por API Key. Utilizada por los despliegues de inquilino único (MULTI_TENANT_ENABLED=false). Se envía en cada solicitud /v1/*.

Encabezados

Content-Type

string

requerido

El tipo de medio del recurso. Debe ser application/json.

X-API-Key

string

requerido

La clave API para autenticacion. Este encabezado es requerido para todos los endpoints excepto verificaciones de salud.

X-Request-Id

string<uuid>

Un identificador unico usado para rastrear y seguir cada solicitud.

Parámetros de ruta

string<uuid>

requerido

El identificador unico del limite que desea recuperar, actualizar o eliminar.

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.

Instantanea de uso actual para un limite.

limitId

string<uuid>

El identificador del limite.

limitAmount

string

Monto total del límite como cadena decimal (ej., "50000.00").

currentUsage

string

Monto de uso acumulado como cadena decimal, sumando los contadores de uso registrados para este límite entre períodos y alcances. Retorna "0" para límites PER_TRANSACTION, que no rastrean uso persistente.

utilizationPercent

number<float>

Porcentaje de uso (currentUsage / limitAmount * 100).

nearLimit

boolean

Verdadero si el uso excede el 80% del limite.

resetAt

string<date-time> | null

Frontera de reinicio registrada para este límite. Null para límites PER_TRANSACTION.

⌘I

Primeros pasos

API de Validaciones

API de Reglas

API de Límites

API de Reservas

API de Eventos de Auditoría

Manejo de errores

Recuperar Uso del Limite

Autorizaciones

Encabezados

Parámetros de ruta

Respuesta