Skip to main content
Every investor and key party has two identifiers: one you choose, and one Securitize returns. They are not interchangeable. Store investorId and every keyPartyId against your own records as soon as you receive them.
Every path that names an investor takes Securitize’s investorId, never your externalInvestorId. Your own id in a path answers 404 investor_not_found.

Your identifier format

externalInvestorId and externalKeyPartyId match ^[A-Za-z0-9._-]{1,128}$: letters, digits, ., _ and -, up to 128 characters. Use the id your own system already has for the record.

Tax and registration identifiers

Securitize also recognises an investor by who it is:
  • a person by taxId plus taxCountry;
  • a company by its registration number and country, entityIdNumber plus address.countryCode.
They are required on create and on correction. Send the real value; placeholders such as 000000000, 123456789, TEST or N/A are refused, with or without separators (123-45-6789 too).

Repeating a create

A create is safe to repeat. Sending the same body again (the same externalInvestorId, email and data as last stored, by the create or a later correction) answers 201 with the same investorId and the investor’s current status. Use it when a create timed out or answered 502: it also finishes a registration left incomplete. Key-party creates work the same way and return the same keyPartyId. A create answers 409 external_investor_id_conflict, with the existing investorId in details, when:
  • the externalInvestorId is already yours with different data: correct the investor with PUT instead;
  • the tax or registration identifiers belong to an investor you already created under another externalInvestorId: use that investor.
A key-party create with an externalKeyPartyId already used on the entity, with different data, answers 409 external_key_party_id_conflict with the keyPartyId in details.

When the investor already exists

If the person or company is already registered with Securitize and another party leads its verification, your create answers 200 with only investorId, externalInvestorId and status. Store the investorId. You have limited access to that investor: What you cannot do answers 409 investor_not_owned. Its status may already be verified.

Recovering a lost id