Sokin Embedded API
    Sokin Embedded API
    • Getting Started
      • Sokin Definitions
      • Guides
        • Authentication
        • Receiving Payments
        • FX Payments
        • Payments
        • Unfunded Payments
        • Unfunded FX Payments
        • Corporate Onboarding
          • Data Requirements
          • Step 1: Create a corporate profile
          • Step 2: Add associates
          • Step 3: Add a parent entity (if applicable)
          • Step 4: Upload company documents
          • Step 5: Upload associate documents
          • Real-time Status Updates via Webhook
          • Conditional Step: Upload Parent Entity documents (if applicable)
          • Step 6: Finalise onboarding submission
          • Uploading supporting documents using Pre-signed URLs
          • Onboarding Reference Data
          • Onboarding Models
            • Data-Only model
            • Supported Jurisdictions & National ID Requirements
        • Payments Reference Data
          • Purpose of Payment
          • Transfer Reasons
          • Beneficiary Fields
    • Authentication
      • Get Token
      • Get Token on behalf of corporate
      • Schemas
        • TokenResponse
    • Corporates
      • v2025-12-01
        • Create a new Corporate
        • Add a parent entity (corporate associate) to an onboarding request
        • Add an associate to a corporate onboarding request
        • Request pre-signed URLs for onboarding document uploads
        • Request pre-signed URLs for parent entity document uploads
        • Request pre-signed URLs for associate document uploads
        • Finalise corporate onboarding submission
      • Schemas
        • NumericRange
        • ApiResponse[AddIndividualAssociateResponse]
        • ApiResponse[AddAssociateDocumentsResponse]
        • ApiResponse[AddOnboardingDocumentsResponse]
        • AddOnboardingDocumentsResponse
        • AssociateDocumentPresignedUrlResponse
        • AssociateType
        • ErrorResponse
        • MessageResponse
        • FinaliseSubmissionResponse
        • AddParentEntityRequest
        • MoneyRange
        • AddOnboardingDocumentsRequest
        • ApiResponse[CreateCorporateResponse]
        • CreateCorporateRequest
        • CreateCorporateResponse
        • FinaliseSubmissionRequest
        • PresignedUrlResponse
        • AddressTypeEnum
        • OwnershipType
        • AddAssociateDocumentsResponse
        • ErrorDetail
        • AddIndividualAssociateRequest
        • UboDetails
        • AddParentEntityResponse
        • AddIndividualAssociateResponse
        • CorporateAssociateType
        • AddParentEntityDocumentsRequest
        • AssociateDocumentPresignedUrlResponseItem
        • ApiResponse[AddParentEntityResponse]
        • AssociateIdentityType
        • AddAssociateDocumentsRequest
    • Corporate Currency Accounts
      • v2025-12-01
        • Get Corporate Currency Accounts
        • Get Corporate Currency Account By Reference
      • Schemas
        • ErrorResponse
        • PaginationInfo
        • ErrorDetail
        • ApiResponse[GetCCAByReferenceResponse]
        • GetCCAByReferenceResponse
        • GetCCAByReferenceResponsePayInDetail
        • GetCCAsResponseItem
        • PaginatedApiResponse[GetCCAsResponseItem]
    • Beneficiaries
      • v2025-12-01
        • Get Beneficiary Fields
        • Create External Beneficiary
        • Get Beneficiary List
        • Get Beneficiary Details
        • Delete Beneficiary
      • Schemas
        • ErrorResponse
        • FieldType
        • IdentifierType
        • TransactionTypeEnum
        • BeneficiaryType
        • AccountType
        • ApiResponse[BeneficiaryDetails]
        • ApiResponse[CreateExternalBeneficiaryData]
        • ApiResponse[DeleteBeneficiaryData]
        • ApiResponse[GetBeneficiaryFieldsResponse]
        • BeneficiaryField
        • BeneficiaryListItem
        • CreateExternalBeneficiaryData
        • CreateExternalBeneficiaryRequest
        • DeleteBeneficiaryData
        • GetBeneficiaryFieldsResponse
        • PaginatedApiResponse[BeneficiaryListItem]
        • StateOrProvince
        • PaginationInfo
        • PaginatedBeneficiaryFieldsResponse
        • ErrorDetail
        • BeneficiaryDetails
    • Instruction Requests
      • v2025-12-01
        • Get Instruction Request By Reference
        • Create Payment Instruction Request
        • Create Fx Instruction Request
        • Create Fx Payment Instruction Request
        • Create Unfunded Payment Instruction Request
        • Create Unfunded Fx Payment Instruction Request
      • Schemas
        • ErrorResponse
        • ApiResponse[CreateInstructionRequestResponse]
        • ErrorDetail
        • ApiResponse[GetInstructionRequestResponse]
        • CreateFXInstructionRequest
        • CreateFxPaymentInstructionRequest
        • CreateInstructionRequestResponse
        • CreatePaymentInstructionRequest
        • CreateUnfundedFxPaymentInstructionRequest
        • CreateUnfundedPaymentInstructionRequest
        • GetInstructionRequestResponse
    • Instructions
      • v2025-12-01
        • Get Instruction By Reference
      • Schemas
        • ErrorDetail
        • ErrorResponse
        • ApiResponse[GetInstructionResponse]
        • GetInstructionResponse
    • Foreign Exchange
      • v2025-12-01
        • Get Fx Rate
      • Schemas
        • ErrorResponse
        • FxRateData
        • FixedSide
        • ApiResponse[FxRateData]
        • ErrorDetail
        • FxRateRequest
    • Webhooks
      • Webhooks
      • v2025-12-01
        • Create Subscription
        • Update Subscription Status
        • Update Subscription
        • Delete Subscription
        • Get Subscription By Id
        • List Notification Logs
        • Retry Notification
      • Schemas
        • ApiResponse[CreateSubscriptionResponse]
        • NotificationStatus
        • ApiResponse[NotificationLogList]
        • NotificationAttemptResponse
        • ApiResponse[UpdateSubscriptionResponse]
        • NotificationLogList
        • ErrorResponse
        • NotificationLogResponse
        • SubscriptionCreateOrUpdate
        • SubscriptionStatusUpdate
        • CreateSubscriptionResponse
        • UpdateSubscriptionResponse
        • InstructionCreated
        • ErrorDetail
        • InstructionReqeustRejected
        • InstructionProcessedWebhook
        • InstructionRejectedWebhook
        • OnboardingRequestApproved
        • OnboardingRequestRejected
        • CorporateActivated
        • CorporateDeactivated
        • CorporateCurrencyAccountFundingReceived
        • WebhookSubscription
        • WebhookNotificationLogs

    CreateCorporateRequest(CreateCorporateRequest)

    Request payload for creating a new corporate onboarding request.
    This model supports both new API-friendly formats (booleans, range objects)
    and legacy formats (Yes/No strings) for backward compatibility.

    {
        "corporateName": "Acme Technologies Ltd",
        "registrationId": "12345678",
        "dateOfIncorporation": "2020-01-15",
        "doingBusinessAs": "string",
        "natureOfBusiness": "62020",
        "taxNumber": "GB123456789",
        "website": "https://www.acme-tech.com",
        "corporateCategory": "LTD",
        "customerExpectedTransactionValue": {
            "currency": "USD",
            "max": 150000,
            "min": 1
        },
        "customerExpectedAmountVolume": {
            "max": 2,
            "min": 1
        },
        "outgoingTransactionValuePerYear": {
            "currency": "USD",
            "max": 150000,
            "min": 1
        },
        "yearsOfTrading": {
            "max": 2,
            "min": 1
        },
        "annualRevenue": {
            "currency": "USD",
            "max": 150000,
            "min": 1
        },
        "annualFxVolumeInUsd": {
            "currency": "USD",
            "max": 150000,
            "min": 1
        },
        "businessAddress": "123 Business Street",
        "country": "GB",
        "postalCode": "SW1A 1AA",
        "city": "London",
        "stateOrProvince": "string",
        "isSameOperatingAddress": true,
        "operatingAddress": "string",
        "operatingAddressCountry": "string",
        "operatingAddressPostalCode": "string",
        "operatingAddressCity": "string",
        "operatingAddressStateOrProvince": "string",
        "contactName": "John Smith",
        "corporateEmailAddress": "contact@acme-tech.com",
        "phoneNumber": "+441234567890",
        "notificationEmail": "string",
        "paymentQueriesContactName": "Jane Doe",
        "paymentQueriesEmailAddress": "payments@acme-tech.com",
        "paymentQueriesMobileNo": "+441234567891",
        "isExistingBankAccount": false,
        "bankAccountDetails": "string",
        "isDispute": false,
        "disputeDetails": "string",
        "isBankruptcy": false,
        "bankruptcyDetails": "string",
        "isRegulated": false,
        "regulatedDetails": "string",
        "anticipateReceivingPayment": "Clients/Customers, Vendors/Partners",
        "purposeOfReceivingPayment": "Sales revenue from customers",
        "anticipateSendingPayment": "Suppliers/Vendors/Partners, Employees",
        "purposeOfSendingPayment": "Supplier payments and payroll",
        "intendPaymentCountry": "GB, US, DE",
        "receivePaymentCountry": "GB, US, FR",
        "makeReceivePaymentCurrency": "GBP, USD, EUR",
        "sourceOfFunds": [
            "Inter-company payments",
            "Income from ongoing operations"
        ],
        "sourceOfFundsInfo": "Revenue from software licensing",
        "planToUseSokinServices": [
            "string"
        ],
        "otherPlan": "string",
        "briefBusinessDescription": "stringstringstringstringstringstringstringstringstringstring",
        "referenceId": "string"
    }
    Built with