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

# Get All Submissions

> Get All Submissions.



## OpenAPI

````yaml GET /forms/submissions/getAll
openapi: 3.1.0
info:
  title: Blog API
  version: 1.0.0
servers:
  - url: https://api.octaviatech.app/cms
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Tags
    description: Tag management endpoints
paths:
  /forms/submissions/getAll:
    get:
      tags:
        - Form Submissions
      summary: Get all submissions for the tenant
      description: >-
        Lists submissions across every form in the calling tenant (not scoped to
        a single form),

        newest first, with the owning form's title, slug and type joined onto
        each row.

        Requires the `form.submission.read` permission. Callers whose role is
        `WRITER` (5) are

        automatically restricted to submissions on forms they created; a WRITER
        whose identity

        cannot be resolved is rejected with 401. Soft-deleted submissions are
        always excluded.
      parameters:
        - in: query
          name: page
          description: Page index (1-based). Defaults to 1.
          schema:
            type: integer
            example: 1
            minimum: 1
        - in: query
          name: limit
          description: Items per page. Defaults to 10.
          schema:
            type: integer
            example: 10
            minimum: 1
        - in: query
          name: status
          description: >-
            Comma-separated list of statuses to include. Unrecognised names are
            dropped; omit for all.
          schema:
            type: string
            example: pending,approved
        - in: query
          name: lang
          description: >-
            Comma-separated list of language codes, matched against the
            submission's stored `language`.
          schema:
            type: string
            example: en,fa
        - in: query
          name: from
          description: Lower bound on `createdAt`. Unparsable values are ignored.
          schema:
            type: string
            format: date-time
            example: '2025-09-01T00:00:00.000Z'
        - in: query
          name: to
          description: >-
            Upper bound on `createdAt`; a date-only value is extended to
            23:59:59.999 of that day. Unparsable values are ignored.
          schema:
            type: string
            format: date-time
            example: '2025-09-30T23:59:59.999Z'
        - in: query
          name: formType
          description: >-
            Only include submissions whose parent form has this `formType`.
            Values outside the FormType enum are ignored.
          schema:
            type: string
            enum:
              - public
              - internal
            example: internal
        - in: query
          name: formName
          description: >-
            Case-insensitive filter matched against the parent form's `slug` or
            any of its title values.
          schema:
            type: string
            example: contact
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                success: true
                statusCode: 200
                message: Tenant submissions list retrieved successfully
                data:
                  submissions:
                    - _id: '{{objectId}}'
                      tenantId: '{{objectId}}'
                      formId: '{{objectId}}'
                      values:
                        fullName: John Doe
                        email: john@example.com
                      relations: []
                      language: en
                      status: 0
                      isDeleted: false
                      submittedAt: '2025-10-01T12:00:00.000Z'
                      createdAt: '2025-10-01T12:00:00.000Z'
                      updatedAt: '2025-10-01T12:00:00.000Z'
                      formTitle:
                        en: Contact us
                      formSlug: contact-us
                      formType: internal
                  pagination:
                    total: 1
                    page: 1
                    limit: 10
                    totalPages: 1
        '400':
          description: Bad request (missing or invalid x-tenant-id, or missing x-user-id)
          content:
            application/json:
              example:
                success: false
                statusCode: 400
                message: x-tenant-id is required
                data: null
        '401':
          description: >-
            Unauthorized (no user id resolved, e.g. a WRITER caller without a
            valid identity)
          content:
            application/json:
              example:
                success: false
                statusCode: 401
                message: User identity is required for writer access
                data: null
        '403':
          description: >-
            Forbidden (tenant mismatch or missing the `form.submission.read`
            permission)
          content:
            application/json:
              example:
                success: false
                statusCode: 403
                message: 'Access denied. Required permission(s): form.submission.read'
                data: null
        '404':
          description: Not found (user referenced by the token does not exist)
          content:
            application/json:
              example:
                success: false
                statusCode: 404
                message: User not found for provided token
                data: null
        '500':
          description: Server error
          content:
            application/json:
              example:
                success: false
                statusCode: 500
                message: Server Error
                data: null
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````