Respuestas de un formulario
https://api.afer.pro/api/v1/forms/{id}/responses
GET https://api.afer.pro/api/v1/forms/{formularioId}/responses
Resumen por pregunta listo para un dashboard y, si quieres, las respuestas una a una.
resumen: total, primera y última, respuestas por día y, por pregunta: media, mínimo, máximo y reparto en las escalas (con NPS en las de 0 a 10), reparto con porcentaje en las de opciones y sí/no, y los últimos textos en las abiertas.
Con incluir_respuestas, además, una a una y paginadas: quién (nunca en los anónimos, que además van solo con el día), sobre quién y el valor de cada pregunta.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación. La empresa tiene que tener el módulo de formularios activado (si no, 403). A nombre de una persona, como en el panel: administración y RRHH; los confidenciales, solo RRHH y quien los creó.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
formularioIdstringobligatorio | El formulario. |
desdestringopcional | YYYY-MM-DD, incluido. |
hastastringopcional | YYYY-MM-DD, incluido. |
sobrestringopcional | Solo las que son sobre esa persona. |
incluir_respuestasboolopcional | También una a una. |
paginaintopcional | Por defecto 1. |
por_paginaintopcional | Por defecto 100, máximo 500. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/forms/aBc123XyZ/responses' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET'
<?php
$ch = curl_init('https://api.afer.pro/api/v1/forms/aBc123XyZ/responses');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/forms/aBc123XyZ/responses', {
method: 'GET',
headers: {
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
}
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"formulario": {
"formularioId": "aBc123…",
"titulo": "Satisfacción de clientes · octubre"
},
"resumen": {
"total_respuestas": 37,
"por_dia": [
{
"dia": "2026-10-20",
"respuestas": 12
}
],
"preguntas": [
{
"texto": "¿Qué probabilidad hay de que nos recomiendes?",
"tipo": "escala",
"respuestas": 37,
"media": 8.4,
"nps": {
"nps": 41,
"promotores": 20,
"pasivos": 10,
"detractores": 7
}
}
]
}
}
}