Skip to main content
POST
/
investors
/
eligibility
Pre-collection eligibility check
curl --request POST \
  --url https://api.bluumfinance.com/v1/investors/eligibility \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "date_of_birth": "1990-05-15",
  "country_of_tax_residence": "US",
  "account_type": "individual"
}
'
{
  "object": "eligibility_check",
  "livemode": false,
  "eligible": true,
  "reasons": []
}

Authorizations

​
Authorization
string
header
required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Body

application/json

Minimum-input pre-collection eligibility check. Stores nothing; confirms a prospective user is supportable before collecting full PII.

​
date_of_birth
string<date>
required

Applicant date of birth (YYYY-MM-DD).

Example:

"1990-05-15"

​
country_of_tax_residence
string
required

ISO 3166-1 alpha-2 country code of tax residence.

Example:

"US"

​
account_type
enum<string>

Optional account type hint. Only individual and trading (legacy alias) are supported via this endpoint.

Available options:
individual,
joint,
corporate,
trading
Example:

"individual"

Response

Eligibility result.

Eligibility check result (no persisted resource id).

​
object
enum<string>
required

The resource type discriminator.

Available options:
eligibility_check
Example:

"investor"

​
livemode
boolean
required

Whether this resource was created against a live API key. Test-mode keys always return false.

Example:

false

​
eligible
boolean
required

True when no blocking reasons were found.

​
reasons
string[]
required

Human-readable blockers when eligible is false.

​
id
string

Prefixed public id (e.g. inv_…, ord_…, dep_…).

Example:

"inv_01j9x8m2k7qpzwv3t5r6y8n0ab"

​
created
integer | null

Unix-seconds timestamp of resource creation.

Example:

1747776000

​
metadata
object

Partner-set key/value map for cross-referencing.