Skip to main content
GET
/
investors
/
{investor_id}
/
compliance
Get compliance status for an investor
curl --request GET \
  --url https://api.bluumfinance.com/v1/investors/{investor_id}/compliance \
  --header 'Authorization: Basic <encoded-value>'
{
  "object": "compliance_workflow",
  "livemode": false,
  "investor_id": "inv_01j9x8m2k7qpzwv3t5r6y8n0ab",
  "workflow_status": "APPROVED",
  "workflow_type": "kyc",
  "risk_level": "low",
  "status": "approved",
  "checks": [
    {
      "type": "identity_verification",
      "status": "clear",
      "completed_at": "2026-03-15T10:05:00.000Z"
    },
    {
      "type": "screening",
      "status": "clear",
      "completed_at": "2026-03-15T10:05:00.000Z"
    },
    {
      "type": "risk_assessment",
      "status": "clear",
      "completed_at": "2026-03-15T10:05:00.000Z"
    }
  ],
  "created_at": "2026-03-15T10:00:00.000Z",
  "updated_at": "2026-03-15T10:05:00.000Z"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
investor_id
string
required

Prefixed public id of the investor (e.g. inv_…).

Response

Compliance status.

Compliance-workflow status returned by GET /v1/investors/{investor_id}/compliance. Wraps the latest workflow with envelope keys (object: 'compliance_workflow', livemode). status is the Bluum-native external vocab (running / awaiting_review / approved / declined / suspended / expired); workflow_status is the internal UPPER_CASE value retained for partners that want the raw enum.

​
object
enum<string>
required
Available options:
compliance_workflow
​
livemode
boolean
required
​
investor_id
string
required

Prefixed public id of the investor.

Example:

"inv_01j9x8m2k7qpzwv3t5r6y8n0ab"

​
workflow_status
enum<string>
required

Internal Alpaca-aligned UPPER_CASE workflow status.

Available options:
IN_PROGRESS,
PENDING_REVIEW,
APPROVED,
REJECTED,
SUSPENDED,
EXPIRED
Example:

"APPROVED"

​
workflow_type
enum<string>
required

Type of compliance workflow.

Available options:
kyc,
kyb,
periodic_review
Example:

"kyc"

​
checks
object[]
required

Individual compliance check results.

​
created_at
string<date-time>
required

When the compliance workflow was initiated.

Example:

"2026-03-15T10:00:00.000Z"

​
updated_at
string<date-time>
required

When the compliance workflow was last updated.

Example:

"2026-03-15T10:05:00.000Z"

​
status
enum<string>

Bluum-native external workflow status.

Available options:
running,
awaiting_review,
approved,
declined,
suspended,
expired
Example:

"approved"

​
risk_level
enum<string> | null

Assessed risk level. Null while checks are still in progress.

Available options:
low,
medium,
high,
prohibited,
null
Example:

"low"