# List or filter all FormSubmission activities

GET https://api.close.com/api/v1/activity/form_submission/

Get a list of matching FormSubmission activities. In addition to standard Activity filtering parameters, you can filter by specific form(s) using the `form_id` or `form_id__in` parameters.

Reference: https://developer.close.com/api/resources/activities/form-submissions/list

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: Close API
  version: 1.0.0
paths:
  /activity/form_submission/:
    get:
      operationId: list
      summary: List or filter all FormSubmission activities
      description: >-
        Get a list of matching FormSubmission activities. In addition to
        standard Activity filtering parameters, you can filter by specific
        form(s) using the `form_id` or `form_id__in` parameters.
      tags:
        - subpackage_activitiesFormSubmissions
      parameters:
        - name: _limit
          in: query
          description: Number of results to return.
          required: false
          schema:
            type: integer
            default: 100
        - name: _skip
          in: query
          description: Number of results to skip before returning, for pagination.
          required: false
          schema:
            type: integer
            default: 0
        - name: id__in
          in: query
          description: Filter by activity IDs (comma-separated)
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: lead_id
          in: query
          description: Filter by lead IDs (comma-separated)
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: contact_id
          in: query
          description: Filter by contact IDs (comma-separated)
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: user_id
          in: query
          description: Filter by user IDs (comma-separated)
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: organization_id
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: _type
          in: query
          description: Filter by activity type, e.g. Call (comma-separated)
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: date_created__gte
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersDateCreatedGte
        - name: date_created__lte
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersDateCreatedLte
        - name: date_created__gt
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersDateCreatedGt
        - name: date_created__lt
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersDateCreatedLt
        - name: activity_at__gte
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersActivityAtGte
        - name: activity_at__lte
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersActivityAtLte
        - name: activity_at__gt
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersActivityAtGt
        - name: activity_at__lt
          in: query
          required: false
          schema:
            $ref: >-
              #/components/schemas/ActivityFormSubmissionGetParametersActivityAtLt
        - name: lead_id__in
          in: query
          required: false
          schema:
            type: string
        - name: user_id__in
          in: query
          required: false
          schema:
            type: string
        - name: contact_id__in
          in: query
          required: false
          schema:
            type: string
        - name: _type__in
          in: query
          required: false
          schema:
            type: string
        - name: form_id
          in: query
          description: Filter by a specific form ID.
          required: false
          schema:
            type:
              - array
              - 'null'
            items:
              type: string
        - name: form_id__in
          in: query
          description: Filter by multiple form IDs (comma-separated).
          required: false
          schema:
            type: string
        - name: _fields
          in: query
          description: Comma-separated list of fields to include in the response.
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Basic authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/activities.form_submissions_list_Response_200
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                description: Any type
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Not found
          content:
            application/json:
              schema:
                description: Any type
servers:
  - url: https://api.close.com/api/v1
components:
  schemas:
    ActivityFormSubmissionGetParametersDateCreatedGte:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersDateCreatedGte
    ActivityFormSubmissionGetParametersDateCreatedLte:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersDateCreatedLte
    ActivityFormSubmissionGetParametersDateCreatedGt:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersDateCreatedGt
    ActivityFormSubmissionGetParametersDateCreatedLt:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersDateCreatedLt
    ActivityFormSubmissionGetParametersActivityAtGte:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersActivityAtGte
    ActivityFormSubmissionGetParametersActivityAtLte:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersActivityAtLte
    ActivityFormSubmissionGetParametersActivityAtGt:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersActivityAtGt
    ActivityFormSubmissionGetParametersActivityAtLt:
      oneOf:
        - type: string
          format: date-time
        - type: string
          format: date
      title: ActivityFormSubmissionGetParametersActivityAtLt
    FormSubmissionActivityValues:
      oneOf:
        - type: string
        - type: boolean
      title: FormSubmissionActivityValues
    FormSubmissionActivityValuesByName:
      oneOf:
        - type: string
        - type: boolean
      title: FormSubmissionActivityValuesByName
    FormSubmissionActivity:
      type: object
      properties:
        _type:
          type: string
        activity_at:
          type:
            - string
            - 'null'
          format: date-time
        contact_id:
          type:
            - string
            - 'null'
        created_by:
          type:
            - string
            - 'null'
        created_by_name:
          type:
            - string
            - 'null'
        date_created:
          type: string
          format: date-time
        date_updated:
          type: string
          format: date-time
        form_configuration_id:
          type: string
        form_id:
          type: string
        form_name:
          type:
            - string
            - 'null'
        id:
          type: string
        ip_address:
          type:
            - string
            - 'null'
        lead_id:
          type:
            - string
            - 'null'
        organization_id:
          type: string
        origin:
          type:
            - string
            - 'null'
        source_url:
          type:
            - string
            - 'null'
        source_url_normalized:
          type:
            - string
            - 'null'
        updated_by:
          type:
            - string
            - 'null'
        updated_by_name:
          type:
            - string
            - 'null'
        user_id:
          type:
            - string
            - 'null'
        user_name:
          type:
            - string
            - 'null'
        users:
          type: array
          items:
            type: string
        values:
          type: object
          additionalProperties:
            oneOf:
              - $ref: '#/components/schemas/FormSubmissionActivityValues'
              - type: 'null'
        values_by_name:
          type: object
          additionalProperties:
            oneOf:
              - $ref: '#/components/schemas/FormSubmissionActivityValuesByName'
              - type: 'null'
      required:
        - _type
        - activity_at
        - contact_id
        - created_by
        - date_created
        - date_updated
        - form_configuration_id
        - form_id
        - id
        - ip_address
        - lead_id
        - organization_id
        - origin
        - source_url
        - source_url_normalized
        - updated_by
        - user_id
        - users
        - values
        - values_by_name
      title: FormSubmissionActivity
    activities.form_submissions_list_Response_200:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/FormSubmissionActivity'
        has_more:
          type: boolean
      required:
        - data
        - has_more
      title: activities.form_submissions_list_Response_200
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: basic
    OAuth2:
      type: http
      scheme: bearer

```