v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-08232554.8 KB
Investors

Bulk create investors

Creates one or more partner-managed investor records. Always returns 200 with a per-row { status, zestPersonId | error } result keyed by partnerInvestorId. Idempotent across replays: a repeated partnerInvestorId returns the existing Zest person id. Idempotency-Key is optional and provides response-level caching.

post/v1/investors

Headers

Idempotency-Keystring

Request body

Example request

{
  "investors": [
    {
      "partnerInvestorId": "monark-inv-7341",
      "email": "alice@example.com",
      "firstName": "Alice",
      "lastName": "Liddell",
      "dateOfBirth": "1985-04-12",
      "countryOfResidence": "AE"
    }
  ]
}

Response

Successful Response