formcarry-com api API

openapi: 3.1.0
info:
  title: formcarry-com api API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 6 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; formcarry-com has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 22
    documentation: -11
    pages-with-code: 22
    pages-read: 22
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://formcarry.com/docs/api/legacy/forms
  - https://formcarry.com/docs/api/legacy/overview
  - https://formcarry.com/docs/api/overview
  x-docs-section: api
servers:
- url: https://api.formcarry.com
paths:
  /api/form:
    put:
      operationId: put_api_form
      tags:
      - Api
      summary: PUT /api/form
      x-source: https://formcarry.com/docs/api/legacy/forms
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutApiFormRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X PUT https://formcarry.com/api/form  -H \"api_key: YOUR_API_KEY\"  -H \"Content-Type: application/json\"  -d '{\"title\"\
          : \"Contact Form\"}' \n The response contains the new form’s ID, which you use as the endpoint for submissions. \n ​ Delete a form \n\
          \ DELETE https://formcarry.com/api/form/{formId} \n Permanently deletes a form and all of its submissions. This action cannot be undone.\
          \ \n ​ Path paramet"
  /api/form/{formid}:
    delete:
      operationId: delete_api_form_formid
      tags:
      - Api
      summary: DELETE /api/form/{formId}
      x-source: https://formcarry.com/docs/api/legacy/forms
      parameters:
      - name: formid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X DELETE https://formcarry.com/api/form/YOUR_FORM_ID  -H \"api_key: YOUR_API_KEY\" \n Was this page helpful? Yes No Legacy\
          \ API Authentication Previous Legacy Submissions API — List and Filter Submissions Next ⌘ I website Powered by This documentation is\
          \ built and hosted on Mintlify, a developer documentation platform On this page Back to top Create a form Headers Body Example Delete\
          \ a form Path"
  /api/form/{formid}/submissions:
    get:
      operationId: get_api_form_formid_submissions
      tags:
      - Api
      summary: GET /api/form/{formId}/submissions
      x-source: https://formcarry.com/docs/api/legacy/overview
      parameters:
      - name: formid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://formcarry.com/api/form/FORM_ID/submissions  -H \"api_key: YOUR_API_KEY\" \n See Authentication for how to obtain\
          \ a key. \n ​ Endpoints \n PUT /api/form — create a form (see Forms ) \n DELETE /api/form/{formId} — delete a form \n GET /api/form/{formId}/submissions\
          \ — list submissions with page-based pagination (see Submissions ) \n ​ Migrating to v1 \n The v1 API at api.formcarry.com uses Bearer"
  /v1/forms:
    get:
      operationId: get_v1_forms
      tags:
      - Forms
      summary: GET /v1/forms
      x-source: https://formcarry.com/docs/api/overview
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FormsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \"https://api.formcarry.com/v1/forms?limit=50\"  -H \"Authorization: Bearer fc_live_your_api_key\" \n To fetch the next\
          \ page, send the returned next_cursor back as the cursor parameter. \n ​ Errors \n The API returns a unified error envelope with a machine-readable\
          \ code and a human-readable message . Every error response carries request_id , and every response carries an X-Request-Id header, which\
          \ F"
  /v1/forms/{formId}/submissions:
    get:
      operationId: get_v1_forms_formId_submissions
      tags:
      - Forms
      summary: Formcarry API Overview
      description: Read, filter, and manage submissions on a form.
      x-source: https://formcarry.com/docs/api/overview
      parameters:
      - name: formId
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of submissions to return per page.
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Cursor for pagination to fetch the next page.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FormsFormidSubmissionsResponse'
      x-evidence:
        kind: documentation
  /v1/me:
    get:
      operationId: get_v1_me
      tags:
      - Me
      summary: GET /v1/me
      x-source: https://formcarry.com/docs/api/overview
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1MeResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.formcarry.com/v1/me  -H \"Authorization: Bearer fc_live_your_api_key\" \n See Authentication for details on\
          \ generating keys, scopes, and verifying credentials. \n ​ Common resources \n Forms Create, list, update, and delete forms in your\
          \ workspace. Submissions Read, filter, and manage submissions on a form. Email notifications Manage self-email recipients and connected\
          \ email servers. W"
security:
- bearer: []
components:
  schemas:
    PutApiFormRequest:
      type: object
      properties:
        title:
          type: string
    GetV1FormsResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
    GetV1FormsFormidSubmissionsResponse:
      type: object
      properties:
        next_cursor:
          type: string
          description: Cursor to retrieve the next page of results, if more results are available.
    GetV1MeResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Api
- name: Forms
- name: Me