Historial

Endpoints del historial de clasificacion - consulte, filtre y recupere el detalle de sus clasificaciones pasadas.

Los endpoints de historial permiten consultar y filtrar todas sus clasificaciones pasadas. Cada clasificacion realizada a traves de la API se registra automaticamente y es accesible.

Listar el historial de clasificaciones

GET/v1/classify/history

Parametros de consulta

Parametro	Tipo	Defecto	Descripcion
`page`	`number`	`1`	Numero de pagina
`per_page`	`number`	`20`	Resultados por pagina (max 50)
`from`	`string` (ISO 8601)	-	Fecha de inicio (incluida)
`to`	`string` (ISO 8601)	-	Fecha de fin (incluida)
`hs`	`string`	-	Filtrar por codigo HS (se acepta prefijo, ej: `8518`)
`status`	`string`	-	Filtrar por estado: `completed`, `failed`
`source`	`string`	-	Filtrar por fuente: `api`, `web`, `batch`
`all_keys`	`boolean`	`false`	Incluir clasificaciones de todas las claves API de la organizacion

Ejemplo de solicitud

curl "https://api.thetradehub.eu/v1/classify/history?page=1&per_page=10&status=completed&from=2026-02-01T00:00:00Z" \
  -H "X-API-Key: th_live_su_clave_api"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_su_clave_api"},
)

response = client.get("/v1/classify/history", params={
    "page": 1,
    "per_page": 10,
    "status": "completed",
    "from": "2026-02-01T00:00:00Z",
})

data = response.json()
print(f"Total: {data['total']} clasificaciones")
for item in data["items"]:
    hs = item["result"]["classification"]["rankings"][0]["hs_code"]
    print(f"  {item['id']} - {hs} - {item['created_at']}")

const params = new URLSearchParams({
  page: "1",
  per_page: "10",
  status: "completed",
  from: "2026-02-01T00:00:00Z",
});

const response = await fetch(
  `https://api.thetradehub.eu/v1/classify/history?${params}`,
  { headers: { "X-API-Key": "th_live_su_clave_api" } }
);

const data = await response.json();
console.log(`Total: ${data.total} clasificaciones`);
for (const item of data.items) {
  const hs = item.result.classification.rankings[0].hs_code;
  console.log(`  ${item.id} - ${hs} - ${item.created_at}`);
}

Respuesta

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "completed",
      "content": "Auriculares Bluetooth inalambricos",
      "result": {
        "classification": {
          "rankings": [
            {
              "rank": 1,
              "hs_code": "8518.30.00",
              "description": "Auriculares y cascos",
              "confidence": 0.94
            }
          ]
        }
      },
      "source": "api",
      "api_key_name": "Production Key",
      "created_at": "2026-02-24T10:30:00Z"
    }
  ],
  "total": 156,
  "page": 1,
  "per_page": 10,
  "pages": 16
}

Estructura de la respuesta paginada

Campo	Tipo	Descripcion
`items`	`object[]`	Lista de clasificaciones
`total`	`number`	Numero total de resultados
`page`	`number`	Pagina actual
`per_page`	`number`	Resultados por pagina
`pages`	`number`	Numero total de paginas

Detalle de una clasificacion

GET/v1/classify/history/{log_id}

Parametros de ruta

Parametro	Tipo	Descripcion
`log_id`	`string` (UUID)	Identificador de la clasificacion

Ejemplo de solicitud

curl https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: th_live_su_clave_api"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_su_clave_api"},
)

response = client.get("/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890")
log = response.json()

print(f"Producto: {log['content']}")
print(f"Codigo HS: {log['result']['classification']['rankings'][0]['hs_code']}")
print(f"Confianza: {log['result']['classification']['rankings'][0]['confidence']}")

const response = await fetch(
  "https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  { headers: { "X-API-Key": "th_live_su_clave_api" } }
);

const log = await response.json();
console.log(`Producto: ${log.content}`);
console.log(`Codigo HS: ${log.result.classification.rankings[0].hs_code}`);
console.log(`Confianza: ${log.result.classification.rankings[0].confidence}`);

Respuesta

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "content": "Auriculares Bluetooth inalambricos con cancelacion activa de ruido",
  "image_urls": ["https://example.com/product/headphones.jpg"],
  "locale": "es",
  "result": {
    "classification": {
      "rankings": [
        {
          "rank": 1,
          "hs_code": "8518.30.00",
          "description": "Auriculares y cascos",
          "confidence": 0.94,
          "gri_justification": "RGI 1 - El producto esta expresamente cubierto por la posicion 8518...",
          "validated": true
        }
      ]
    },
    "text": "Basado en las decisiones IVO de la UE y la nomenclatura TARIC..."
  },
  "source": "api",
  "api_key_name": "Production Key",
  "session_id": "sess_abc123",
  "created_at": "2026-02-24T10:30:00Z",
  "updated_at": "2026-02-24T10:30:05Z"
}

Filtros avanzados

Filtro por codigo HS

El parametro hs acepta un prefijo de codigo HS. Filtra las clasificaciones cuyo primer resultado comienza con ese prefijo:

# Todos los productos clasificados en el capitulo 85 (maquinas y aparatos electricos)
curl "https://api.thetradehub.eu/v1/classify/history?hs=85" \
  -H "X-API-Key: th_live_su_clave_api"

# Partida especifica 8518 (microfonos, altavoces, auriculares)
curl "https://api.thetradehub.eu/v1/classify/history?hs=8518" \
  -H "X-API-Key: th_live_su_clave_api"

Filtro por periodo

Combine from y to para restringir el periodo. Las fechas deben estar en formato ISO 8601:

# Clasificaciones de febrero 2026
curl "https://api.thetradehub.eu/v1/classify/history?from=2026-02-01T00:00:00Z&to=2026-02-28T23:59:59Z" \
  -H "X-API-Key: th_live_su_clave_api"

Visibilidad multi-clave

Por defecto, solo se devuelven las clasificaciones realizadas con la clave API utilizada para la llamada. Active all_keys=true para ver las clasificaciones de todas las claves de su organizacion:

curl "https://api.thetradehub.eu/v1/classify/history?all_keys=true" \
  -H "X-API-Key: th_live_su_clave_api"

Los endpoints de historial permiten consultar y filtrar todas sus clasificaciones pasadas. Cada clasificacion realizada a traves de la API se registra automaticamente y es accesible.

Listar el historial de clasificaciones

GET/v1/classify/history

Parametros de consulta

Parametro	Tipo	Defecto	Descripcion
`page`	`number`	`1`	Numero de pagina
`per_page`	`number`	`20`	Resultados por pagina (max 50)
`from`	`string` (ISO 8601)	-	Fecha de inicio (incluida)
`to`	`string` (ISO 8601)	-	Fecha de fin (incluida)
`hs`	`string`	-	Filtrar por codigo HS (se acepta prefijo, ej: `8518`)
`status`	`string`	-	Filtrar por estado: `completed`, `failed`
`source`	`string`	-	Filtrar por fuente: `api`, `web`, `batch`
`all_keys`	`boolean`	`false`	Incluir clasificaciones de todas las claves API de la organizacion

Ejemplo de solicitud

curl "https://api.thetradehub.eu/v1/classify/history?page=1&per_page=10&status=completed&from=2026-02-01T00:00:00Z" \
  -H "X-API-Key: th_live_su_clave_api"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_su_clave_api"},
)

response = client.get("/v1/classify/history", params={
    "page": 1,
    "per_page": 10,
    "status": "completed",
    "from": "2026-02-01T00:00:00Z",
})

data = response.json()
print(f"Total: {data['total']} clasificaciones")
for item in data["items"]:
    hs = item["result"]["classification"]["rankings"][0]["hs_code"]
    print(f"  {item['id']} - {hs} - {item['created_at']}")

const params = new URLSearchParams({
  page: "1",
  per_page: "10",
  status: "completed",
  from: "2026-02-01T00:00:00Z",
});

const response = await fetch(
  `https://api.thetradehub.eu/v1/classify/history?${params}`,
  { headers: { "X-API-Key": "th_live_su_clave_api" } }
);

const data = await response.json();
console.log(`Total: ${data.total} clasificaciones`);
for (const item of data.items) {
  const hs = item.result.classification.rankings[0].hs_code;
  console.log(`  ${item.id} - ${hs} - ${item.created_at}`);
}

Respuesta

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "completed",
      "content": "Auriculares Bluetooth inalambricos",
      "result": {
        "classification": {
          "rankings": [
            {
              "rank": 1,
              "hs_code": "8518.30.00",
              "description": "Auriculares y cascos",
              "confidence": 0.94
            }
          ]
        }
      },
      "source": "api",
      "api_key_name": "Production Key",
      "created_at": "2026-02-24T10:30:00Z"
    }
  ],
  "total": 156,
  "page": 1,
  "per_page": 10,
  "pages": 16
}

Estructura de la respuesta paginada

Campo	Tipo	Descripcion
`items`	`object[]`	Lista de clasificaciones
`total`	`number`	Numero total de resultados
`page`	`number`	Pagina actual
`per_page`	`number`	Resultados por pagina
`pages`	`number`	Numero total de paginas

Detalle de una clasificacion

GET/v1/classify/history/{log_id}

Parametros de ruta

Parametro	Tipo	Descripcion
`log_id`	`string` (UUID)	Identificador de la clasificacion

Ejemplo de solicitud

curl https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-API-Key: th_live_su_clave_api"

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_su_clave_api"},
)

response = client.get("/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890")
log = response.json()

print(f"Producto: {log['content']}")
print(f"Codigo HS: {log['result']['classification']['rankings'][0]['hs_code']}")
print(f"Confianza: {log['result']['classification']['rankings'][0]['confidence']}")

const response = await fetch(
  "https://api.thetradehub.eu/v1/classify/history/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  { headers: { "X-API-Key": "th_live_su_clave_api" } }
);

const log = await response.json();
console.log(`Producto: ${log.content}`);
console.log(`Codigo HS: ${log.result.classification.rankings[0].hs_code}`);
console.log(`Confianza: ${log.result.classification.rankings[0].confidence}`);

Respuesta

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "content": "Auriculares Bluetooth inalambricos con cancelacion activa de ruido",
  "image_urls": ["https://example.com/product/headphones.jpg"],
  "locale": "es",
  "result": {
    "classification": {
      "rankings": [
        {
          "rank": 1,
          "hs_code": "8518.30.00",
          "description": "Auriculares y cascos",
          "confidence": 0.94,
          "gri_justification": "RGI 1 - El producto esta expresamente cubierto por la posicion 8518...",
          "validated": true
        }
      ]
    },
    "text": "Basado en las decisiones IVO de la UE y la nomenclatura TARIC..."
  },
  "source": "api",
  "api_key_name": "Production Key",
  "session_id": "sess_abc123",
  "created_at": "2026-02-24T10:30:00Z",
  "updated_at": "2026-02-24T10:30:05Z"
}

Filtros avanzados

Filtro por codigo HS

El parametro hs acepta un prefijo de codigo HS. Filtra las clasificaciones cuyo primer resultado comienza con ese prefijo:

# Todos los productos clasificados en el capitulo 85 (maquinas y aparatos electricos)
curl "https://api.thetradehub.eu/v1/classify/history?hs=85" \
  -H "X-API-Key: th_live_su_clave_api"

# Partida especifica 8518 (microfonos, altavoces, auriculares)
curl "https://api.thetradehub.eu/v1/classify/history?hs=8518" \
  -H "X-API-Key: th_live_su_clave_api"

Filtro por periodo

Combine from y to para restringir el periodo. Las fechas deben estar en formato ISO 8601:

# Clasificaciones de febrero 2026
curl "https://api.thetradehub.eu/v1/classify/history?from=2026-02-01T00:00:00Z&to=2026-02-28T23:59:59Z" \
  -H "X-API-Key: th_live_su_clave_api"

Visibilidad multi-clave

Por defecto, solo se devuelven las clasificaciones realizadas con la clave API utilizada para la llamada. Active all_keys=true para ver las clasificaciones de todas las claves de su organizacion:

curl "https://api.thetradehub.eu/v1/classify/history?all_keys=true" \
  -H "X-API-Key: th_live_su_clave_api"

Listar el historial de clasificaciones

Parametros de consulta

Ejemplo de solicitud

Respuesta

Estructura de la respuesta paginada

Detalle de una clasificacion

Parametros de ruta

Ejemplo de solicitud

Respuesta

Filtros avanzados

Filtro por codigo HS

Filtro por periodo

Visibilidad multi-clave

En esta página

Historial

Listar el historial de clasificaciones

Parametros de consulta

Ejemplo de solicitud

Respuesta

Estructura de la respuesta paginada

Detalle de una clasificacion

Parametros de ruta

Ejemplo de solicitud

Respuesta

Filtros avanzados

Filtro por codigo HS

Filtro por periodo

Visibilidad multi-clave

En esta página