---
title: Register Investor
slug: register-investor
icon: {"apiMethod":"POST"}
createdAt: 2026-09-22T14:00:58.205Z
---

Registers an investor for your offering and returns a callback url. This single-use link that walks the investor through identity verification on the EquiDeFi investor portal and drops them directly onto the correct step of their investment.

:::hint{type="info"}
If you want to review the API request details, jump directly to the [Register Investor](https://docs.equidefi.io/register-investor) documentation.
:::

**Nothing is created when you call this endpoint.** No user account, no investment, no personal data at rest in the platform database. The registration you submit is validated, encrypted, and held for 24 hours; the investor's account and investment are only created after the investor proves ownership of the email address by completing verification at the callback URL.

## Offering-type rules

- **Accredited-only exemptions** (Reg A/ Reg A+, Reg D 506(b),  self-underwritten): a registration for the `PAYMENT` page with `accredited: false` will be rejected.
- **Reg D 506(c) and Reg S**: a non-accredited investor may register onto the `SUBSCRIPTION` page, but cannot be placed directly on the `PAYMENT` page.
- **Reg A / Reg A+**: a non-accredited investor's amount is capped at 10% of the greater of their stated annual income or net worth (the SEC suitability rule). Accredited investors are not capped.
- **Bounds**: whenever `amount` or `quantity` are included they are validated against the offering's minimum investment and the platform maximum.

## Callback URL Behavior

The flow the investor sees depends on whether they already have an EquiDeFi account **with a password**:

**New investor** (no EquiDeFi account, or an account that never finished setup):

1. A 6-digit verification code is emailed to them automatically when the page loads.
2. Entering the code creates their EquiDeFi account (still without a password).
3. They set a password and accept the EquiDeFi Terms of Service and Privacy Policy.
4. Only then is the investment created, and they land on the Subscription or Payment step you requested.

**Returning investor** (existing account with a password):

1. The page shows a login prompt with their masked email.
2. After their password, they enter an emailed verification code.
3. The investment is created and they land on the requested step.

If the investor abandons the flow at any point, nothing has been committed beyond what they completed — abandon before the full login process is finished and nothing exists at all.

:::hint{type="info"}
⚠️ If the investor has **any&#x20;**&#x69;nvestment in the offering — including a completed or closed one — registration returns **409&#x20;**&#x68;ttp status code. Repeat investments must go through the investor portal, where the platform can aggregate the investor's positions for suitability limits.&#x20;
:::

## Security considerations

There are several important considerations when using this endpoint:

1. 🔐 **Your API key is a server-side secret.** **Never embed it in a browser, mobile app, or public repository.** Anyone holding it can register investors against your offering and read your investment data.
2. 🔐 **Treat the `callback_url` like a password-reset link.** It is a bearer credential: whoever opens it can attempt verification for that investor. Deliver it to the investor over a channel you trust (your authenticated session with them, or their verified email), and do not log it, put it in analytics/URLs you retain, or embed it in public pages. Its protections (e.g. 24-hour expiry, rotation on re-registration) assume the link itself hasn't been broadcast.
3. 🔐 **The email address is the identity anchor.** Verification codes go to the email you submit, and an existing account with that email is who the investment will belong to. Submit only addresses your investor has confirmed with you since a typo sends the verification (and control of the registration) to someone else.

### Additional Considerations

- Failed verification attempts (wrong codes, and wrong passwords for returning investors) count against a shared 5-attempt cap; after that the link is dead and the investor must be re-registered.
- Invalid, expired, tampered, and locked-out links all return the same generic message, so a link cannot be probed for information.
- Registration data is encrypted at rest for the 24-hour window and deleted once the investor completes the flow or the 24-hour window lapses.
- Callback endpoints are additionally rate-limited per IP and link.

## Communication with Investors

Before sending an investor their link, you can set these expectations so they know what to expect.

- **Expect an email from EquiDeFi** with a 6-digit verification code when they open the `callback_url` link. It's *not junk*, they need it to proceed with their investment.
- **The link is personal and expires in 24 hours.** They shouldn't forward it, and if it lapses you can issue a new one.
- **First-time investors will create an EquiDeFi account** — they'll choose a password and accept EquiDeFi's Terms of Service and Privacy Policy as part of the flow. This account is how they'll track and manage their investment afterward.
- **Investors who already have an EquiDeFi account** will log in with their existing password instead. If they've forgotten it, the portal's password reset works as usual.
- **Repeat investors should go to the investor portal directly** rather than through your registration form. The API only accepts an investor's first investment in an offering.

:::ApiMethodV2
```json
{
  "name": "Register Investor",
  "method": "POST",
  "url": " https://equidefi.io/api/v1/offerings/{offeringId}/investments",
  "description": "Registers an investor and provides URL to continue the investment workflow on the EquiDeFi platform",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "vffs7IYVwvhyvsHtLvWDp",
        "language": "curl",
        "code": "curl --request POST \\\n     --url https://equidefi.io/api/v1/offerings/{offeringId}/investments \\\n     --header 'accept: application/json' \\\n     --header 'content-type: application/json' \\\n     --header \"authorization: Bearer $TOKEN\" \\\n     --data '{\n     \"first_name\": \"string\",\n     \"last_name\": \"string\",\n     \"email\": \"string\",\n     \"phone_number\": \"string\"\n     }'",
        "customLabel": ""
      },
      {
        "id": "Co044KN9rmCRmEujbqA3K",
        "language": "typescript",
        "code": "const TOKEN = \"\"; // EquiDeFi API Key\n\nasync function main() {\n  const response = await fetch(\"https://equidefi.io/api/v1/offerings/{offeringId}/investments\", {\n    method: \"POST\",\n    headers: {\n      accept: \"application/json\",\n      \"content-type\": \"application/json\",\n      authorization: `Bearer ${TOKEN}`,\n    },\n    body: JSON.stringify({\n      first_name: \"string\",\n      last_name: \"string\",\n      email: \"string\",\n      phone_number: \"string\",\n    }),\n  });\n\n  if (!response.ok) {\n    const { errors } = await response.json();\n    throw new Error(`Registration failed (${response.status}): ${errors.join(\". \")}`);\n  }\n\n  console.log(await response.json());\n}\n\nmain().catch(console.error);"
      },
      {
        "id": "hnEG9nWRMRYxtEUWH0eM1",
        "language": "nodejs",
        "code": "const TOKEN = \"\"; // EquiDeFi API Key\n\nasync function main() {\n  const response = await fetch(\"https://equidefi.io/api/v1/offerings/{offeringId}/investments\", {\n    method: \"POST\",\n    headers: {\n      accept: \"application/json\",\n      \"content-type\": \"application/json\",\n      authorization: `Bearer ${TOKEN}`,\n    },\n    body: JSON.stringify({\n      first_name: \"string\",\n      last_name: \"string\",\n      email: \"string\",\n      phone_number: \"string\",\n    }),\n  });\n\n  if (!response.ok) {\n    const { errors } = await response.json();\n    throw new Error(`Registration failed (${response.status}): ${errors.join(\". \")}`);\n  }\n\n  console.log(await response.json());\n}\n\nmain().catch(console.error);",
        "customLabel": ""
      },
      {
        "id": "M2eJ4VBRvtp8pF8t8SVsX",
        "language": "python",
        "code": "import requests\nimport json\n\nurl = \"https://equidefi.io/api/v1/offerings/{offeringId}/investments\"\n\npayload = json.dumps({\n   \"first_name\": \"string\",\n   \"last_name\": \"string\",\n   \"email\": \"string\",\n   \"phone_number\": \"string\"\n})\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json',\n   'authorization': 'Bearer '\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n",
        "customLabel": ""
      },
      {
        "id": "JRffpG8BpSXzyG7VRVUU3",
        "language": "ruby",
        "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://equidefi.io/api/v1/offerings/{offeringId}/investments\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nTOKEN = \"\" // EquiDeFi API Key\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest[\"authorization\"] = \"Bearer #{TOKEN}\"\nrequest.body = JSON.dump({\n   \"first_name\": \"string\",\n   \"last_name\": \"string\",\n   \"email\": \"string\",\n   \"phone_number\": \"string\"\n})\n\nresponse = https.request(request)\nputs response.read_body\n",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "hnEG9nWRMRYxtEUWH0eM1"
  },
  "results": {
    "languages": [
      {
        "id": "Mubt2QAVvL_V2die55pv6",
        "language": "200",
        "code": "{\n  \"data\": {\n    \"type\": \"registrations\",\n    \"id\": \"2ZFlYaCor29AqmBix4y6NkoC4P2rFMAij_CbmppcsI4\",\n    \"attributes\": {\n      \"email\": \"john.smith@example.com\",\n      \"page\": \"SUBSCRIPTION\",\n      \"callback_url\": \"https://app.equidefi.com/offerings/acme-corp/start/2ZFlYaCor29AqmBix4y6NkoC4P2rFMAij_CbmppcsI4.6c2c99b18747e225176a1a6ab2e80468\",\n      \"callback_expires_at\": \"2026-09-29T14:30:00.000Z\"\n    }\n  }\n}",
        "customLabel": ""
      },
      {
        "id": "bO3hgb6EbxJvOYKQRNO9f",
        "language": "400",
        "code": "{\n  \"errors\": [\n    \"Phone number is required\",\n    \"Annual income is required for a non-accredited investor on this offering\"\n  ],\n  \"fields\": {\n    \"phone_number\": \"Phone number is required\",\n    \"annual_income\": \"Annual income is required for a non-accredited investor on this offering\"\n  }\n}"
      },
      {
        "id": "_zSbOR9CYHvf2eQgN_aNf",
        "language": "403",
        "code": "{\n  \"errors\": [\"API key does not have access to this offering\"]\n}"
      },
      {
        "id": "At4u5q4WvdMYoww3r6Asp",
        "language": "409",
        "code": "{\n  \"errors\": [\"This investor already has an investment in this offering. Direct them to the investor portal to invest again.\"]\n}"
      },
      {
        "id": "8mlbQPrIRXSyaXzeKYvwN",
        "language": "429",
        "code": "{\n  \"errors\": [\"Too many requests, please try again later.\"]\n}"
      }
    ],
    "selectedLanguageId": "bO3hgb6EbxJvOYKQRNO9f"
  },
  "request": {
    "pathParameters": [
      {
        "name": "offeringId",
        "kind": "required",
        "type": "string",
        "description": "The Offering ID from the EquiDeFi platform",
        "": "The Offering ID from the EquiDeFi platform"
      }
    ],
    "queryParameters": [],
    "headerParameters": [
      {
        "name": "Authorization",
        "kind": "required",
        "type": "string",
        "description": "The API key",
        "": "The API key"
      }
    ],
    "bodyDataParameters": [
      {
        "name": "first_name",
        "kind": "required",
        "type": "string",
        "description": "Investor's first name",
        "": "Investor's first name"
      },
      {
        "name": "last_name",
        "kind": "required",
        "type": "string",
        "description": "Investor's last name",
        "": "Investor's last name"
      },
      {
        "name": "email",
        "kind": "required",
        "type": "string",
        "description": "Investor's email address",
        "": "Investor's email address"
      },
      {
        "name": "phone_number",
        "kind": "required",
        "type": "string",
        "description": "Investor's phone number",
        "": "required"
      },
      {
        "name": "account_type",
        "kind": "optional",
        "type": "string",
        "description": "The top-level account type of the investment. The options are `INDIVIDUAL`, `JOINT`, `ENTITY`, or `TRUST`.\n\nNot required. Defaults to `INDIVIDUAL`",
        "": "The top-level account type of the investment. The options are `INDIVIDUAL`, `JOINT`, `ENTITY`, or `TRUST`.\n\nNot required. Defaults to `INDIVIDUAL`"
      },
      {
        "name": "citizenship",
        "kind": "optional",
        "type": "string",
        "description": "Must be `US_CITIZEN` or `INTERNATIONAL`. Required for Regulation S offerings.",
        "": "Must be `US_CITIZEN` or `INTERNATIONAL`. Required for Regulation S offerings."
      },
      {
        "name": "page",
        "kind": "optional",
        "type": "string",
        "description": "Must be `SUBSCRIPTION` or `PAYMENT`. Defaults to `SUBSCRIPTION`. Additional fields are required if the value is `PAYMENT` and are provided in API responses.",
        "": "Must be `SUBSCRIPTION` or `PAYMENT`. Defaults to `SUBSCRIPTION`. Additional fields are required if the value is `PAYMENT` and are provided in API responses."
      },
      {
        "name": "amount",
        "kind": "optional",
        "type": "number",
        "description": "The amount in USD being invested. Must be a valid multiple of the price each security type. (e.g. `50` if the price of each security type is `10` and the investor wants to purchase 5 securities)\n\nRequired if the `page` value is `PAYMENT`",
        "": "The amount in USD being invested. Must be a valid multiple of the price each security type. (e.g. `50` if the price of each security type is `10` and the investor wants to purchase 5 securities)\n\nRequired if the `page` value is `PAYMENT`"
      },
      {
        "name": "quantity",
        "kind": "optional",
        "type": "number",
        "description": "The quantity of the security type being issued (e.g. shares).\n\nRequired if the `page` parameter is `PAYMENT`",
        "": "The quantity of the security type being issued (e.g. shares).\n\nRequired if the `page` parameter is `PAYMENT`"
      },
      {
        "name": "accredited",
        "kind": "optional",
        "type": "boolean",
        "description": "The investor's self-reported accreditation status.\n\nRequired if `page` parameter is `PAYMENT` and required to be `true` or `false` if the offering is not a Regulation A, Regulation A+, or IPO. ",
        "": "The investor's self-reported accreditation status.\n\nRequired if `page` parameter is `PAYMENT` and required to be `true` or `false` if the offering is not a Regulation A, Regulation A+, or IPO. "
      },
      {
        "name": "broker_dealer",
        "kind": "optional",
        "type": "boolean",
        "description": "The investor's self-reported broker-dealer status.\n\nRequired if `page` parameter is `PAYMENT`.",
        "": "The investor's self-reported broker-dealer status.\n\nRequired if `page` parameter is `PAYMENT`."
      },
      {
        "name": "net_worth",
        "kind": "optional",
        "type": "number",
        "description": "Investor's self-reported net worth. Required for Regulation A and Regulation A+ offerings and if investor's self-reports as NOT accredited\n\nSee https://www.sec.gov/resources-small-businesses/exempt-offerings/regulation for more details",
        "": "Investor's self-reported net worth. Required for Regulation A and Regulation A+ offerings and if investor's self-reports as NOT accredited\n\nSee https://www.sec.gov/resources-small-businesses/exempt-offerings/regulation for more details"
      },
      {
        "name": "annual_income",
        "kind": "optional",
        "type": "number",
        "description": "Investor's self-reported annual income. Required for Regulation A and Regulation A+ offerings and if investor's self-reports as NOT accredited\n\nSee https://www.sec.gov/resources-small-businesses/exempt-offerings/regulation for more details",
        "": "Investor's self-reported annual income. Required for Regulation A and Regulation A+ offerings and if investor's self-reports as NOT accredited\n\nSee https://www.sec.gov/resources-small-businesses/exempt-offerings/regulation for more details"
      },
      {
        "name": "affiliate_code",
        "kind": "optional",
        "type": "string",
        "description": "An affiliate code to assign to the investment. Affiliate codes can be configured in your offering settings.",
        "": "An affiliate code to assign to the investment. Affiliate codes can be configured in your offering settings."
      }
    ],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "response": [
    {
      "name": "data",
      "kind": "optional",
      "type": "object",
      "description": "ID of the cake retrieved",
      "children": [
        {
          "name": "id",
          "kind": "optional",
          "type": "string",
          "description": "ID of the registration. Can be given to EquiDeFi support for triaging issues"
        },
        {
          "name": "type",
          "kind": "optional",
          "type": "string",
          "description": "\"registrations\""
        },
        {
          "name": "attributes",
          "kind": "optional",
          "type": "object",
          "description": "",
          "children": [
            {
              "name": "email",
              "kind": "optional",
              "type": "string",
              "description": "Confirmed email of the investor"
            },
            {
              "name": "page",
              "kind": "optional",
              "type": "string",
              "description": "The workflow step the investor will land on once they have completed logging into the EquiDeFi platform."
            },
            {
              "name": "callback_url",
              "kind": "optional",
              "type": "string",
              "description": "The URL to be given to the investor to continue the investment workflow on the EquiDeFi platform. "
            },
            {
              "name": "callback_expires_at",
              "kind": "optional",
              "type": "string",
              "description": "The `callback_url` value will expire 24 hours after being issued at this timestamp."
            }
          ]
        }
      ]
    },
    {
      "name": "errors",
      "kind": "optional",
      "type": "array",
      "description": "List of any validation errors during the registration process in full sentences",
      "children": []
    },
    {
      "name": "fields",
      "kind": "optional",
      "type": "object",
      "description": "Object containing each field and any validation errors that occur in the registration process",
      "children": []
    }
  ],
  "customAnchorSlug": "register-investor",
  "autoGeneratedAnchorSlug": "register-investor",
  "legacyHash": "2fnR9kAH7ya2O_Ro-b4oI"
}
```
:::

