Entity
A person or business on a program, with its Entity Risk Skoor.
The customer behind a transfer: verification state, screening state and PEP status are read from the bank verbatim. The Entity Risk Skoor (ers-v1) is the latest actor_skoors row for the entity; it appears in reports, on pre-flight answers through the limit ladder, and in signed proofs.
Entity
| Field | Type | Notes |
|---|---|---|
| id | string | Column entity id. |
| tenantId | string (uuid) | |
| programId | string (uuid) | |
| type | "PERSON" | "BUSINESS" | |
| name | string | |
| verificationStatus | "UNVERIFIED" | "PENDING" | "MANUAL_REVIEW" | "VERIFIED" | "DENIED" | |
| isHighRisk | boolean | |
| pepStatus | "not_checked" | "no" | "yes" | "potential" | |
| requiresScreening | boolean | |
| reviewReasons | string[] | |
| lastScreenedAt | string | null (date-time) | |
| countryCode | string | null | |
| legalType | string | null | |
| expectedPaymentRails | string[] | |
| raw | object | The bank's own object as last delivered. |
| createdAt | string (date-time) | |
| updatedAt | string (date-time) |
Endpoints
post/api/skoor/actors/backfill/{programId}
Rescore every actor on a program
Recomputes the Entity, Counterparty and Agent Risk Skoors for every actor on the program and re-runs the actor detectors. Operator token of the owning tenant; X-Operator is not required.
| Auth | Bearer (program's tenant); no X-Operator |
|---|---|
| Operation | Entity · POST /api/skoor/actors/backfill/{programId} |
Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| programId | path | string (uuid) | Program id. |
Responses
200 — Actors scored, by kind (agents are counted inside entities or counterparties as well). object
| Field | Type | Notes |
|---|---|---|
| entities | integer | |
| counterparties | integer | |
| agents | integer |
401 — Bearer is not the owning tenant's operator token. Error
| Field | Type | Notes |
|---|---|---|
| error | string | What went wrong, in one sentence. |
| requestId (optional) | string | Present once the gateway is live: the X-Request-Id of the failed request. |
Example
curl -s -X POST "https://skoor.ai/risk/api/skoor/actors/backfill/a1e0c2d4-6b7f-4d8e-9a3b-0c1d2e3f4a55" \ -H "Authorization: Bearer test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"