Skip to main content

​
POST /api/public-reports/generate

Genera un token único para compartir reportes financieros de un perfil de forma pública. Opcionalmente puede enviar el enlace por email.

​
Autenticación

Requiere autenticación con Bearer token y acceso al plan con reportes públicos.

​
Body Parameters

​
profile_id
string
required
UUID del perfil para el cual se generará el reporte público.
​
expires_in_days
integer
Número de días hasta que expire el token. Debe ser un número entre 1 y 365. Por defecto, el token no expira.
​
send_to_email
string
Email al cual enviar el enlace del reporte público. Debe ser un email válido.

​
Response

​
token
string
UUID único que sirve como token de acceso al reporte público.
​
url
string
URL completa para acceder al reporte público.
​
profile_id
string
UUID del perfil asociado al reporte.
​
expires_at
string | null
Fecha y hora de expiración del token (formato ISO 8601). null si no expira.
​
created_at
string
Fecha y hora de creación del token (formato ISO 8601).
​
message
string
Mensaje opcional si el email fue enviado o si hubo algún problema.

​
Códigos de Estado

  • 201 - Token generado exitosamente
  • 400 - Parámetros inválidos
  • 401 - No autenticado
  • 404 - Perfil no encontrado
  • 500 - Error del servidor
curl --request POST \
  --url 'https://api.contafy.com/api/public-reports/generate' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "123e4567-e89b-12d3-a456-426614174000",
    "expires_in_days": 30
  }'

{
  "token": "789e0123-f45a-67b8-c901-234567890abc",
  "url": "https://api.contafy.com/public/reports/789e0123-f45a-67b8-c901-234567890abc",
  "profile_id": "123e4567-e89b-12d3-a456-426614174000",
  "expires_at": "2026-04-06T10:30:00.000Z",
  "created_at": "2026-03-07T10:30:00.000Z"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us