Skip to main content
GET
/
accounts
/
{account_id}
/
compliance
/
workflows
/
{workflow_id}
Get compliance workflow status
curl --request GET \
  --url https://service.bluumfinance.com/v1/accounts/{account_id}/compliance/workflows/{workflow_id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "in_progress",
  "risk_level": null,
  "checks": [
    {
      "check_type": "identity_verification",
      "status": "clear",
      "provider": "persona-identity",
      "external_id": "inq_abc123def456",
      "started_at": "2026-03-15T10:00:00.000Z",
      "completed_at": "2026-03-15T10:05:00.000Z"
    },
    {
      "check_type": "screening",
      "status": "pending",
      "provider": "persona-screening",
      "external_id": null,
      "started_at": "2026-03-15T10:00:00.000Z",
      "completed_at": null
    }
  ],
  "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

​
account_id
string<uuid>
required

The account (investor) ID

​
workflow_id
string<uuid>
required

The compliance workflow ID

Response

Workflow status retrieved successfully

​
id
string<uuid>

Unique identifier for the compliance workflow.

​
status
enum<string>

Current status of the workflow:

  • in_progress: One or more checks are still pending.
  • pending_review: All checks complete, but manual review is needed (HIGH risk).
  • approved: All checks passed and workflow is approved.
  • rejected: One or more checks failed or risk level is PROHIBITED.
Available options:
in_progress,
pending_review,
approved,
rejected,
suspended,
expired
​
risk_level
enum<string> | null

Assessed risk level after all checks complete.

Available options:
low,
medium,
high,
prohibited
​
checks
object[]
​
created_at
string<date-time>
​
updated_at
string<date-time>