> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Obtenir les analyses de formulaire par question
> GET /forms/{form_id}/analytics/questions/
Renvoie la façon dont chaque question d'un formulaire a été renseignée, dans l'ordre des questions du formulaire : combien de réponses y ont répondu, quelle part des réponses cela représente et — pour les questions à choix, de notation et d'échelle — combien de fois chaque réponse a été donnée.
Nécessite une clé d'API de gestion avec le quota `MANAGEMENT_API` (ou `MANAGEMENT_API_SANDBOX`) et la permission `LEAD_GENERATION_ANALYTICS_CAN_VIEW`, envoyée comme valeur brute de l'en-tête `Authorization` — voir la [présentation de l'API de gestion](/fr/api-reference/management-api/overview).
Le `form_id` du formulaire.
Ne compte que les réponses reçues à cette date ou après (`YYYY-MM-DD`).
Ne compte que les réponses reçues à cette date ou avant (`YYYY-MM-DD`).
Ne compte que les réponses soumises via ce code QR (son `qrid`).
```bash cURL theme={null}
curl --request GET \
--url 'https://api.scanova.io/forms/F8a9b0c1d2e3f4g5h/analytics/questions/?from=2026-08-01&to=2026-08-31' \
--header 'Authorization: YOUR_API_KEY'
```
```json 200 theme={null}
[
{ "question": "Name", "type": "shortAnswer", "answered": 38, "response_rate": 100.0 },
{
"question": "Where would you like to sit?",
"type": "multipleChoice",
"answered": 30,
"response_rate": 78.9,
"distribution": [
{ "label": "Terrace", "count": 21 },
{ "label": "Inside", "count": 9 },
{ "label": "Bar", "count": 0 }
]
},
{
"question": "How was your last visit?",
"type": "starRating",
"answered": 25,
"response_rate": 65.8,
"distribution": [
{ "label": "5", "count": 14 },
{ "label": "4", "count": 8 },
{ "label": "3", "count": 3 }
]
}
]
```
* `response_rate` exprime `answered` en pourcentage des réponses reçues par le formulaire sur la période, arrondi à une décimale. Les soumissions omises ne sont pas des réponses et ne sont pas comptées.
* `distribution` n'apparaît que pour les questions à choix (`multipleChoice`, `checkbox`, `dropdown`), les notations (`starRating`, `emoji`, `likeDislike`) et les échelles (`linearScale`, `number`). Pour les questions à choix, toutes les options sont listées, y compris celles que personne n'a choisies, de la plus choisie à la moins choisie. Une réponse `checkbox` compte une fois pour chaque option cochée.
* Les blocs de contenu purement affichés ne sont pas des questions et n'apparaissent pas.
## Voir aussi
* [Obtenir les analyses de formulaire](/fr/api-reference/management-api/forms/analytics) — les totaux de réponses et d'omissions dans le temps, et les réponses par source.
* [Lister les réponses de formulaire](/fr/api-reference/management-api/forms/responses-list) — les soumissions individuelles derrière ces chiffres.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et l'architecture de quotas dont fait partie cet endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json GET /forms/{form_id}/analytics/questions/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
shared users & roles), plus the token-creation and usage-stats endpoints
used to authenticate against it. Every path and request/response shape below
was verified live against a real API key and the actual running backend
(Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://api.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/forms/{form_id}/analytics/questions/:
get:
summary: Get per-question form analytics
operationId: getManagedFormQuestionAnalytics
parameters:
- name: form_id
in: path
required: true
schema:
type: string
description: The form's `form_id`.
- name: from
in: query
schema:
type: string
format: date
description: Only responses on or after this date (`YYYY-MM-DD`).
- name: to
in: query
schema:
type: string
format: date
description: Only responses on or before this date (`YYYY-MM-DD`).
- name: qr_code_id
in: query
schema:
type: string
description: Only responses submitted through this QR Code (`qrid`).
responses:
'200':
description: One entry per question, in the form's question order.
content:
application/json:
schema:
type: array
items:
type: object
properties:
question:
type: string
type:
type: string
answered:
type: integer
response_rate:
type: number
distribution:
type: array
items:
type: object
properties:
label:
type: string
count:
type: integer
'404':
description: No form with this `form_id` in the account.
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Send your Management API key as the raw value of the Authorization
header — no "Bearer " or "Token " prefix, and no other characters.
Example: `Authorization: YOUR_API_KEY`. A header containing more than
one space-separated part is rejected outright. Requests also require the
request's Host header to be the management API host (e.g.
api.scanova.io) — the same key sent to the regular API host will not
authenticate.
````