---
title: "Submit an onboarding application"
method: POST
path: "/onboarding-applications"
tags: ["onboarding"]
---

# Submit an onboarding application

`POST /onboarding-applications`

Submits an onboarding application for compliance review. All referenced persons must already exist. The application is validated against the onboarding requirements for the given customer type.

## Request body

- SubmitOnboardingApplicationRequest
  - `authorities` OnboardingAuthoritySpec[], required — People authorized to act and their authority types.
    - `authority_type` 'owner' | 'joint_owner' | 'signatory' | 'power_of_attorney' | 'trading', required
    - `person` string, required
  - `consents` OnboardingConsentSpec[] — Consent declarations attached to the application.
    - `consent_type` union, required
      - 'investment_services_agreement' | 'risk_disclosures' | 'conflicts_of_interest_policy' | 'complaints_handling_policy' | 'client_assets_safeguarding_policy' | 'investor_compensation_fund_policy' | 'order_execution_policy' | 'costs_and_charges' | 'pccpc_prospectus' | 'pccpc_special_regulations' | 'pccpc_acceptance_declaration'
      - 'data_accuracy' — Self-declarations a person can make about a specific action or submission. An attestation is always recorded against a target resource (see `ConsentTargetType`) — for example, asserting data accuracy for an onboarding application the person is submitting. It does not reference a `LegalDocumentVersion`; the wording is implicit in the surrounding flow.
    - `consented_at` string, date-time, required
    - `legal_document_version` string, nullable
    - `person` string, required
  - `customer_type` 'individual' | 'joint' | 'business', required
  - `evidence` OnboardingEvidenceSpec[] — Evidence files attached to the application.
    - `document_type` 'passport' | 'national_id_front' | 'national_id_back' | 'driving_license' | 'driving_license_front' | 'driving_license_back' | 'utility_bill' | 'bank_statement' | 'tax_document' | 'shareholder_register' | 'share_certificate' | 'director_register' | 'board_minutes' | 'certificate_of_good_standing' | 'incumbency_certificate' | 'audited_accounts' | 'management_accounts' | 'ubo_declaration' | 'org_chart' | 'trust_deed' | 'nominee_agreement' | 'board_resolution'
    - `evidence_type` 'identity_document' | 'proof_of_address' | 'selfie' | 'certificate_of_shareholders' | 'certificate_of_directors' | 'certificate_of_good_standing' | 'financial_statements' | 'ownership_structure' | 'proof_of_registered_address' | 'proof_of_operating_address' | 'nominee_agreement' | 'board_resolution', required
    - `file` string, required
    - `person` string, required

## Response `201`

Created

- OnboardingApplicationResponse
  - `application` object, required — Submitted application data.
  - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
  - `customer_type` 'individual' | 'joint' | 'business', required
  - `id` string, required — Unique resource identifier.
  - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
  - `outcome` 'approved' | 'rejected' | 'expired'
  - `status` 'pending' | 'processing' | 'completed', required

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/revisions/5b4c43e2941b/schema)