curl --request GET \
--url https://api.gotrebol.com/verification-items/{id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/verification-items/{id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.gotrebol.com/verification-items/{id}', 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://api.gotrebol.com/verification-items/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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://api.gotrebol.com/verification-items/{id}"
req, _ := http.NewRequest("GET", url, nil)
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))
}HttpResponse<String> response = Unirest.get("https://api.gotrebol.com/verification-items/{id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/verification-items/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 26600,
"item_order": 3,
"item_status": "complete",
"item_type": "ac_mx",
"item_internal_status": "classification_failed",
"item_value": {
"value": "itemCustomed"
},
"user_event_completed_at": "2025-09-23T03:30:32Z",
"user_event_name": "add_item",
"user_event_reason": "item created without a file_url",
"tag": null,
"item_scope": "advanced",
"tags": {
"uploaded-from": "webapp-creation-business"
},
"original_file_url": "https://files.staging.gotrebol.com/66b4b55e-0e4f-42ec-9727-2bff88965562/26600_original_file.pdf?response-content-type=application%2Fpdf&response-content-disposition=inline&Expires=1758902113&Key-Pair-Id=K2O2X5EIJK95L0&Signature=X0if4WzR23I0s61h~gW2s-92nGNXhQBHZp9bxl42HqMSMO1VYpybLmhtygyJfx5OvZL4NSoYHTYfH7-yZv02lRwtNSI~xYFAVVxPPFROzwblK66LwymsQWAE0xvwtI98eWQKBWop3rgHADqrUGIm1RBa2qm3Ydlj2HVtWmsrVn2OTMtnIuoyI50Z8iYmx6hcPLul6SazK4h18MMRRi5xnsa2shrGs36rLyRFlnDBObRFJBKmkH4Dn27PuCVrXQRHQwRUIyRCQAiLGSuVKDp~iWZqTld6qgDQOkq-0A54dv0r8O6hYZ5fPyX1ufeIJeaKaGKjKC9qAiOWl~wQe6-w9g__"
}Obtener un item de verificación por ID
Retorna un item de verificación específico por su ID.
Coordenadas de citas: para items de tipo acta, agrega ?with_citations=true y la respuesta incluirá citations.url con la URL firmada al artifact de coordenadas de ese documento. Ver Coordenadas de citas.
curl --request GET \
--url https://api.gotrebol.com/verification-items/{id} \
--header 'x-api-key: <api-key>'import requests
url = "https://api.gotrebol.com/verification-items/{id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.gotrebol.com/verification-items/{id}', 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://api.gotrebol.com/verification-items/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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://api.gotrebol.com/verification-items/{id}"
req, _ := http.NewRequest("GET", url, nil)
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))
}HttpResponse<String> response = Unirest.get("https://api.gotrebol.com/verification-items/{id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gotrebol.com/verification-items/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"id": 26600,
"item_order": 3,
"item_status": "complete",
"item_type": "ac_mx",
"item_internal_status": "classification_failed",
"item_value": {
"value": "itemCustomed"
},
"user_event_completed_at": "2025-09-23T03:30:32Z",
"user_event_name": "add_item",
"user_event_reason": "item created without a file_url",
"tag": null,
"item_scope": "advanced",
"tags": {
"uploaded-from": "webapp-creation-business"
},
"original_file_url": "https://files.staging.gotrebol.com/66b4b55e-0e4f-42ec-9727-2bff88965562/26600_original_file.pdf?response-content-type=application%2Fpdf&response-content-disposition=inline&Expires=1758902113&Key-Pair-Id=K2O2X5EIJK95L0&Signature=X0if4WzR23I0s61h~gW2s-92nGNXhQBHZp9bxl42HqMSMO1VYpybLmhtygyJfx5OvZL4NSoYHTYfH7-yZv02lRwtNSI~xYFAVVxPPFROzwblK66LwymsQWAE0xvwtI98eWQKBWop3rgHADqrUGIm1RBa2qm3Ydlj2HVtWmsrVn2OTMtnIuoyI50Z8iYmx6hcPLul6SazK4h18MMRRi5xnsa2shrGs36rLyRFlnDBObRFJBKmkH4Dn27PuCVrXQRHQwRUIyRCQAiLGSuVKDp~iWZqTld6qgDQOkq-0A54dv0r8O6hYZ5fPyX1ufeIJeaKaGKjKC9qAiOWl~wQe6-w9g__"
}Authorizations
Path Parameters
El ID único del item de verificación
Query Parameters
Solo aplica a items de tipo acta. Si es true, la respuesta incluye citations.url: una URL firmada al artifact de coordenadas de ese documento. Ver Coordenadas de citas.
Response
Item de verificación obtenido exitosamente
Estructura depende de item_type. Ver guía en /guia-devs/respuestas-por-tipo-de-item.
Además de los campos propios del tipo, incluye una llave cp_<prompt_id> por cada extracción personalizada con resultado para ese ítem, donde prompt_id es el identificador editable de la extracción. Ver Extracciones personalizadas.
Ese prefijo solo aplica a tipos de documento estándar. Un ítem de un tipo de ítem personalizado (item_type con prefijo cit_) nunca lleva llaves cp_: sus resultados viven en pipeline, con la forma del schema CustomItemTypeItemValue. Ver Tipos de ítem personalizados.
Campo opcional que indica errores públicos relacionados con el procesamiento del ítem. Su valor depende del item_type que produjo el error.
Comunes a ítems documentales
password_protected_pdf: el PDF está protegido con contraseña y no puede procesarse.get_input_file_info_failed: falló la obtención de información del archivo de entrada.
Específicos de doc_splitter (ver guía para el listado completo)
unsupported_file_type: el archivo no es un PDF.unknown_custom_item_type/misconfigured_custom_item_type:allowed_item_typesoclient_item_typereferencia un tipo personalizado (cit_*) que no existe o no está listo.no_splits_returned: el análisis no identificó ningún documento en el PDF.pdf_slice_failed: no se pudo leer o recortar el PDF (archivo corrupto o error de descarga del original).pdf_slice_upload_failed: se recortaron los sub-PDFs pero falló la subida de al menos uno.doc_splitter_request_failed: falló la llamada al servicio de análisis (OCR o AI). Reintentar suele resolverlo.
Específicos de doc_validation
invalid_document_type: el documento no corresponde alclient_item_typeesperado.ruleset_validation_failed: al menos una regla delrulesetno se cumplió.
Trata este campo como un string opaco: además de los códigos anteriores puede llegar con otros valores para ítems específicos (por ejemplo prevalidation_failed en csf_mx) o, en errores inesperados, con un mensaje libre en inglés.
Show child attributes
Show child attributes
Presente solo cuando se llamó con ?with_citations=true y el item es de tipo acta. Contiene la URL firmada (CloudFront) al artifact de coordenadas en S3. Ver Coordenadas de citas.
Show child attributes
Show child attributes
Was this page helpful?