Investors

Create investor

Register a new investor with the platform.

The investor is always created with status pending-onboarding-workflow while compliance checks (PEP/sanctions screening) run asynchronously.
Once checks complete successfully, the investor is automatically transitioned to active (if the distributor has KYC reliance enabled). The distributor is notified of the status change via webhook.

Tax residence:

Individual investors must provide a taxIdentificationNumber for every country of tax residence outside France.

Related persons requirements:

Each related person must include dateOfBirth, nationality, and countryOfResidence (required for compliance screening).
Organization investors must provide all their UBOs and directors. FR organizations are exempt (persons are automatically fetched from INPI), unless the distributor operates under a KYC reliance agreement with Spiko in which case all UBOs and directors must be provided regardless of country.
For passive NFE investors (fatcaCrsStatus: "passiveNFE"), non-FR UBOs must include a fiscalIdentificationNumber.

FATCA/CRS status:

Organization investors must provide a fatcaCrsStatus in the details object. When set to passiveNFE, non-FR UBOs must include a fiscalIdentificationNumber.

post/v1/investors

Request

Base URL
https://distributor-api.spiko.io
Auth
HTTP basic
TypeScript
https://skmtc.dev/spiko/apis/spiko-distributor-api/docs/v1/investors/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

firstNamestring required

Legal representative first name (for organizational investors)

lastNamestring required

Legal representative last name (for organizational investors)

country'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' required

alpha-2 country code (ISO 3166-1)

addressstring required

Registered legal address (for organizational investors)

zipCodestring required

citystring required

allowedByDistributorShareClassesShareClassSymbol[]

Restricts the investor to this subset of the share classes you distribute. Omit it to give the investor your full range, which is the default. Share classes you do not distribute are rejected.

investorEmailstring

Email address of the investor. Mandatory for distributors using the Spiko License model.

Example request

{
  "country": "FR",
  "details": {
    "nationality": "FR"
  },
  "relatedPersons": [
    {
      "countryOfBirth": "FR",
      "nationality": "FR",
      "countryOfResidence": "FR"
    }
  ]
}

Response

Success

firstNamestring required

Legal representative first name (for organizational investors)

lastNamestring required

Legal representative last name (for organizational investors)

alpha-2 country code (ISO 3166-1)

addressstring required

Registered legal address (for organizational investors)

zipCodestring required

citystring required

idstring uuid required

a Universally Unique Identifier

distributorIdstring uuid required

a Universally Unique Identifier

createdOnstring required

A valid date within the range 2020-2100

updatedOnstring required

A valid date within the range 2020-2100

status'pending-onboarding-workflow' required

complianceStatus'pending-onboarding' required

allowedByDistributorShareClassesShareClassSymbol[] nullable

The share classes this investor may access, or null when they may access every share class you distribute.

Example response

{
  "country": "FR",
  "details": {
    "taxInformationByCountryOfResidence": [
      {
        "country": "FR"
      }
    ]
  },
  "relatedPersons": [
    {
      "countryOfBirth": "FR",
      "nationality": "FR",
      "countryOfResidence": "FR"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.