Register Investor
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.
If you want to review the API request details, jump directly to the Register InvestorAPI Request 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):
- A 6-digit verification code is emailed to them automatically when the page loads.
- Entering the code creates their EquiDeFi account (still without a password).
- They set a password and accept the EquiDeFi Terms of Service and Privacy Policy.
- Only then is the investment created, and they land on the Subscription or Payment step you requested.
Returning investor (existing account with a password):
- The page shows a login prompt with their masked email.
- After their password, they enter an emailed verification code.
- 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.
⚠️ If the investor has any investment in the offering — including a completed or closed one — registration returns 409 http status code. Repeat investments must go through the investor portal, where the platform can aggregate the investor's positions for suitability limits.
Security considerations
There are several important considerations when using this endpoint:
- 🔐 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.
- 🔐 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.
- 🔐 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.
- offeringIdstringrequiredDescription
- AuthorizationstringrequiredDescription
- first_namestringrequiredDescription
- last_namestringrequiredDescription
- emailstringrequiredDescription
- phone_numberstringrequiredDescription
- account_typestringDescription
- citizenshipstringDescription
- pagestringDescription
- amountnumberDescription
- quantitynumberDescription
- accreditedbooleanDescription
- broker_dealerbooleanDescription
- net_worthnumberDescription
- annual_incomenumberDescription
- affiliate_codestringDescription
- dataobjectDescription
- idstringDescription
- typestringDescription
- attributesobject
- emailstringDescription
- pagestringDescription
- callback_urlstringDescription
- callback_expires_atstringDescription
- errorsarrayDescription
- fieldsobjectDescription
curl --request POST \
--url https://equidefi.io/api/v1/offerings/{offeringId}/investments \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header "authorization: Bearer $TOKEN" \
--data '{
"first_name": "string",
"last_name": "string",
"email": "string",
"phone_number": "string"
}'const TOKEN = ""; // EquiDeFi API Key
async function main() {
const response = await fetch("https://equidefi.io/api/v1/offerings/{offeringId}/investments", {
method: "POST",
headers: {
accept: "application/json",
"content-type": "application/json",
authorization: `Bearer ${TOKEN}`,
},
body: JSON.stringify({
first_name: "string",
last_name: "string",
email: "string",
phone_number: "string",
}),
});
if (!response.ok) {
const { errors } = await response.json();
throw new Error(`Registration failed (${response.status}): ${errors.join(". ")}`);
}
console.log(await response.json());
}
main().catch(console.error);const TOKEN = ""; // EquiDeFi API Key
async function main() {
const response = await fetch("https://equidefi.io/api/v1/offerings/{offeringId}/investments", {
method: "POST",
headers: {
accept: "application/json",
"content-type": "application/json",
authorization: `Bearer ${TOKEN}`,
},
body: JSON.stringify({
first_name: "string",
last_name: "string",
email: "string",
phone_number: "string",
}),
});
if (!response.ok) {
const { errors } = await response.json();
throw new Error(`Registration failed (${response.status}): ${errors.join(". ")}`);
}
console.log(await response.json());
}
main().catch(console.error);import requests
import json
url = "https://equidefi.io/api/v1/offerings/{offeringId}/investments"
payload = json.dumps({
"first_name": "string",
"last_name": "string",
"email": "string",
"phone_number": "string"
})
headers = {
'accept': 'application/json',
'content-type': 'application/json',
'authorization': 'Bearer '
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
require "uri"
require "json"
require "net/http"
url = URI("https://equidefi.io/api/v1/offerings/{offeringId}/investments")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
TOKEN = "" // EquiDeFi API Key
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request["authorization"] = "Bearer #{TOKEN}"
request.body = JSON.dump({
"first_name": "string",
"last_name": "string",
"email": "string",
"phone_number": "string"
})
response = https.request(request)
puts response.read_body
{
"data": {
"type": "registrations",
"id": "2ZFlYaCor29AqmBix4y6NkoC4P2rFMAij_CbmppcsI4",
"attributes": {
"email": "[email protected]",
"page": "SUBSCRIPTION",
"callback_url": "https://app.equidefi.com/offerings/acme-corp/start/2ZFlYaCor29AqmBix4y6NkoC4P2rFMAij_CbmppcsI4.6c2c99b18747e225176a1a6ab2e80468",
"callback_expires_at": "2026-09-29T14:30:00.000Z"
}
}
}{
"errors": [
"Phone number is required",
"Annual income is required for a non-accredited investor on this offering"
],
"fields": {
"phone_number": "Phone number is required",
"annual_income": "Annual income is required for a non-accredited investor on this offering"
}
}{
"errors": ["API key does not have access to this offering"]
}{
"errors": ["This investor already has an investment in this offering. Direct them to the investor portal to invest again."]
}{
"errors": ["Too many requests, please try again later."]
}