> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replo.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get totals per question for a form

> **Beta** — this endpoint may change before general availability.



## OpenAPI

````yaml /api-reference/openapi.json get /forms/{formId}/summary
openapi: 3.1.0
info:
  title: Replo Public API
  version: '2026-11-10'
servers:
  - url: https://api.replo.app/v1
security: []
paths:
  /forms/{formId}/summary:
    get:
      tags:
        - Forms
      summary: Get totals per question for a form
      description: '**Beta** — this endpoint may change before general availability.'
      operationId: forms.getSummary
      parameters:
        - name: Replo-Api-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2026-11-10'
          description: The public API version to use for this request.
        - schema:
            type: string
            format: uuid
            description: The form's id, from replo_forms_list
          required: true
          description: The form's id, from replo_forms_list
          name: formId
          in: path
        - schema:
            type: string
            format: uuid
            description: The project that owns the forms, from list_projects
          required: true
          description: The project that owns the forms, from list_projects
          name: projectId
          in: query
      responses:
        '200':
          description: Get totals per question for a form
          content:
            application/json:
              schema:
                type: object
                properties:
                  formId:
                    type: string
                    format: uuid
                  totalResponses:
                    type: integer
                    description: Every response the form has
                  summarizedResponses:
                    type: integer
                    description: >-
                      The responses the totals count: the latest 10,000 when the
                      form has more
                  fields:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - choice
                            fieldType:
                              type: string
                              enum:
                                - select
                                - checkbox
                                - consent
                            fieldKey:
                              type: string
                            label:
                              type: string
                            answered:
                              type: integer
                              description: Responses that answered it
                            counts:
                              type: array
                              items:
                                type: object
                                properties:
                                  option:
                                    type: string
                                  count:
                                    type: integer
                                required:
                                  - option
                                  - count
                              description: >-
                                One row per option, in the form's order;
                                checkbox and consent use "true" and "false"
                          required:
                            - kind
                            - fieldType
                            - fieldKey
                            - label
                            - answered
                            - counts
                        - type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - numeric
                            fieldType:
                              type: string
                              enum:
                                - number
                                - rating
                            fieldKey:
                              type: string
                            label:
                              type: string
                            answered:
                              type: integer
                              description: Responses that answered it
                            average:
                              type:
                                - number
                                - 'null'
                            min:
                              type:
                                - number
                                - 'null'
                            max:
                              type:
                                - number
                                - 'null'
                            histogram:
                              type:
                                - array
                                - 'null'
                              items:
                                type: object
                                properties:
                                  value:
                                    type: integer
                                  count:
                                    type: integer
                                required:
                                  - value
                                  - count
                              description: >-
                                Ratings only: one row for every value from 1 to
                                the scale
                          required:
                            - kind
                            - fieldType
                            - fieldKey
                            - label
                            - answered
                            - average
                            - min
                            - max
                            - histogram
                        - type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - text
                            fieldType:
                              type: string
                              enum:
                                - text
                                - textarea
                                - email
                                - phone
                                - hidden
                                - file
                            fieldKey:
                              type: string
                            label:
                              type: string
                            answered:
                              type: integer
                              description: Responses that answered it
                            samples:
                              type: array
                              items:
                                type: object
                                properties:
                                  submissionId:
                                    type: string
                                    format: uuid
                                  value:
                                    type: string
                                  createdAt:
                                    type: string
                                required:
                                  - submissionId
                                  - value
                                  - createdAt
                              maxItems: 5
                              description: The latest answers, newest first; files by name
                          required:
                            - kind
                            - fieldType
                            - fieldKey
                            - label
                            - answered
                            - samples
                        - type: object
                          properties:
                            kind:
                              type: string
                              enum:
                                - date
                            fieldType:
                              type: string
                              enum:
                                - date
                            fieldKey:
                              type: string
                            label:
                              type: string
                            answered:
                              type: integer
                              description: Responses that answered it
                            earliest:
                              type:
                                - string
                                - 'null'
                              pattern: ^\d{4}-\d{2}-\d{2}$
                              description: A calendar date, YYYY-MM-DD
                            latest:
                              type:
                                - string
                                - 'null'
                              pattern: ^\d{4}-\d{2}-\d{2}$
                              description: A calendar date, YYYY-MM-DD
                          required:
                            - kind
                            - fieldType
                            - fieldKey
                            - label
                            - answered
                            - earliest
                            - latest
                      description: Totals for one question, computed from saved responses
                    description: Every answerable question, in the form's order
                  object:
                    type: string
                    enum:
                      - form_summary
                required:
                  - formId
                  - totalResponses
                  - summarizedResponses
                  - fields
                  - object
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '401':
          description: >-
            Missing or invalid Replo Public API token. Send an active key as
            `Authorization: Bearer replo_sk_...`; if it was revoked, create a
            new key in Replo Settings.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '403':
          description: >-
            You are not authorized to access this resource. Ask a workspace
            owner to perform this action or to grant the key's creator access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '404':
          description: >-
            Not Found. The resource may not exist, this key may lack the
            required scope, or the key's creator may have lost access. Check the
            key's scopes in Replo Settings and the creator's project or
            workspace access; a workspace owner can grant access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '409':
          description: The resource is in a conflicting state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '413':
          description: File content exceeds the 10 MiB limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '429':
          description: >-
            Too many requests. Please retry after the time indicated by the
            Retry-After header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '500':
          description: An internal error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '503':
          description: Service temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
      security:
        - bearerAuth: []
components:
  schemas:
    PublicApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            doc_url:
              type: string
            issues:
              type: array
              items:
                type: object
                properties:
                  param:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Dotted path to the failing field within the request body,
                      query or path, e.g. "name" or "variants.0.available"; null
                      when the rule covers the whole input.
                  message:
                    type: string
                    description: Why the field was rejected.
                required:
                  - param
                  - message
              description: >-
                Present on an invalid_request whose input failed validation:
                each failing field and why, at most 10.
          required:
            - code
            - message
            - doc_url
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.