Consultar firma

Responde si una persona ya aceptó alguno de los dos documentos, así no tenés que guardar nada de la llamada que emitió su enlace.

GET/v1/tyc/signatures/{dni}

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Access token en formato Bearer ACCESS_TOKEN

Path Parameters

Campo	Tipo	Requerido	Descripción
dni	string	Sí	7 u 8 dígitos. Sólo dígitos — sin puntos.

Query Parameters

kind no tiene default

El documento se nombra en vez de adivinarse — igual que cuando pedís el enlace.

• Son dos documentos distintos: un enlace VINCULATION firmado es la conformidad de la vinculación, no la aceptación de los términos.
• Contestar sobre el que no es sería peor que no contestar.

Campo	Tipo	Requerido	Descripción
kind	string	Sí	TYC o VINCULATION. Sobre qué documento estás preguntando. Distingue mayúsculas.

No aplica: Body.

Response

2XX Éxito

Status: 200 OK

Quien no firmó responde con la misma forma, así no aparece ni desaparece nada entre un caso y el otro:

{
  "dni": "37087294",
  "kind": "TYC",
  "signed": false,
  "document_version": null,
  "signed_at": null
}

Campo	Tipo	Descripción
dni	string	El documento por el que preguntaste.
kind	string	El documento por el que preguntaste, devuelto tal cual.
signed	boolean	Si esa persona aceptó ese documento.
document_version	string | null	Qué aceptó, tal cual se mandó en la llamada de aceptación. null cuando signed es false.
signed_at	string | null	Cuándo aceptó. ISO 8601, UTC. null cuando signed es false.

Una persona para la que nunca pediste un enlace responde igual que una que tiene enlaces pero no firmó: signed en false. Los dos casos son distintos en nuestros registros, pero no en lo que hacés después.

Si la misma persona firma el mismo documento dos veces —puede pasar, porque pedir un enlace nuevo sólo retira el que no había usado— la respuesta es la firma más reciente.

La respuesta cubre los enlaces que pediste vos. No es una consulta de todas las firmas que esa persona le haya dado a Allaria por otro canal.

Códigos de error

Status	Descripción
401	Unauthorized — access token inválido o ausente
403	Forbidden — tu client_id no está autorizado para este endpoint
422	Unprocessable Entity — dni no tiene 7 u 8 dígitos, o falta kind o no es uno de los dos valores
500	Internal Server Error — {"error": "internal_error"}

Estructura del error (422):

{
  "error": "invalid_payload",
  "detail": "kind Field required",
  "problems": [
    { "field": "kind", "message": "Field required" }
  ]
}

Ejemplo de código

cURL

curl -X GET "https://b2b.allaria.dev/v1/tyc/signatures/37087294?kind=TYC" \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const response = await fetch('https://b2b.allaria.dev/v1/tyc/signatures/37087294?kind=TYC', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ACCESS_TOKEN' }
});
const data = await response.json();
console.log(data.signed);

Python

import requests
response = requests.get(
  'https://b2b.allaria.dev/v1/tyc/signatures/37087294',
  params={ 'kind': 'TYC' },
  headers={ 'Authorization': 'Bearer ACCESS_TOKEN' }
)
data = response.json()
print(data['signed'])

Node.js

const axios = require('axios');
const response = await axios.get('https://b2b.allaria.dev/v1/tyc/signatures/37087294', {
  params: { kind: 'TYC' },
  headers: { Authorization: 'Bearer ACCESS_TOKEN' }
});
console.log(response.data.signed);

2XX Éxito

{
  "dni": "37087294",
  "kind": "TYC",
  "signed": true,
  "document_version": "tyc-v3-2026-08",
  "signed_at": "2026-09-22T19:14:19Z"
}