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

# Submit an application



## OpenAPI

````yaml openapi/partner-openapi.yaml post /v1/onboarding/partner/applications/{applicationId}/submit
openapi: 3.1.0
info:
  description: >
    Partner-facing API for programmatic onboarding. Use these endpoints to
    create and

    manage onboarding applications on behalf of your customers, submit sections
    of data,

    upload supporting documents, and respond to Requests for Information (RFIs).


    ## Authentication

    All endpoints require a Bearer token obtained via the Circle key exchange.
    Include the

    token in the `Authorization: Bearer <token>` header.


    ## Idempotency

    All POST endpoints require an `X-Idempotency-Key` header. Provide a
    client-generated UUID v4

    with each POST request. If the same key is retried, the original response is
    returned without

    re-executing the operation. Omitting the header on a POST will result in a
    400 error.
  title: Circle Partner Onboarding API
  version: '2026-04-15'
servers:
  - description: Production
    url: https://api.circle.com
  - description: Sandbox
    url: https://api-sandbox.circle.com
security:
  - bearerAuth: []
paths:
  /v1/onboarding/partner/applications/{applicationId}/submit:
    post:
      tags:
        - Partner Applications
      summary: Submit an application
      operationId: submitApplication
      parameters:
        - description: Application UUID
          example: 550e8400-e29b-41d4-a716-446655440000
          in: path
          name: applicationId
          required: true
          schema:
            type: string
            format: uuid
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerSubmitRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
          description: Submission result
        '401':
          description: Authentication required
        '403':
          description: Insufficient permissions
        '404':
          description: Application not found
        '409':
          description: Application is not in a submittable state
components:
  parameters:
    IdempotencyKey:
      description: >
        Client-generated UUID used to safely retry POST requests. If the same
        key is submitted twice, the original response is returned without
        re-executing the operation. Must be a valid UUID v4 (e.g.
        `550e8400-e29b-41d4-a716-446655440099`).
      in: header
      name: X-Idempotency-Key
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    PartnerSubmitRequest:
      type: object
      properties:
        certificationIds:
          type: array
          items:
            type: string
            format: uuid
        endUserAgreesToTermsOfService:
          type: boolean
        endUserIpAddress:
          type: string
          maxLength: 39
          minLength: 7
      required:
        - endUserAgreesToTermsOfService
        - endUserIpAddress
    SubmitResponse:
      type: object
      properties:
        applicationId:
          type: string
          format: uuid
        status:
          type: string
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: Bearer token obtained via Circle key exchange
      scheme: bearer
      type: http

````