Introduction
The OneHypernet KYC API enables you to integrate your own systems directly with our KYC solutions to automate your operational procedures. All actions performed via the OneHypernet KYC API is captured in your OneHypernet KYC web account at https://kyc.onehypernet.com as a back-up. Our API is organized around REST, and accepts and returns JSON data.
All API requests must be made over HTTPS; calls made over plain HTTP will fail.
API Reference
Please contact your account manager for the Postman collection and Environment variable collection.
Authentication
Generate bearer token:
curl -X 'POST' \
'https://api.onehypernet.com/v1/auth/kyc/login' \
-H 'accept: application/json' \
-d '{
"email": "user@example.com",
"password": "p@s3w0rd"
}'
JSON Response:
{
"access_token": "eyJhbGciOiJJf9anSInR5cCI6IkpXVCJ9.eyJzdWIiOiJmZTMyOGE3Ny02YjYyLTQFm9Fm5Yy02MTFkYzBhNDU2NzIiLCJlbWFpbCI6ImFsc3RvbmV0ZWUra3ljdGVzdGluZ180QGdtYWlsLmNvbSIsImZ1bGxfbmFtZSI6IkFsZXggVGFuIiwicm9sZSI6Imt5Y191c2VyIiwiYXBpX2tleSI6IjNjMjRiNzFlMjBkNjBj2TUzOTZiZjQ2NjY4MDIwMjNmIiwibXRvX2xlZFnSiX25hbWUiOiJLWUMgVEVTVElORyIsImlhdCI6MTY3MDU3MDIyNCwiZXhwIjo3NzE4NTcwMjI0fQ.RPPtxav0NAwxD709mSYkKIcxPiuKsE55p0fJ-jymRLc",
"refresh_token": "bg2RZvG8afM1GmKq"
}
OneHypernet uses bearer tokens to allow access to our APIs. Please contact your account manager for access to the staging environment.
You can generate bearer tokens from the POST /login endpoint. Include the bearer token as a header for all requests.
- Authorization header of your API request
-H 'Authorization: Bearer {token}
Standard accounts can generate up to 10 access tokens.
Your access tokens provide secure entry to your account data, so please implement best practices for managing your credentials. Access tokens expire within 24 hours. Refresh tokens remain valid for up to 180 days and are designed to support long-term authentication without repeatedly re-logging in. Access tokens should not be regenerated for every API call. Please implement a refresh-token flow so your application can request new access tokens only when required. This keeps authentication secure, stable, and efficient.
There is a maximum of 10 active access tokens per standard account. Over-creating tokens may exhaust this limit and cause authentication to fail until earlier tokens are revoked. Excessive token generation may also trigger rate limits, resulting in temporary rejection of authentication requests.
You can renew an access token by sending the refresh token to the POST /refresh endpoint.
Refresh access token:
curl -X 'POST' \
'https://api.onehypernet.com/v1/auth/kyc/refresh-access-token' \
-H 'accept: application/json' \
-d '{
"refresh_token": "bg2RZvG8afM1GmKq"
}'
JSON Response:
{
"access_token": "eyJhbGciOiJJf9anSInR5cCI6IkpXVCJ9.eyJzdWIiOiJmZTMyOGE3Ny02YjYyLTQFm9Fm5Yy02MTFmYGBhNDU2NzIiLDJlbWFpbCI6ImFsc3RvbmV0ZWUra3ljdGVzdGluZ180QGdtYWlsLmNvbSIsImZ1bGxfbmFtZSI6IkFsZXggVGFuIiwicm9sZSI6Imt5Y191c2VyIiwiYXBpX2tleSI6IjNjMjRiNzFlMjBkNjBj2TUzOTZiZjQ2NjY4MDIwMjNmIiwibXRvX2xlZFnSiX22hbWUiOiJLWUMgVEVTVElORyIsImlhdCI6MTY3MDU3MDIyNCwiZXhwIjo3NzE4NTcwMjI0fQ.RPPtxav0NAwxD709mSYkKIcxPiuKsE55p0fJ-jdassc"
}
You can revoke an access token from the POST /revoke endpoint. Revoking an access token will also revoke its refresh token.
Revoke token:
curl -X 'POST' \
'https://api.onehypernet.com/v1/auth/kyc/revoke-access-token' \
-H 'accept: application/json' \
-d '{
"access_token": "eyJhbGciOiJJf9anSInR5cCI6IkpXVCJ9.eyJzdWIiOiJmZTMyOGE3Ny02YjYyLTQFm9Fm5Yy02MTFmYGBhNDU2NzIiLDJlbWFpbCI6ImFsc3RvbmV0ZWUra3ljdGVzdGluZ180QGdtYWlsLmNvbSIsImZ1bGxfbmFtZSI6IkFsZXggVGFuIiwicm9sZSI6Imt5Y191c2VyIiwiYXBpX2tleSI6IjNjMjRiNzFlMjBkNjBj2TUzOTZiZjQ2NjY4MDIwMjNmIiwibXRvX2xlZFnSiX22hbWUiOiJLWUMgVEVTVElORyIsImlhdCI6MTY3MDU3MDIyNCwiZXhwIjo3NzE4NTcwMjI0fQ.RPPtxav0NAwxD709mSYkKIcxPiuKsE55p0fJ-jdassc"
}'
API Endpoints
This is the public list of endpoints that are available for use. Please contact your account manager if you need additional or custom endpoints.
| Endpoint | Description |
|---|---|
GET /cases |
Retrieves all cases but not their screening history. |
GET /cases/{case_id} |
Retrieves a case, its related entities, and its screening history. |
POST /cases/individual |
Creates a new case of an individual. |
POST /cases/corporate |
Creates a new case of a corporate. |
PATCH /cases/individual/{case_id} |
Updates the case of an individual. |
PATCH /cases/corporate/{case_id} |
Updates the case of a corporate. |
PATCH /cases/delete |
Deletes a case or multiple cases. |
GET /cases/screen/{case_id} |
Screens the main entity of a case. |
GET /cases/screening-archive/{case_id} |
Retrieves the screening archive of a case. |
GET /screen-history |
Retrieves the screen history of all cases. |
GET /rba/variables?caseType=Individual |
Retrieves all the risk variables for the case type of Individual. |
GET /rba/variables?caseType=Corporate |
Retrieves all the risk variables for the case type of Corporate. |
POST /rba/variables?caseType=Individual |
Updates the risk variables of the case type of Individual. |
POST /rba/variables?caseType=Corporate |
Updates the risk variables of the case type of Corporate. |
GET /rba/case/{case_id} |
Retrieves the risk score of the case. |
POST /rba/case/{case_id} |
Adjusts the score of the risk variable. |
GET /rba/case/{case_id}/summary |
Triggers AI model to generate a risk assessment summary of the case. |
GET /rba/case/{case_id}/score-histories |
This endpoint retrieves the history of the risk score of a case. |
GET /rba/settings?type={reference} |
Retrieve the settings of each reference. |
POST /rba/settings?type={reference} |
Update the settings of each reference. |
POST /rba/settings?type=ScreeningSyntheticIndex |
Update the settings of screening reference. |
GET /rba/risk-levels |
Retrieve risk levels of the account. |
POST /rba/risk-levels |
Update risk levels of the account. |
GET /kyc/transactions |
Retrieves all transactions. |
GET /kyc/transactions/{transaction_id} |
Retrieve a specific transaction. |
GET /kyc/transactions/cases/{case_id} |
Retrieves all transactions of a single case. |
POST /kyc/transactions/transactions |
Creates a single transaction. |
PATCH /kyc/transactions/{transaction_id} |
Updates a single transaction. |
DELETE /kyc/transactions/unlink/{case_id} |
Unlinks all transactions from a specific case but does not delete the transactions itself. |
DELETE /kyc/transactions/{transaction_id} |
Delete a transaction and all its data. |
GET /cases/match/{screen_id}/{match_id} |
Retrieves a specific match of a screen. |
PATCH /cases/match/{screen_id}/{match_id} |
Updates a single match of a screen. |
PATCH /cases/update-multiple-matches |
Updates multiple matches of a screen. |
GET /cases/monitoring |
Retrieves updates for ongoing monitoring. |
GET /cases/screen-summary |
Retrieves the number of screens of your account. |
GET /rba/summary-count |
Retrieves the number of AI summaries generated in your account. |
GET /cases/variable-score-count |
Retrieves the number of AI risk scoring done on free-text variables (as "Others") in your account. |
GET /cases/users |
Retrieves the details of all users in your account. |
GET /cases/branches |
Retrieves the details of all branches in your account. |
POST /cases/branches |
Creates a new branch. |
PATCH /cases/branches/{branch_id} |
Updates the details of a branch. |
DELETE /cases/branches/{branch_id} |
Delete a branch. |
Case Management
Each case contains a main entity, and you can connect other cases (related entities such as shareholders, suppliers, auditor, etc.) to each case. You can assign cases to specific users, set risk levels, customize case settings, specify the frequency of ongoing monitoring, and save screenings.
Retrieve Cases
Retrieve all cases
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases?limit={limit}&sort={parameter,DESC}&filter={parameter||$in||value}&filter={range_parameter||$gte||5}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response for One Case:
{
"data": [
{
"email": "alberteinstein@example.com",
"status": "approved",
"risk": "low",
"updated_at": "2022-12-09T07:39:46.994Z",
"created_at": "2022-12-09T07:39:46.975Z",
"unresolvedMatches": 1,
"positiveMatches": 0,
"possibleMatches": 0,
"falseMatches": 0,
"new_matches": 0,
"updated_profiles": 1,
"deleted_profiles": 0,
"group_id": "VIP12",
"batch_id": "DEC23",
"last_screened": "2024-01-11T04:35:11.147Z",
"full_name": "Albert Einstein",
"nationality": "Singaporean",
"gender": "male",
"assigned_user": {
"user_id": "fe328a77-6b62-4228-979c-611fc0a45672",
"full_name": "Alex Tan"
},
"case_id": "6ba279a7-a7c0-49c9-b024-9d750a5a34d2",
"custom_case_id": "CD9923000",
"case_group": "VIP",
"case_type": "individual"
}
],
"metadata": {
"total": 1
}
}
GET /cases
This endpoint retrieves all cases but not their screening history. Add a limit to improve loading times.
| Parameter | Type | Description |
|---|---|---|
limit |
Integer | Number of results for pagination. |
offset |
Integer | Starting point of the results for pagination. |
sort |
String | ASC or DESC. |
Filter Parameters
You can filter search results with these parameters using the $in operator.
| Parameter | Type | Description |
|---|---|---|
custom_case_id |
String | Unique reference ID of the case. |
group_id |
String | Group ID to identify cases belonging to a group. |
case_type |
String | Individual or Corporate case. |
email |
String | Email address of the entity. |
contact |
Integer | Contact number of the entity. |
status |
String | Pending, Processing, Approved, Rejected. |
first_name |
String | First name of the individual. |
last_name |
String | Last name of the individual. |
full_name |
String | Full name of the individual. |
nationality |
String | Nationality of the individual in ISO 3166 format. |
case_group |
String | Case group as per your settings. |
risk |
String | low, medium, high, unrated. |
legal_name |
String | Legal name of the corporate. |
corporate_type |
String | Type of corporate. |
country_of_incorporation |
String | Country of incorporation in ISO 3166 format. |
registration_no |
String | Business registration number of the corporate. |
ongoing_monitoring |
Boolean | Yes / No for ongoing monitoring. |
assigned_to |
String | Assignee of the case. |
branch_id |
String | Branch that the case is attached to. |
You can also filter search results based on range parameters using the $lte and $gte operators.
| Range Parameter | Type | Description |
|---|---|---|
unresolvedMatches |
String | Cases with unresolved matches. |
possibleMatches |
String | Cases with possible matches. |
positiveMatches |
String | Cases with positive matches. |
falseMatches |
String | Cases with false matches. |
new_matches |
String | Cases with new matches from ongoing monitoring. |
updated_profiles |
String | Cases with updated matches from ongoing monitoring. |
deleted_profiles |
String | Cases with deleted matches from ongoing monitoring. |
Sort Parameters
You can sort search results with these parameters.
| Parameter | Type | Description |
|---|---|---|
status |
String | ASC or DESC. |
risk |
String | ASC or DESC. |
positive |
String | ASC or DESC. |
possible |
String | ASC or DESC. |
unresolved |
String | ASC or DESC. |
false |
String | ASC or DESC. |
created_on |
String | ASC or DESC. |
updated_at |
String | ASC or DESC. |
Retrieve a specific case
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/{case_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response for Individual Case:
{
"status": "approved",
"email": "alberteinstein@spacex_company.com",
"contact_no": "+6581234567",
"kyc_comment": null,
"business_relationship": null,
"risk": "low",
"review_starting_from": "2024-01-22",
"review_frequency_value": 12,
"review_frequency_type": "months",
"document_expiry_reminder_value": 2,
"document_expiry_reminder_type": "weeks",
"review_reminder_value": 2,
"review_reminder_type": "weeks",
"reminder_users": [
{
"user_id": "d1ac6328-3854-4a0e-805b-d8c7110e4e6d"
}
],
"assessment": "recommended",
"assessor": "2e2e0a5a-2f86-41f4-9e2b-4241e4a686d8",
"approver": "d1ac6328-3854-4a0e-805b-d8c7110e4e6d",
"group_id": null,
"last_screened": "2024-01-22T06:37:04.117Z",
"transactions": [
{
"id": "f5ee85bd-c5b3-42b3-9cf2-ffdc144209af",
"date": "2024-01-10T04:48:24.427Z",
"rate": 1250,
"type": "buy",
"amount": "2500.00",
"currency": "USD",
"quantity": 2,
"description": "Gold bar"
}
],
"assigned_to": "ea553e66-8c77-4d97-8b5c-970a9992e1a1",
"onboarding_mode": "Myinfo",
"sign_up_date": null,
"new_client": null,
"monthly_transaction_volume": null,
"monthly_transaction_frequency": null,
"average_transaction_amount": null,
"product_complexity": null,
"ongoing_monitoring": false,
"included_country": true,
"included_dob": true,
"included_gender": true,
"match_strength": "strong",
"screen_profile": null,
"monitoring_frequency_value": null,
"monitoring_frequency_type": null,
"full_name": "Albert Einstein",
"first_name": "Albert",
"last_name": "Einstein",
"native_name": "爱因斯坦",
"nationality": "SGP",
"id_type": "nric",
"id_no": "04109906",
"id_expiry": "2030-03-15",
"id_reminder": false,
"dob": "1990-03-20",
"industry": "Civil engineering",
"occupation": "Engineer",
"gender": "male",
"employer": "Space X",
"pep": "no",
"pep_role": null,
"pep_status": null,
"pep_type": null,
"pep_country": null,
"pep_start": null,
"pep_end": null,
"source_of_funds": "Bank account",
"source_of_wealth": "Savings",
"id_issuing_country": null,
"alias": null,
"former_name": null,
"ethnicity": null,
"marital_status": null,
"networth": null,
"country_of_birth": null,
"residential_address": "12 Alexander Road, BLK 356, The Office, #10-11",
"residential_postal_code": "554815",
"residential_country": "SGP",
"unresolvedMatches": 1,
"positiveMatches": 0,
"possibleMatches": 0,
"falseMatches": 0,
"case_id": "d33535b3-e343-4d95-a3d7-1782232d5b5a",
"custom_case_id": "C2485274061",
"case_group": null,
"case_type": "individual",
"screening_entities": [
{
"id": "d33535b3-e343-4d95-a3d7-1788232d5b5a",
"name": "Albert Einstein",
"screen": {
"created_at": "2024-01-22T06:37:03.978Z",
"updated_at": "2024-01-22T06:37:03.978Z",
"match_ids": ["4f833d42-0904-4b73-938f-0a77904b2a20"],
"created_by": "d1ac6328-3854-4a0e-805b-d8c7110e4e6d",
"updated_by": null,
"new_matches": 0,
"updated_profiles": 0,
"deleted_profiles": 0,
"comment": null,
"matches": [
{
"created_at": "2024-01-22T06:37:03.978Z",
"updated_at": "2024-01-22T06:37:03.978Z",
"match_id": "1c0dfd6f-a422-4e4d-974b-5cf20a450a10",
"comment": null,
"status": "unresolved",
"profile_status": "new",
"data": {
"dob": "1946",
"gender": "Male",
"prefix": "",
"suffix": "",
"overview": "Former Managing Director of Spacex Limited (2017 - 2019). Arrested for corruption - July 11, 2023.",
"countries": ["SGP", "MYS", "MDV", "NOR"],
"categories": ["Adverse Media", "PEP"],
"entityName": "Albert Einstein",
"entityType": "Individual",
"isBlacklist": false,
"last_updated": "2024-01-18T07:33:03.923Z",
"primary_country": "SGP",
"match_id": "1C0DFD6F-A422-4E4D-974B-5CF20A450A10"
},
"created_by": "d1ac6328-3854-4a0e-805b-d8c7110e4e6d",
"updated_by": null,
"resolved_on": null,
"screen_id": "64d1e5f4-4bf7-44a8-8864-a2f0bf79564d"
}
],
"screen_id": "64d1e5f4-4bf7-44a8-8864-a2f0bf79564d",
"case_id": "d33535b3-e343-4d95-a3d7-1788232d5b5a",
"screen_type": "manual",
"match_summary": {
"false": 0,
"positive": 0,
"possible": 0,
"unresolved": 1
},
"screen_parameters": {
"q": "Albert Einstein",
"dob": null,
"gender": null,
"country": null,
"screen_type": "manual",
"match_strength": "medium",
"custom_case_id": "C2485274061",
"case_type": "individual",
"screen_id": "d33535b3-e343-4d95-a3d7-1788232d5b5a"
}
},
"live_screen_parameters": {
"country": null,
"dob": null,
"gender": null,
"ongoing_monitoring": false,
"included_country": true,
"included_dob": true,
"included_gender": true,
"name_order": false,
"match_strength": "medium",
"screen_profile": null,
"monitoring_frequency_value": null,
"monitoring_frequency_type": null,
"next_ongoing_monitoring": null
}
}
],
"related_entities": [
{
"case_id": "6b6df5f4-e80a-49ed-826c-d2a96977ed6e",
"relationship": "R1",
"appointment_date": "2024-09-15",
"number_of_shares": 2323,
"share_currency": "SGD",
"shareholding": 0.25
}
]
"summary": {
"adjustedRisk": "High",
"computedRisk": "Medium",
"adjustedScore": 80,
"computedScore": 55
}
}
GET /cases/{case_id}
This endpoint retrieves a case, its related entities, and its screening history.
Retrieve audit log for a case
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/{case_id}/audit-logs' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response for a Case:
{
"data": [
{
"id": "c4828844-be3b-4004-b3ef-4bdd2b8ce648",
"type": null,
"group": "KYC",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "risk",
"updated_value": "high",
"previous_value": "unrated"
}
],
"source": null,
"created_at": "2025-12-19T04:48:04.246Z"
},
{
"id": "e6a4d8f8-da20-4732-9f00-e62a13018a6b",
"type": "create",
"group": "Setting",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "monitoring_notification_users",
"updated_value": "Test 2 ",
"previous_value": null
}
],
"source": null,
"created_at": "2025-12-18T13:55:09.734Z"
},
{
"id": "ab8109b7-ea85-4eac-b8cd-ce81cedc63c6",
"type": "create",
"group": "Setting",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "reminder_users",
"updated_value": "Test 2 ",
"previous_value": null
}
],
"source": null,
"created_at": "2025-12-18T13:55:09.710Z"
},
{
"id": "01f1aee9-0f15-4021-90bf-cff284d0fc7c",
"type": "create",
"group": "Screening Parameters",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "match_strength",
"updated_value": "strong"
},
{
"field_name": "included_country",
"updated_value": true
},
{
"field_name": "included_dob",
"updated_value": true
},
{
"field_name": "included_gender",
"updated_value": true
}
],
"source": null,
"created_at": "2025-12-18T13:55:09.685Z"
},
{
"id": "0a82a270-0bf5-4659-8cbc-23f90383bd35",
"type": "create",
"group": "Customer Details",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "full_name",
"updated_value": "John Ultra"
}
],
"source": null,
"created_at": "2025-12-18T13:55:09.669Z"
},
{
"id": "90ea8d6c-ca27-4f16-865f-f6285d34b5f0",
"type": null,
"group": "Customer Details",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "customer_id",
"updated_value": "C1623876525"
},
{
"field_name": "type",
"updated_value": "individual"
},
{
"field_name": "assigned_to",
"updated_value": "8cc5b1e8-6ca7-4c8e-97bb-292f95db1b7b"
},
{
"field_name": "case_group",
"updated_value": "",
"previous_value": ""
},
{
"field_name": "Branches",
"updated_value": "Main",
"previous_value": ""
}
],
"source": null,
"created_at": "2025-12-18T13:55:09.649Z"
},
{
"id": "28cfff95-1d89-437c-9c4c-22c5970d7227",
"type": null,
"group": "Setting",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "review_starting_from",
"updated_value": "2025-12-18"
}
],
"source": null,
"created_at": "2025-12-18T13:55:09.649Z"
},
{
"id": "c2d5dc9d-bf57-49cc-a566-2d9620e9f6ba",
"type": null,
"group": "KYC",
"username": "Test 2 ",
"user_email": "admin@silvermoneytransfer.com",
"payload": [
{
"field_name": "status",
"updated_value": "processing"
},
{
"field_name": "risk",
"updated_value": "unrated"
}
],
"source": null,
"created_at": "2025-12-18T13:55:09.649Z"
}
],
"metadata": {
"total": 8
}
}
GET /cases/{case_id}/audit-logs
This endpoint retrieves the audit log for a specific case.
Create Cases
Create individual case
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/cases/individual' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"custom_case_id": "C123456787",
"full_name": "Albert Einstein",
"status": "pending",
"risk": "low",
"nationality": "SGP",
"branch_ids": ["aac3991a-723a-4764-8bcd-09daff171d1e"],
"dob": "1955-02-15",
"gender": "male",
"createAndScreen": true,
"screen_parameters": [
{
"included_country": true,
"included_dob": true,
"match_strength": "strong"
}
],
"related_entities": [
{
"case_id": "6b6df5f4-e80a-49ed-826c-d2a96977ed6e",
"relationship": "R1",
"appointment_date": "2024-09-15",
"number_of_shares": 2323,
"share_currency": "SGD",
"shareholding": 0.25
}
]
}'
JSON Response:
{
"case_id": "5712621f-dea7-499f-b8c2-01c34128e5c4"
}
POST /cases/individual
This endpoint creates a new case of an individual.
Post Parameters
All parameters are optional except for full_name.
| Parameter | Type | Description |
|---|---|---|
full_name (required) |
String | Full name of the individual. |
custom_case_id |
String | You can specify a unique reference ID for this case, or leave it empty to generate a new, random custom_case_id. |
group_id |
String | Cases belonging to a specific group. |
branch_ids |
Array | You can tag a case to branches. |
first_name |
String | First name of the individual. |
last_name |
String | Last name of the individual. |
native_name |
String | Native name (e.g. Chinese characters). |
alias |
String | Aliases of the individual. |
former_name |
String | Former names of the individual. |
ethnicity |
String | Ethnicity of the individual. |
marital_status |
String | Marital status of the individual. |
residential_address |
String | Residential address of the individual. |
residential_postal_code |
Integer | Postal code of the residential address. |
residential_country |
String | Residential country of the individual. |
contact_no |
Integer | Contact number, including country code. |
email |
String | Email address. |
nationality |
String | Nationality of the individual in ISO 3166 format |
id_type |
String | Identification document type. |
id_no |
String | Identification document number. |
id_expiry |
Date | Expiry date of the identification in yyyy-mm-dd format. |
id_reminder |
Boolean | Toogle emails alerts to remind user for ID expiry. |
id_issuing_country |
String | Country that issued the individual's ID. |
country_of_birth |
String | Country of birth of the individual. |
dob |
date | Date of birth in yyyy-mm-dd format. |
gender |
String | Male, Female, Unknown. |
occupation |
String | Occupation |
employer |
String | Employer |
kyc_comment |
String | KYC comments for this case. |
risk_score_enable |
Boolean | Toggle settings for risk scoring. |
ongoing_monitoring |
Boolean | Toggle settings for ongoing monitoring in the array for screening parameters. |
included_country |
Boolean | Toggle inclusion of Nationality in the array for screening parameters. |
included_dob |
Boolean | Toggle inclusion of Date of Birth in the array for screening parameters. |
included_gender |
Boolean | Toggle inclusion of Gender in the array for screening parameters. |
monitoring_frequency_value |
Integer | Number of Days, Weeks, or Months in the array for screening parameters. |
monitoring_frequency_type |
String | Days, Weeks, Months in the array for screening parameters. |
review_starting_from |
Date | Date to begin review frequency. |
review_frequency_value |
Integer | Number of Days, Weeks, or Months. |
review_frequency_type |
String | Days, Weeks, Months |
document_expiry_reminder_value |
Integer | Number of Days, Weeks, or Months. |
document_expiry_reminder_type |
String | Days, Weeks, Months |
review_reminder_value |
Integer | Number of Days, Weeks, or Months. |
review_reminder_type |
String | Days, Weeks, Months |
reminder_users |
String | Set which users to send reminders to. |
onboarding_mode |
String | How the individual was onboarded. |
sign_up_date |
Date | Date the individual signed up. |
new_client |
Boolean | Whether the individual is the new customer. |
monthly_transaction_volume |
String | Monthly transaction volume of the individual. |
monthly_transaction_frequency |
String | Monthly transaction frequency of the individual. |
average_transaction_amount |
String | Average transaction amount of the individual. |
product_complexity |
String | Complexity and implied risk of the product transacted with the individual. |
networth |
String | Networth of the individual. |
createAndScreen |
Boolean | True = Create and screen, False = Create only |
assessment |
String | Recommended, Not Recommended |
assessor |
String | id of Assessor |
approver |
String | id of Approver |
pep |
String | Yes, No, Related to PEP |
pep_role |
String | Role of PEP |
pep_status |
String | Active, Inactive |
pep_type |
String | Domestic, Foreign, Family Member of PEP, Associate of PEP |
pep_country |
String | Country of the PEP role. |
pep_start_end |
Date | Start and end date of the PEP role in yyyy-mm-dd format. |
source_of_funds |
String | Source of funds. |
source_of_wealth |
String | Source of wealth. |
business_relationship |
String | Business relationship. |
case_group |
String | Case group as defined by the user. |
status |
String | Processing, Approved, Rejected |
risk |
String | Low, Medium, High, Unrated |
Create corporate case
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/cases/corporate' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"custom_case_id": "C123456788",
"legal_name": "Sunray Company Private Limited",
"status": "approved",
"risk": "low",
"country_of_incorporation": "SGP",
"createAndScreen": true,
"screen_parameters": [
{
"included_country": true,
"match_strength": "strong"
}
],
"related_entities": [
{
"case_id": "6b6df5f4-e80a-49ed-826c-d2a96977ed6e",
"relationship": "R1",
"appointment_date": "2024-09-15",
"number_of_shares": 2323,
"share_currency": "SGD",
"shareholding": 0.25
}
]
}'
JSON Response:
{
"case_id": "5712126f-dea7-499f-b8c2-01c34128e5c4"
}
POST /cases/corporate
This endpoint creates a new case of a corporate.
Post Parameters
All parameters are optional except for legal_name.
| Parameter | Type | Description |
|---|---|---|
legal_name (required) |
String | Legal name of the corporate. |
custom_case_id |
String | You can specify a unique reference ID for this case, or leave it empty to generate a new, random custom_case_id. |
group_id |
String | Cases belonging to a specific group. |
former_name |
String | Formerly used name of the corporate. |
trading_name |
String | Trading or operating name of the corporate. |
corporate_type |
Code Table | Type of company (e.g. Private or Public) |
registration_no |
String | Registration no of the corporate. |
date_of_incorporation |
Date | Date of incorporation in yyyy-mm-dd format. |
country_of_incorporation |
String | Country of incorporation in ISO 3166 format. |
registered_address |
String | Registered address of the corporate |
registered_postal_code |
Integer | Postal code of the registered address. |
registered_country |
String | Registered country of the corporate. |
operating_address |
String | Operating address of the corporate |
operating_postal_code |
Integer | Postal code of the registered address. |
operating_country |
String | Registered country of the corporate. |
contact_no |
Integer | Contact number, including country code. |
email |
String | Email address. |
kyc_comment |
String | KYC comments for this case. |
risk_score_enable |
Boolean | Toggle settings for risk scoring. |
nature_of_business |
String | Nature of the primary business of the corporate. |
industry |
Code Table | Primary business activity of the corporate. |
secondary_activity |
Code Table | Secondary business activity of the corporate. |
entity_status |
String | Status of the corporate. |
no_of_charges |
String | Number of charges of the corporate. |
account_due_date |
Date | Due date of the corporate's accounts. |
annual_return_date |
Date | Annual return date of the corporate. |
nominee_directors |
Boolean | Whether the corporate has nominee directors. |
layers_of_ownership |
Code Table | Number of layers of ownership of the corporate. |
staff_strength |
Code Table | Number of staff of the corporate. |
contact_person |
String | Main contact person of the corporate. |
website |
String | Website of the corporate. |
countries_of_operations |
String | 1 or more countries that the corporate operates in. |
ongoing_monitoring |
Boolean | Toggle settings for ongoing monitoring in the array for screening parameters. |
included_country |
Boolean | Toggle inclusion of Country of Incorporation in the array for screening parameters. |
monitoring_frequency_value |
Integer | Number of Days, Weeks, or Months in the array for screening parameters. |
monitoring_frequency_type |
String | Days, Weeks, Months in the array for screening parameters. |
review_starting_from |
Date | Date to begin review frequency. |
review_frequency_value |
Integer | Number of Days, Weeks, or Months. |
review_frequency_type |
String | Days, Weeks, Months |
document_expiry_reminder_value |
Integer | Number of Days, Weeks, or Months. |
document_expiry_reminder_type |
String | Days, Weeks, Months |
review_reminder_value |
Integer | Number of Days, Weeks, or Months. |
review_reminder_type |
String | Days, Weeks, Months |
reminder_users |
String | Set which users to send reminders to. |
onboarding_mode |
String | How the corporate was onboarded. |
sign_up_date |
Date | Date the corporate signed up. |
new_client |
Boolean | Whether the corporate is the new client. |
location |
Code Table | Location of the corporate's operating premise. |
monthly_transaction_volume |
Float | Monthly transaction volume of the corporate. |
monthly_transaction_frequency |
Float | Monthly transaction frequency of the corporate. |
average_transaction_amount |
Float | Average transaction amount of the corporate. |
product_complexity |
Integer | Complexity and implied risk of the product transacted with the corporate. |
createAndScreen |
Boolean | True = Create and screen, False = Create only |
assessment |
String | Recommended, Not Recommended |
assessor |
String | id of Assessor |
approver |
String | id of Approver |
business_relationship |
String | Business relationship. |
case_group |
String | Case group as defined by the user. |
status |
String | Processing, Approved, Rejected, Review, Pending |
risk |
String | Low, Medium, High, Prohibited, Unrated |
Code tables
Use these codes for id_type, occupation, onboarding_mode, source_of_wealth, corporate_type, layers_of_ownership, staff_strength, industry, and relationship. Any values not found in the code table will be stored as a custom value.
ID Type
| Parameter | Code |
|---|---|
National ID |
ID1 |
Driver's license |
ID2 |
NRIC (pink) |
ID3 |
NRIC (blue) |
ID4 |
Passport |
ID5 |
Employment pass |
ID6 |
Personalised employment pass |
ID7 |
Work permit |
ID8 |
S pass |
ID9 |
Dependent's pass |
ID10 |
Visit pass |
ID11 |
Long term visit pass |
ID12 |
Student pass |
ID13 |
Entrepass |
ID14 |
State ID |
ID15 |
Military ID |
ID16 |
ID Expiry
| Parameter | Code |
|---|---|
< 30 |
IDE1 |
31 to 60 |
IDE2 |
61 to 120 |
IDE3 |
121 to 270 |
IDE4 |
271 to 360 |
IDE5 |
361 to 540 |
IDE6 |
541 to 720 |
IDE7 |
721 to 1080 |
IDE8 |
1081 to 1440 |
IDE9 |
1441 to 1800 |
IDE10 |
> 1800 |
IDE11 |
Occupation
| Parameter | Code |
|---|---|
Accounting |
A1 |
Administrative |
A2 |
Board of Directors |
B1 |
Compliance department |
C1 |
Customer service |
C2 |
Diplomat |
D1 |
Domestic Worker |
D2 |
Engineer |
E1 |
Executive and C-Level |
E2 |
Finance |
F1 |
Human Resources |
H1 |
Information Technology |
I1 |
Intern |
I2 |
Junior Civil Servant |
J1 |
Junior Management |
J2 |
Legal |
L1 |
Marketing |
M1 |
Middle Management |
M2 |
Operations |
O1 |
Procurement |
P1 |
Retiree |
R1 |
Sales |
S1 |
Senior Civil Servant |
S2 |
Senior Management |
S3 |
Student |
S4 |
Support Staff |
S5 |
Teacher |
T1 |
Technician |
T2 |
Unemployed |
U1 |
Onboarding Mode
| Parameter | Code |
|---|---|
In person |
O1 |
Myinfo |
O2 |
Digital verification |
O3 |
Video call |
O4 |
Phone call |
O5 |
Mobile app |
O6 |
Web app |
O7 |
Email |
O8 |
Source of Wealth
| Parameter | Code |
|---|---|
Revenue |
S1 |
Loan |
S2 |
Equity |
S3 |
Grant |
S4 |
Donation |
S5 |
Recurring salary |
S6 |
Freelance salary |
S7 |
Rent income |
S8 |
Investment |
S9 |
Pension |
S10 |
Inheritance |
S11 |
Family support |
S12 |
Corporate Type
| Parameter | Code |
|---|---|
Exempt Private Company Limited by Shares |
E1 |
Private Company Limited by Shares |
E2 |
Public Company Limited by Shares |
E3 |
Public Company Limited by Guarantee |
E4 |
Unlimited Exempt Private Company |
E5 |
Unlimited Private Company |
E6 |
Unlimited Public Company |
E7 |
Foreign Company Registered Locally |
E8 |
Foreign Company Registered Overseas |
E9 |
Sole Proprietorship |
E10 |
Partnership |
E11 |
Unregistered Local Entity |
E12 |
Unregistered Foreign Entity |
E13 |
Limited Liability Partnerships (LLP) |
E14 |
Foreign Military Units |
E15 |
State Owned Entity |
E16 |
Government Agencies and Bodies |
E17 |
Management Corporations |
E18 |
Representative Office |
E19 |
Trade Unions |
E20 |
Variable Capital Company |
E21 |
Layers of Ownership
| Parameter | Code |
|---|---|
0 |
L1 |
1 |
L2 |
2 |
L3 |
3 |
L4 |
4 |
L5 |
5 or more |
L6 |
Unknown |
L7 |
Duration of Incorporation
| Parameter | Code |
|---|---|
< 30 days |
IN1 |
31 to 60 days |
IN2 |
61 to 120 days |
IN3 |
121 to 270 days |
IN4 |
271 to 360 days |
IN5 |
361 to 540 days |
IN6 |
541 to 720 days |
IN7 |
721 to 1080 days |
IN8 |
1081 to 1440 days |
IN9 |
1441 to 1800 days |
IN10 |
> 1800 |
IN11 |
Duration as Client
| Parameter | Code |
|---|---|
< 30 days |
DS1 |
31 to 60 days |
DS2 |
61 to 120 days |
DS3 |
121 to 270 days |
DS4 |
271 to 360 days |
DS5 |
361 to 540 days |
DS6 |
541 to 720 days |
DS7 |
721 to 1080 days |
DS8 |
1081 to 1440 days |
DS9 |
1441 to 1800 days |
DS10 |
> 1800 days |
DS11 |
Networth
| Parameter | Code |
|---|---|
< 10,000 |
NW1 |
10,000 to 100,000 |
NW2 |
100,001 to 300,000 |
NW3 |
300,001 to 500,000 |
NW4 |
500,001 to 1,000,000 |
NW5 |
1M to 5M |
NW6 |
5M to 10M |
NW7 |
10M to 50M |
NW8 |
50M to 100M |
NW9 |
> 100M |
NW10 |
Staff Strength
| Parameter | Code |
|---|---|
Sole proprietor |
SS1 |
1 - 10 |
SS2 |
11 - 50 |
SS3 |
51 - 200 |
SS4 |
201 - 500 |
SS5 |
501 - 1,000 |
SS6 |
1,001 - 5,000 |
SS7 |
5,000 - 10,000 |
SS8 |
> 10,000 |
SS9 |
Location
| Parameter | Code |
|---|---|
Central Business District |
L1 |
Residential Area |
L2 |
Government Premise |
L3 |
Tourist Hotspot |
L4 |
Trade Zone |
L5 |
Near Airport or Port |
L6 |
Crime Hotspot |
L7 |
International Border |
L8 |
Industry
| Parameter | Code |
|---|---|
Accommodation |
A1 |
Accounting and audit |
A2 |
Administrative, office support and other business support |
A3 |
Advertising and market research |
A4 |
Agriculture |
A5 |
Air transport |
A6 |
Architectural and engineering |
A7 |
Art dealing, antiques, and galleries |
A8 |
Automobile dealerships |
A9 |
Banking |
B1 |
Bars, nightclubs, and entertainment venues |
B2 |
Cafes, restaurants, and eateries |
C1 |
Charitable and non-profit organisations |
C2 |
Chemical products |
C3 |
Civil and government services |
C5 |
Civil engineering |
C4 |
Cleaning and landscape maintenance |
C6 |
Computer programming |
C7 |
Computer, electronic and optical products |
C8 |
Construction of buildings |
C9 |
Creative, arts and entertainment |
C10 |
Cryptocurrency |
C11 |
Education |
E1 |
Employers of domestic personnel |
E2 |
Employment activities |
E3 |
Extra-territorial organisations and bodies |
E4 |
Financial service activities, except banking, insurance, pension funding, and money services |
F1 |
Fishing, operation of fish hatcheries and fish farms |
F2 |
Food and beverage products |
F3 |
Food and beverage services except cafes, restaurants, and eateries |
F4 |
Forestry and logging |
F5 |
Freight forwarders and customs brokers |
F6 |
Furniture and woodwork |
F7 |
Gambling and betting |
G1 |
Health services |
H1 |
Information service activities and online marketplaces |
I1 |
Information technology consultancy |
I2 |
Insurance, reinsurance, provident funding and pension funding |
I3 |
Land transport |
L1 |
Legal |
L2 |
Libraries, museums and cultural activities |
L3 |
Machinery and equipment |
M1 |
Management consultancy activities |
M2 |
Manufacture of apparel |
M3 |
Manufacturing of general goods |
M4 |
Media |
M5 |
Medical equipment |
M6 |
Membership organisations |
M7 |
Military |
M8 |
Mining and quarrying |
M9 |
Money services; money-changing and money-transfer |
M10 |
Motor vehicles |
M11 |
Oil and gas |
O1 |
Pawnshops |
P1 |
Pharmaceuticals and biological products |
P2 |
Postal and courier |
P3 |
Precious metals, jewelry, diamond, and gemstone |
P4 |
Printing and reproduction of recorded media |
P5 |
Public administration and defence |
P6 |
Publishing |
P7 |
Radio and television broadcasting |
R1 |
Real estate |
R2 |
Refined petroleum products |
R3 |
Religious organisations |
R4 |
Rental and leasing |
R5 |
Repair of computers, personal and household goods and vehicles |
R6 |
Residential care services |
R7 |
Retail trade of general goods |
R8 |
Retail trade of high-value and luxury goods |
R9 |
Scientific research and development |
S1 |
Security and investigation activities |
S2 |
Sewerage |
S3 |
Social services without accommodation |
S4 |
Specialised construction |
S5 |
Sports activities and amusement and recreation |
S6 |
Telecommunications |
T1 |
Tobacco |
T2 |
Travel agencies, tour operators and timesharing service |
T3 |
Utility services |
U1 |
Veterinary |
V1 |
Warehousing and support activities for transportation |
W1 |
Waste collection, treatment and disposal activities; materials recovery |
W2 |
Water collection, treatment and supply |
W3 |
Water transport |
W4 |
Wholesale trade |
W5 |
Relationship
| Parameter | Code |
|---|---|
Shareholder (Investee) |
R1 |
Investee (Shareholder) |
R2 |
Ultimate beneficial owner (UBO Investee) |
R3 |
UBO Investee (Ultimate beneficial owner) |
R4 |
Director (Board) |
R5 |
Board (Director) |
R6 |
Shareholder & Director (Investee & Board) |
R7 |
Investee & Board (Shareholder & Director) |
R8 |
Agent (Principal) |
R9 |
Principal (Agent) |
R10 |
Secretary (Company) |
R11 |
Company (Secretary) |
R12 |
Parent (Subsidiary) |
R13 |
Subsidiary (Parent) |
R14 |
Auditor (Audit Client) |
R15 |
Auditor Client (Auditor) |
R16 |
Affiliate (Affiliate) |
R17 |
Employer (Employee) |
R18 |
Employee (Employer) |
R19 |
Debtor (Creditor) |
R20 |
Creditor (Debtor) |
R21 |
Supplier (Customer) |
R22 |
Customer (Supplier) |
R23 |
Provider (Client) |
R24 |
Client (Provider) |
R25 |
Partner (Partner) |
R26 |
Spouse (Spouse) |
R27 |
Family (Family) |
R28 |
Update Cases
Update individual case
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/individual/{case_id}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}'\
-H 'Content-Type: application/json' \
-d '{
"full_name": "Alex Rogers Smith"
}'
PATCH /cases/individual/{case_id}
This endpoint updates the case of an individual.
Patch Parameters
All parameters are optional.
| Parameter | Type | Description |
|---|---|---|
full_name |
String | Full name of the individual. |
custom_case_id |
String | Unique reference ID for this case. |
group_id |
String | Cases belonging to a specific group. |
first_name |
String | First name of the individual. |
last_name |
String | Last name of the individual. |
native_name |
String | Native name (e.g. Chinese characters). |
alias |
String | Aliases of the individual. |
former_name |
String | Former names of the individual. |
ethnicity |
String | Ethnicity of the individual. |
marital_status |
String | Marital status of the individual. |
residential_address |
String | Residential address of the individual. |
residential_postal_code |
Integer | Postal code of the residential address. |
residential_country |
String | Residential country of the individual. |
contact_no |
Integer | Contact number, including country code. |
email |
String | Email address. |
nationality |
String | Nationality of the individual in ISO 3166 format |
id_type |
String | Identification document type. |
id_no |
String | Identification document number. |
id_expiry |
date | Expiry date of the identification in yyyy-mm-dd format. |
id_reminder |
Boolean | Toogle emails alerts to remind user for ID expiry. |
id_issuing_country |
String | Country that issued the individual's ID. |
country_of_birth |
String | Country of birth of the individual. |
dob |
date | Date of birth in yyyy-mm-dd format. |
gender |
String | Male, Female, Unknown. |
occupation |
String | Occupation |
employer |
String | Employer |
kyc_comment |
String | KYC comments for this case. |
ongoing_monitoring |
Boolean | Toggle settings for ongoing monitoring in the array for screening parameters. |
included_country |
Boolean | Toggle inclusion of Nationality in the array for screening parameters. |
included_dob |
Boolean | Toggle inclusion of Date of Birth in the array for screening parameters. |
included_gender |
Boolean | Toggle inclusion of Gender in the array for screening parameters. |
monitoring_frequency_value |
Integer | Number of Days, Weeks, or Months in the array for screening parameters. |
monitoring_frequency_type |
String | Days, Weeks, Months in the array for screening parameters. |
review_starting_from |
Date | Date to begin review frequency. |
review_frequency_value |
Integer | Number of Days, Weeks, or Months. |
review_frequency_type |
String | Days, Weeks, Months |
document_expiry_reminder_value |
Integer | Number of Days, Weeks, or Months. |
document_expiry_reminder_type |
String | Days, Weeks, Months |
review_reminder_value |
Integer | Number of Days, Weeks, or Months. |
review_reminder_type |
String | Days, Weeks, Months |
reminder_users |
String | Set which users to send reminders to. |
onboarding_mode |
String | How the individual was onboarded. |
sign_up_date |
Date | Date the individual signed up. |
new_client |
Boolean | Whether the individual is the new customer. |
monthly_transaction_volume |
String | Monthly transaction volume of the individual. |
monthly_transaction_frequency |
String | Monthly transaction frequency of the individual. |
average_transaction_amount |
String | Average transaction amount of the individual. |
product_complexity |
String | Complexity and implied risk of the product transacted with the individual. |
networth |
String | Networth of the individual. |
createAndScreen |
Boolean | True = Create and screen, False = Create only |
assessment |
String | Recommended, Not Recommended |
assessor |
String | id of Assessor |
approver |
String | id of Approver |
pep |
String | Yes, No, Related to PEP |
pep_role |
String | Role of PEP |
pep_status |
String | Active, Inactive |
pep_type |
String | Domestic, Foreign, Family Member of PEP, Associate of PEP |
pep_country |
String | Country of the PEP role. |
pep_start_end |
Date | Start and end date of the PEP role in yyyy-mm-dd format. |
source_of_funds |
String | Source of funds. |
source_of_wealth |
String | Source of wealth. |
business_relationship |
String | Business relationship. |
case_group |
String | Case group as defined by the user. |
status |
String | Processing, Approved, Rejected |
risk |
String | Low, Medium, High, Unrated |
Update corporate case
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/corporate/{case_id}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"legal_name": "Space Exploration Pte Ltd"
}'
PATCH /cases/corporate/{case_id}
This endpoint updates the case of a corporate.
Patch Parameters
All parameters are optional.
| Parameter | Type | Description |
|---|---|---|
legal_name |
String | Legal name of the corporate. |
custom_case_id |
String | Unique reference ID for this case. |
group_id |
String | Cases belonging to a specific group. |
former_name |
String | Formerly used name of the corporate. |
trading_name |
String | Trading or operating name of the corporate. |
corporate_type |
String | Type of company (e.g. Private or Public) |
registration_no |
String | Registration no of the corporate. |
date_of_incorporation |
Date | Date of incorporation in yyyy-mm-dd format. |
country_of_incorporation |
String | Country of incorporation in ISO 3166 format. |
registered_address |
String | Registered address of the corporate |
registered_postal_code |
Integer | Postal code of the registered address. |
registered_country |
String | Registered country of the corporate. |
operating_address |
String | Operating address of the corporate |
operating_postal_code |
Integer | Postal code of the registered address. |
operating_country |
String | Registered country of the corporate. |
contact_no |
Integer | Contact number, including country code. |
email |
String | Email address. |
kyc_comment |
String | KYC comments for this case. |
nature_of_business |
String | Nature of the primary business of the corporate. |
industry |
String | Description of the primary business activity of the corporate. |
entity_status |
String | Status of the corporate. |
no_of_charges |
String | Number of charges of the corporate. |
account_due_date |
Date | Due date of the corporate's accounts. |
annual_return_date |
Date | Annual return date of the corporate. |
nominee_directors |
Boolean | Whether the corporate has nominee directors. |
layers_of_ownership |
Integer | Number of layers of ownership of the corporate. |
staff_strength |
Integer | Number of staff of the corporate. |
contact_person |
String | Main contact person of the corporate. |
website |
String | Website of the corporate. |
countries_of_operations |
String | 1 or more countries that the corporate operates in. |
ongoing_monitoring |
Boolean | Toggle settings for ongoing monitoring in the array for screening parameters. |
included_country |
Boolean | Toggle inclusion of Country of Incorporation in the array for screening parameters. |
monitoring_frequency_value |
Integer | Number of Days, Weeks, or Months in the array for screening parameters. |
monitoring_frequency_type |
String | Days, Weeks, Months in the array for screening parameters. |
review_starting_from |
Date | Date to begin review frequency. |
review_frequency_value |
Integer | Number of Days, Weeks, or Months. |
review_frequency_type |
String | Days, Weeks, Months |
document_expiry_reminder_value |
Integer | Number of Days, Weeks, or Months. |
document_expiry_reminder_type |
String | Days, Weeks, Months |
review_reminder_value |
Integer | Number of Days, Weeks, or Months. |
review_reminder_type |
String | Days, Weeks, Months |
reminder_users |
String | Set which users to send reminders to. |
onboarding_mode |
String | How the corporate was onboarded. |
sign_up_date |
Date | Date the corporate signed up. |
new_client |
Boolean | Whether the corporate is the new customer. |
monthly_transaction_volume |
String | Monthly transaction volume of the corporate. |
monthly_transaction_frequency |
String | Monthly transaction frequency of the corporate. |
average_transaction_amount |
String | Average transaction amount of the corporate. |
product_complexity |
String | Complexity and implied risk of the product transacted with the corporate. |
createAndScreen |
Boolean | True = Create and screen, False = Create only |
assessment |
String | Recommended, Not Recommended |
assessor |
String | id of Assessor |
approver |
String | id of Approver |
business_relationship |
String | Business relationship. |
case_group |
String | Case group as defined by the user. |
status |
String | Processing, Approved, Rejected |
risk |
String | Low, Medium, High, Unrated |
Delete Cases
Delete a case or multiple cases
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/delete' \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json'
-d '
["case_id", "case_id"]
'
PATCH /cases/delete
This endpoint deletes a case or multiple cases.
Unlink Cases
Unlink a case or multiple cases
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/related-entities/delete \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json'
-d '[
["case_id", "case_id"], ["case_id", "case_id"]
]'
PATCH /cases/related-entities/delete
This endpoint unlinks a case or multiple cases.
Screening
Screen case entity
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/screen/{case_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"created_by": "d1ac6328-3854-4a0e-805b-d8c7110e4e6d",
"updated_by": null,
"created_at": "2024-01-29T08:50:41.789Z",
"updated_at": "2024-01-29T08:50:41.789Z",
"new_matches": 0,
"updated_profiles": 0,
"deleted_profiles": 0,
"match_ids": ["33553b35-a47e-4139-b532-4c12444e6bea"],
"matches": [
{
"match_id": "d0839de1-fe59-493f-afe6-aa09a25b56d8",
"status": "unresolved",
"profile_status": "new",
"data": {
"entityName": "Albert Einstein",
"entityType": "Individual",
"categories": ["Enforcement"],
"countries": ["SGP", "CYM"],
"overview": "Charged with forgery, fraud and money laundering - January 24, 2024.",
"prefix": "",
"suffix": "",
"primary_country": "SGP",
"gender": "Male",
"dob": "1979",
"isBlacklist": false,
"last_updated": "2024-01-29T01:50:49.767Z",
"match_id": "D0839DE1-FE59-493F-AFE6-AA09A25B56D8"
},
"created_by": "b722db11-6c28-417b-9c64-5934ebf6c9a0",
"updated_by": null,
"resolved_on": null,
"created_at": "2024-02-06T14:43:23.772Z",
"updated_at": "2024-02-06T14:43:23.772Z",
"screen_id": "a62f63ae-e71c-46b7-b8e5-6e6070be5192"
}
],
"screen_id": "a62f63ae-e71c-46b7-b8e5-6e6070be5192",
"case_id": "e67663d1-21c4-4072-aeec-17055e93a0d4",
"screen_type": "manual",
"match_summary": {
"false": 0,
"positive": 0,
"possible": 0,
"unresolved": 1
},
"screen_parameters": {
"match_strength": "medium",
"dob": null,
"gender": null,
"country": null,
"q": "Albert Einstein",
"screen_type": "manual",
"custom_case_id": "C3113470523",
"case_type": "individual",
"screen_id": "a62f63ae-e71c-46b7-b8e5-6e6070be5192"
}
}
GET /cases/screen/{case_id}
This endpoint screens the main entity of a case.
Retrieve screening archive of a case
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/screening-archive/{case_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response of a screening acrhive:
{
"data": [
{
"created_at": "2024-01-29T10:09:26.974Z",
"updated_at": "2024-01-29T10:09:26.974Z",
"match_ids": ["74a1972d-bbb4-44a6-825c-078cb3aef812"],
"created_by": "d1ac6328-3854-4a0e-805b-d8c7110e4e6d",
"updated_by": null,
"new_matches": 0,
"updated_profiles": 0,
"deleted_profiles": 0,
"matches": [
{
"created_at": "2024-01-29T10:09:26.974Z",
"updated_at": "2024-01-29T10:09:26.974Z",
"match_id": "d0839de1-fe59-493f-afe6-aa09a25b56d8",
"data": {
"dob": "1979",
"gender": "Male",
"prefix": "",
"suffix": "",
"overview": "Charged with forgery, bank fraud and money laundering - January 24, 2024.",
"countries": ["SGP", "CYM"],
"categories": ["Adverse Media", "Enforcement"],
"entityName": "Albert Einstein",
"entityType": "Individual",
"isBlacklist": false,
"last_updated": "2024-01-25T00:07:50.847Z",
"primary_country": "SGP",
"match_id": "D0839DE1-FE59-493F-AFE6-AA09A25B56D8"
},
"created_by": "d1ac6328-3854-4a0e-805b-d8c7110e4e6d",
"updated_by": null,
"screen_id": "82b84a76-1547-4567-a176-4ae786387436"
}
],
"screen_id": "82b84a76-1547-4567-a176-4ae786387436",
"case_id": "d4d03a93-1e16-45c4-9fc7-e3c4fb23d8bd",
"screen_type": "manual",
"screen_parameters": {
"q": "Albert Einstein",
"dob": null,
"gender": null,
"country": null,
"screen_type": "manual",
"match_strength": "medium",
"custom_case_id": "C2561805317",
"case_type": "individual",
"screen_id": "82b84a76-1547-4567-a176-4ae786387436"
}
}
],
"metadata": {
"total": 1
}
}
GET /cases/screening-archive/{case_id}
This endpoint retrieves the screening archive of a case.
History
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/screen-history?sort=created_at,DESC&limit={limit}&offset={offset}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"data": [
{
"case_id": "1bff98ce-2e6f-4eb8-b53c-b8e618cc1c23",
"screen_type": "manual",
"custom_case_id": "C8611851036",
"entity_name": "Gresham Insurance Company Limited",
"entity_type": "corporate",
"screen_parameters": {
"q": " Gresham Insurance Company Limited",
"country": "NOR",
"match_strength": "strong",
"custom_case_id": "C8611851036",
"entity_type": "corporate",
"screen_type": "manual",
"screen_id": "c4122d10-9c28-46a0-9879-4647f2caff4c"
},
"meta_data": {
"matches": [
{
"match_id": "4535484E-8EC4-448C-A7D0-1277A82CEAAA",
"gender": "Not Applicable",
"prefix": null,
"suffix": null,
"overview": "SOE involved in Finance/Insurance",
"countries": ["GBR", "KWT", "SGP", "NOR"],
"categories": ["SOE"],
"entityName": "Gresham Insurance Company Limited",
"entityType": "Organization",
"primary_country": "NOR"
}
]
},
"screen_id": "c4122d10-9c28-46a0-9879-4647f2caff4c",
"created_at": "2022-11-25T05:57:37.980Z",
"created_user": {
"user_id": "fe328a77-6b62-4228-979c-611fc0a45672",
"email": "user@example.com",
"full_name": "Alex William"
}
}
],
"metadata": {
"total": 50
}
}
GET /screen-history
This endpoint retrieves the screen history of all cases. Add limit to improve loading times.
| Parameter | Type | Description |
|---|---|---|
sort |
String | ASC, DESC, |
limit |
Integer | Number of results for pagination. |
offset |
Integer | Starting point of the results for pagination. |
Blacklist
Retrieve all blacklists
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/blacklist/' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"data": [
{
"blacklist_id": "c1511e84-7555-4e05-abfe-800c418d9112",
"entity_type": "corporate",
"entity_name": "Forex Metal Trading Sdn Bhd",
"category": "BNM",
"overview": "Added to Bank Negara watchlist",
"remarks": "Operating without a licence",
"nationality": "MYS",
"gender": "male",
"date_of_birth": "21-Nov-1980",
"is_active": true,
"updated_at": "2024-12-06T14:41:00.058Z",
"created_at": "2024-06-27T02:00:19.825Z"
},
{
"blacklist_id": "2b28380b-a879-4010-96d7-61e53a33aaeb",
"entity_type": "individual",
"entity_name": "Loh Kim Huat",
"category": "BNM",
"overview": "Requested by Bank Negara on 25-Mar-24",
"remarks": "Suspected money laundering",
"nationality": "MYS",
"gender": "male",
"date_of_birth": "23-Feb-1971",
"is_active": true,
"updated_at": "2024-12-06T14:41:00.327Z",
"created_at": "2024-04-04T03:54:19.124Z"
},
{
"blacklist_id": "54ae7040-217c-4a52-a66b-189e400be85b",
"entity_type": "individual",
"entity_name": "Amer Najar",
"category": "MAS",
"overview": "Requested by MAS on 25-Mar-24",
"remarks": "Suspected involvement in financial crime",
"nationality": "SG{}",
"gender": "male",
"date_of_birth": "",
"is_active": true,
"updated_at": "2024-12-06T14:40:59.989Z",
"created_at": "2024-04-04T03:54:19.124Z"
}
],
"metadata": {
"total": 3
}
}
GET /cases/blacklist
This endpoint retrieves all of your created blacklists.
Retrieve a single blacklist
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/blacklist/{blacklist_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"id": "6f8cd1c5-c6e9-4f41-ac8f-a6a4f778e736",
"entity_type": "individual",
"entity_name": "John Tan",
"category": "MAS",
"overview": "Added to MAS watchlist",
"remarks": "Suspected money laundering",
"nationality": "SGP",
"gender": "male",
"date_of_birth": "21-Nov-1990",
"is_active": true,
"updated_at": "2024-12-10T07:04:50.996Z",
"created_at": "2024-12-10T07:03:00.152Z"
}
GET /cases/blacklist/{blacklist_id}
This endpoint retrieves a single blacklist.
Create blacklist
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/cases/blacklist/' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"entity_name": "John Tan Wei Ming",
"date_of_birth": "21-Nov-1990",
"entity_type": "individual",
"category": "MAS",
"overview": "Added to MAS watchlist",
"remarks": "Operating without a licence",
"nationality": "MYS",
"gender": "male",
"is_active": true
}'
JSON Response:
{
"blacklist_id": "6f8cd1c5-c6e9-4f41-ac8f-a6a4f778e736"
}
POST /cases/blacklist
This endpoint creates a blacklist entry.
Update a blacklist entry
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/blacklist/{blacklist_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"entity_name": "John Tan Wei Ming",
"date_of_birth": "21-Nov-1990",
"entity_type": "individual",
"category": "MAS",
"overview": "Added to MAS watchlist",
"remarks": "Operating without a licence",
"nationality": "MYS",
"gender": "male",
"is_active": true
}'
PATCH /cases/blacklist/{blacklist_id}
This endpoint updates a blacklist entry.
Delete a blacklist entry
Request:
curl -X 'DELETE' \
'https://api.onehypernet.com/v1/cases/blacklist/{blacklist_id}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json'
DELETE /cases/blacklist/{blacklist_id}
This endpoint deletes a blacklist entry.
Risk Scoring
The Financial Action Task Force (FATF) recommends a risk-based approach as an effective way to combat money laundering and terrorist financing. By adopting a risk-based approach, companies should be able to ensure that measures to prevent or mitigate money laundering and terrorist financing are commensurate with the risks identified, and would enable them to make decisions on how to allocate their own resources in the most effective way. As such, you should customize the risk assessment framework according to your Internal Policies, Procedures and Controls (IPPC) or compliance policy and not rely on the default settings.
The values for the variables selected are taken from your cases and its corresponding transactions.
Retrieve Risk Models
Retrieve all risk models
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/risk-models' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"data": [
{
"risk_model_id": "df2c5481-abac-460d-96cd-900f476907e8",
"case_type": "corporate",
"active": true,
"variables_count": 46,
"created_at": "2025-05-14T06:46:09.622Z",
"created_user": {
"id": "ea553e66-8c77-4d97-8b5c-970a9992e1a1",
"email": "admin@silvermoneytransfer.com",
"full_name": "Andy Lim"
}
},
{
"risk_model_id": "7a3ffdf1-8d2c-41ef-837b-2348a155dc81",
"case_type": "individual",
"active": true,
"variables_count": 55,
"created_at": "2025-05-05T03:14:06.508Z",
"created_user": {
"id": "ea553e66-8c77-4d97-8b5c-970a9992e1a1",
"email": "admin@silvermoneytransfer.com",
"full_name": "Andy Lim"
}
}
],
"metadata": {
"total": 2
}
}
GET /rba/risk-models
This endpoint retrieves all the risk models.
Query Parameters
You can filter via these query parameters.
| Parameter | Type | Description |
|---|---|---|
| case_type | String | Individual or Corporate |
| active | Boolean | true or false |
| limit | Integer | Number of results for pagination |
Retrieve a single risk model
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/risk-models-settings?risk_model_id={risk_model_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
GET /rba/risk-models-settings?risk_model_id={risk_model_id}
This endpoint retrieves the full details of a single risk model.
Create Risk Model
Create risk model of individual
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/rba/risk-models?caseType=Individual' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
POST /rba/risk-model?caseType=Individual
This endpoint expects a complete list of risk variables with their assigned weights, scores, and activation flags. Due to the complexity and length of the payload, users are advised to first retrieve the full editable model.
GET /rba/risk-models-settings?risk_model_id={risk_model_id}
Post Parameters
Total weight must be exactly equal to 1.
| Variable Type | Variable Name | Reference |
|---|---|---|
| Geographical Risk | Nationality | Default Country Index |
| Geographical Risk | Country of Birth | Default Country Index |
| Geographical Risk | Country of Residence | Default Country Index |
| Geographical Risk | ID Issuing Country | Default Country Index |
| Geographical Risk | Nationality | Corruption Perceptions Index (CPI) |
| Geographical Risk | Country of Birth | Corruption Perceptions Index (CPI) |
| Geographical Risk | Country of Residence | Corruption Perceptions Index (CPI) |
| Geographical Risk | ID Issuing Country | Corruption Perceptions Index (CPI) |
| Geographical Risk | Nationality | FATF Synthetic Index |
| Geographical Risk | Country of Birth | FATF Synthetic Index |
| Geographical Risk | Country of Residence | FATF Synthetic Index |
| Geographical Risk | ID Issuing Country | FATF Synthetic Index |
| Geographical Risk | Nationality | Financial Secrecy Index (FSI) |
| Geographical Risk | Country of Birth | Financial Secrecy Index (FSI) |
| Geographical Risk | Country of Residence | Financial Secrecy Index (FSI) |
| Geographical Risk | ID Issuing Country | Financial Secrecy Index (FSI) |
| Geographical Risk | Nationality | Basel Institute on Governance Anti-Money Laundering Index |
| Geographical Risk | Country of Birth | Basel Institute on Governance Anti-Money Laundering Index |
| Geographical Risk | Country of Residence | Basel Institute on Governance Anti-Money Laundering Index |
| Geographical Risk | ID Issuing Country | Basel Institute on Governance Anti-Money Laundering Index |
| Client Risk | Industry | Industry Index |
| Client Risk | Occupation | Occupation Index |
| Client Risk | Duration as Client | Client Risk Index |
| Client Risk | New Client | Client Risk Index |
| Client Risk | ID Expiry | Client Risk Index |
| Client Risk | ID Uploaded | Client Risk Index |
| Client Risk | ID Type | Client Risk Index |
| Client Risk | Networth | Client Risk Index |
| Operational Risk | Onboarding Mode | Operational Risk Index |
| Operational Risk | Source of Wealth | Operational Risk Index |
| Operational Risk | Product Complexity | Product Complexity |
| Client Risk | Related Entities | Cases |
| Transactional Risk | Transaction Mode | Transaction Risk Index |
| Transactional Risk | Payment Mode | Transaction Risk Index |
| Transactional Risk | Source of Funds | Transaction Risk Index |
| Transactional Risk | Purpose of Transaction | Transaction Risk Index |
| Transactional Risk | Beneficial Owner | Transaction Risk Index |
| Transactional Risk | Currency | Currency Index |
| Transactional Risk | Behaviour | Transaction Risk Index |
| Transactional Risk | Average Transaction Amount | Transaction Risk Index |
| Transactional Risk | Monthly Transaction Volume | Transaction Risk Index |
| Transactional Risk | Monthly Transaction Frequency | Transaction Risk Index |
| Screening Risk | Adverse Media | Screening Index |
| Screening Risk | Enforcement | Screening Index |
| Screening Risk | Primary PEP | Screening Index |
| Screening Risk | Secondary PEP | Screening Index |
| Screening Risk | Sanctions | Screening Index |
| Screening Risk | SOE | Screening Index |
| Screening Risk | Associated Entity | Screening Index |
| Screening Risk | Ownership or Control | Screening Index |
| Screening Risk | SWIFT BIC Entity | Screening Index |
| Screening Risk | FATCA Reg Inst | Screening Index |
| Screening Risk | IHS OFAC Vessels | Screening Index |
| Screening Risk | IHS Reg Vessels | Screening Index |
| Screening Risk | Marijuana Reg Bus | Screening Index |
| Screening Risk | UAE MSB | Screening Index |
| Screening Risk | US MSB | Screening Index |
Create risk model of corporate
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/rba/risk-models?caseType=Corporate' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
POST /rba/risk-model?caseType=Corporate
This endpoint expects a complete list of risk variables with their assigned weights, scores, and activation flags. Due to the complexity and length of the payload, users are advised to first retrieve the full editable model.
GET /rba/risk-models-settings?risk_model_id={risk_model_id}
Post Parameters
Total weight must be exactly equal to 1.
| Type | Name | Reference |
|---|---|---|
| Geographical Risk | Country of Incorporation | Corruption Perceptions Index (CPI) |
| Geographical Risk | Operating Country | Corruption Perceptions Index (CPI) |
| Geographical Risk | Country of Incorporation | FATF Index |
| Geographical Risk | Operating Country | FATF Index |
| Geographical Risk | Country of Incorporation | Financial Secrecy Index (FSI) |
| Geographical Risk | Operating Country | Financial Secrecy Index (FSI) |
| Geographical Risk | Country of Incorporation | Basel Institute on Governance Anti-Money Laundering Index |
| Geographical Risk | Operating Country | Basel Institute on Governance Anti-Money Laundering Index |
| Client Risk | Entity Type | Client Risk Index |
| Client Risk | Industry | Industry Index |
| Client Risk | Secondary Activity | Industry Index |
| Client Risk | Duration as Client | Client Risk Index |
| Client Risk | Duration of Incorporation | Client Risk Index |
| Client Risk | Beneficial owner | Client Risk Index |
| Client Risk | New Client | Client Risk Index |
| Client Risk | Layers of Ownership | Client Risk Index |
| Client Risk | Nominee Directors | Client Risk Index |
| Client Risk | Staff Strength | Client Risk Index |
| Client Risk | Location | Client Risk Index |
| Client Risk | Related Entities | Cases |
| Operational Risk | Onboarding Mode | Operational Risk Index |
| Operational Risk | Source of Wealth | Operational Risk Index |
| Operational Risk | Product Complexity | Product Complexity |
| Transactional Risk | Transaction Mode | Transaction Risk Index |
| Transactional Risk | Payment Mode | Transaction Risk Index |
| Transactional Risk | Source of Funds | Transaction Risk Index |
| Transactional Risk | Purpose of Transaction | Transaction Risk Index |
| Transactional Risk | Beneficial Owner | Transaction Risk Index |
| Transactional Risk | Currency | Currency Index |
| Transactional Risk | Behaviour | Transaction Risk Index |
| Transactional Risk | Average Transaction Amount | Transaction Risk Index |
| Transactional Risk | Monthly Transaction Volume | Transaction Risk Index |
| Transactional Risk | Monthly Transaction Frequency | Transaction Risk Index |
| Screening Risk | Adverse Media | Screening Index |
| Screening Risk | Enforcement | Screening Index |
| Screening Risk | Primary PEP | Screening Index |
| Screening Risk | Secondary PEP | Screening Index |
| Screening Risk | Sanctions | Screening Index |
| Screening Risk | SOE | Screening Index |
| Screening Risk | Associated Entity | Screening Index |
| Screening Risk | Ownership or Control | Screening Index |
| Screening Risk | SWIFT BIC Entity | Screening Index |
| Screening Risk | FATCA Reg Inst | Screening Index |
| Screening Risk | IHS OFAC Vessels | Screening Index |
| Screening Risk | IHS Reg Vessels | Screening Index |
| Screening Risk | Marijuana Reg Bus | Screening Index |
| Screening Risk | UAE MSB | Screening Index |
| Screening Risk | US MSB | Screening Index |
Risk Score and Summary
Retrieve risk score
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/case/{case_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"variables": [
{
"variableType": "Country Risk",
"variableName": "Nationality",
"reference": "FATF Synthetic Index",
"value": "WSM",
"computedScore": 68.8,
"adjustedScore": 68.8,
"override": null,
"justification": "",
"contribution": 0.42653440793552383
},
{
"variableType": "Country Risk",
"variableName": "Country of Residence",
"reference": "FATF Synthetic Index",
"value": null,
"computedScore": null,
"adjustedScore": null,
"override": null,
"justification": "",
"contribution": null
},
{
"variableType": "Client Risk",
"variableName": "Beneficial owner",
"reference": "Binary Index",
"value": "yes",
"computedScore": 0,
"adjustedScore": 0,
"override": null,
"justification": "",
"contribution": 0
},
{
"variableType": "Client Risk",
"variableName": "New customer",
"reference": "Binary Index",
"value": "yes",
"computedScore": 100,
"adjustedScore": 100,
"override": null,
"justification": "",
"contribution": 0.15499070055796652
},
{
"variableType": "Client Risk",
"variableName": "ID type",
"reference": "Synthetic Index",
"value": "NRIC (pink)",
"computedScore": 0,
"adjustedScore": 0,
"override": null,
"justification": "",
"contribution": 0
},
{
"variableType": "Transactional Risk",
"variableName": "Transaction mode",
"reference": "Synthetic Index",
"value": "In person",
"computedScore": 0,
"adjustedScore": 0,
"override": null,
"justification": "",
"contribution": 0
},
{
"variableType": "Transactional Risk",
"variableName": "Purpose of transaction",
"reference": "Synthetic Index",
"value": "Gambling",
"computedScore": 90,
"adjustedScore": 90,
"override": null,
"justification": "",
"contribution": 0.13949163050216987
},
{
"variableType": "Transactional Risk",
"variableName": "Behaviour",
"reference": "Synthetic Index",
"value": "Shy",
"computedScore": 40,
"adjustedScore": 40,
"override": null,
"justification": "",
"contribution": 0.2479851208927464
},
{
"variableType": "Transactional Risk",
"variableName": "Remarks",
"reference": "OpenAI",
"value": "Rare item",
"computedScore": 20,
"adjustedScore": 20,
"override": null,
"justification": "",
"contribution": 0.0309981401115933
},
{
"variableType": "Screening Risk",
"variableName": "Adverse Media",
"reference": "Screening Synthetic Index",
"value": "unresolved",
"computedScore": 0,
"adjustedScore": 0,
"override": null,
"justification": "",
"contribution": 0
},
{
"variableType": "Screening Risk",
"variableName": "Enforcement",
"reference": "Screening Synthetic Index",
"value": null,
"computedScore": null,
"adjustedScore": null,
"override": null,
"justification": "",
"contribution": null
},
{
"variableType": "Screening Risk",
"variableName": "Sanctions",
"reference": "Screening Synthetic Index",
"value": null,
"computedScore": null,
"adjustedScore": null,
"override": null,
"justification": "",
"contribution": null
},
{
"variableType": "Screening Risk",
"variableName": "Primary PEP",
"reference": "Screening Synthetic Index",
"value": "positive",
"computedScore": 70,
"adjustedScore": 70,
"override": "High",
"justification": "",
"contribution": 0
},
{
"variableType": "Screening Risk",
"variableName": "Secondary PEP",
"reference": "Screening Synthetic Index",
"value": null,
"computedScore": null,
"adjustedScore": null,
"override": null,
"justification": "",
"contribution": null
}
],
"summary": {
"adjustedScore": 40.325,
"adjustedRisk": "High",
"computedScore": 40.325,
"computedRisk": "High"
},
"risk_model_id": "876skf28-26a7-4075-a30d-e26be7c7d193"
}
GET /rba/case/{case_id}
This endpoint retrieves the risk score of the case.
Adjust score of a variable
curl -X 'POST' \
'https://api.onehypernet.com/v1/rba/case/{case_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"variableType": "Country Risk",
"variableName": "Nationality",
"reference": "FATF Synthetic Index",
"adjustedScore": 10,
"justification": "same operating country"
}'
POST /rba/case/{case_id}
This endpoint adjusts the score of the risk variable.
Retrieve risk score archive
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/case/{case_id}/risk-score-archive' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
JSON Response:
{
"data": [
{
"risk_score_id": "80e2e2bf-aafe-4f7c-baec-bb10ebc9a2cf",
"risk_model_id": "876dcf28-26a7-4075-a30d-e26be7c7d193",
"adjusted_score": 31,
"adjusted_risk": "Medium",
"computed_score": 31,
"computed_risk": "Medium",
"created_at": "2025-05-31T02:30:37.076Z"
},
{
"risk_score_id": "05b137fb-20f6-470e-8201-725ff08e23d5",
"risk_model_id": "876dcf28-26a7-4075-a30d-e26be7c7d193",
"adjusted_score": 27,
"adjusted_risk": "Medium",
"computed_score": 27,
"computed_risk": "Medium",
"created_at": "2025-05-31T02:30:00.271Z"
}
],
"total": 2
}
GET /rba/case/{case_id}/risk-score-archive
This endpoint retrieves the risk score archive of a case.
Retrieve a specific risk score archive
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/risk-score-archive/{risk_score_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
JSON Response:
{
"risk_score_id": "80e2e2bf-aafe-4f7c-baec-bb10ebc9a2cf",
"case_id": "8b75b31f-9559-4b13-889d-1d454b339159",
"risk_model_id": "876dcf28-26a7-4075-a30d-e26be7c7d193",
"adjusted_score": 31,
"adjusted_risk": "Medium",
"computed_score": 31,
"computed_risk": "Medium",
"breakdown": [
{
"value": "Default Score",
"override": null,
"reference": "Default Country Index",
"contribution": 0.2603415559772296,
"variableName": "Nationality",
"variableType": "Geographical Risk",
"adjustedScore": 70,
"computedScore": 70
},
{
"value": "Default Score",
"override": null,
"reference": "Occupation Index",
"contribution": 0.13946869070208728,
"variableName": "Occupation",
"variableType": "Client Risk",
"adjustedScore": 50,
"computedScore": 50
},
{
"value": "31-May-2025",
"override": null,
"reference": "Client Risk Index",
"contribution": null,
"variableName": "Duration as Client",
"variableType": "Client Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": "Yes",
"override": "",
"reference": "Client Risk Index",
"contribution": 0.27893738140417457,
"variableName": "New Client",
"variableType": "Client Risk",
"adjustedScore": 100,
"computedScore": 100,
"justification": ""
},
{
"value": "Default Score",
"override": null,
"reference": "Client Risk Index",
"contribution": 0.13946869070208728,
"variableName": "ID Type",
"variableType": "Client Risk",
"adjustedScore": 50,
"computedScore": 50
},
{
"value": "Default Score",
"override": null,
"reference": "Operational Risk Index",
"contribution": 0.1859582542694497,
"variableName": "Onboarding Mode",
"variableType": "Operational Risk",
"adjustedScore": 50,
"computedScore": 50
},
{
"value": null,
"override": null,
"reference": "Transaction Risk Index",
"contribution": null,
"variableName": "Average Transaction Amount",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": null,
"override": null,
"reference": "Transaction Risk Index",
"contribution": null,
"variableName": "Monthly Transaction Volume",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": null,
"override": null,
"reference": "Transaction Risk Index",
"contribution": null,
"variableName": "Monthly Transaction Frequency",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": null,
"override": null,
"reference": "Transaction Risk Index",
"contribution": null,
"variableName": "Payment Mode",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": null,
"override": null,
"reference": "Currency Index",
"contribution": null,
"variableName": "Currency",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": null,
"override": null,
"reference": "Transaction Risk Index",
"contribution": null,
"variableName": "Transaction Mode",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": null,
"override": null,
"reference": "Transaction Risk Index",
"contribution": null,
"variableName": "Purpose of Transaction",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": null,
"override": null,
"reference": "Transaction Risk Index",
"contribution": null,
"variableName": "Source of Funds",
"variableType": "Transactional Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": "No matches",
"override": null,
"reference": "Screening Index",
"contribution": null,
"variableName": "Adverse Media",
"variableType": "Screening Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": "No matches",
"override": null,
"reference": "Screening Index",
"contribution": null,
"variableName": "Enforcement",
"variableType": "Screening Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": "No matches",
"override": null,
"reference": "Screening Index",
"contribution": null,
"variableName": "Sanctions",
"variableType": "Screening Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": "No matches",
"override": null,
"reference": "Screening Index",
"contribution": null,
"variableName": "Primary PEP",
"variableType": "Screening Risk",
"adjustedScore": null,
"computedScore": null
},
{
"value": "No matches",
"override": null,
"reference": "Screening Index",
"contribution": null,
"variableName": "Secondary PEP",
"variableType": "Screening Risk",
"adjustedScore": null,
"computedScore": null
}
],
"created_at": "2025-05-31T02:30:37.076Z"
}
GET /rba/risk-score-archive/{risk_score_id}
This endpoint retrieves the a specific risk score archive of a case.
Generate AI summary
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/case/{case_id}/summary' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
JSON Response:
{
"summary": "Nationality: The high risk score of 90 indicates that the customer's nationality poses a significant risk factor. Non-Singaporean nationalities typically increase the risk due to challenges in verifying the customer's identity and background, especially in cross-border transactions. Different countries have varying levels of compliance with international standards set by organizations like FATF, which can impact the overall risk level associated with customers from those countries.\n\nCountry of Residence: As the country of residence is not provided in this case, it is assumed to be non-Singaporean. This lack of information increases the risk as it adds complexity to verifying the customer's identity and conducting due diligence checks. Depending on the country of residence, there may be additional challenges related to regulatory compliance and anti-money laundering measures.\n\nSummary: The overall risk assessment for this pawn transaction is classified as high risk, with a score of 96. The primary contributing factor to this high risk level is the customer's non-Singaporean nationality, which presents challenges in verification and due diligence processes. Additionally, the absence of information regarding the customer's country of residence further complicates risk assessment and regulatory compliance efforts."
}
GET /rba/case/{case_id}/summary
This endpoint triggers our AI model to generate a risk assessment summary of the case.
Transactions
You may tag the originator or beneficiary as a Case or a Non-Case, but every transaction must include at least one Case. A transaction cannot exist with only Non-Cases.
Retrieve Transactions
Retrieve all transactions
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/kyc/transactions' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response for One Transaction:
{
"data": [
{
"fx_rate": "1.2234",
"created_at": "2025-11-17T13:48:18.384Z",
"updated_at": "2025-11-17T13:48:18.384Z",
"originator": {
"originator_id": "90f995ce-a7b9-4e06-bd3b-edd4e66df0ad",
"originator_type": "case",
"originator_custom_id": "C8652460405",
"originator_name": "William Lee Soon Heng",
"originator_entity_type": "individual"
},
"beneficiary": {
"beneficiary_id": "8f1c0275-0fde-453b-bc02-0b9cf1ba8585",
"beneficiary_type": "non-case",
"beneficiary_custom_id": "S8904555065",
"beneficiary_name": "Maggie Smith",
"beneficiary_entity_type": "individual"
},
"transaction_date": "2024-10-20T06:29:29.000Z",
"lcy_currency": "SGD",
"total_lcy_amount": "25234.23",
"fcy_currency": "USD",
"total_fcy_amount": "20626.31",
"transaction_status": "pending",
"transaction_id": "85999593-2dd5-4637-ad46-9909fe8f88b3",
"custom_transaction_id": "T85999593",
"transaction_type": "TY6"
},
{
"fx_rate": null,
"created_at": "2025-11-17T13:47:59.755Z",
"updated_at": null,
"originator": {
"originator_id": "90f995ce-a7b9-4e06-bd3b-edd4e66df0ad",
"originator_type": "case",
"originator_custom_id": "C8652460405",
"originator_name": "William Lee Soon Heng",
"originator_entity_type": "individual"
},
"beneficiary": null,
"transaction_date": "2024-10-20T06:29:29.000Z",
"lcy_currency": "SGD",
"total_lcy_amount": "200",
"fcy_currency": null,
"total_fcy_amount": "0.00000000",
"transaction_status": "cleared",
"transaction_id": "a7e303bd-b608-41e1-a29f-0c34d488b34a",
"custom_transaction_id": "TA7E303BD",
"transaction_type": "TY6"
}
],
"metadata": {
"total": 2
}
}
GET /kyc/transactions
This endpoint retrieves all transactions. Add a limit to improve loading times.
| Parameter | Type | Description |
|---|---|---|
limit |
Integer | Number of results for pagination. |
offset |
Integer | Starting point of the results for pagination. |
sort |
String | ASC or DESC. |
Filter Parameters
You can filter search results with these parameters using the $in operator.
| Parameter | Type | Description |
|---|---|---|
transaction_id |
String | Unique system reference ID of the transaction. |
custom_transaction_id |
String | Unique custom reference ID of the transaction. |
transaction_status |
String | Status of the transaction. |
originator_id |
String | case_id or non-case_id of the originator. |
beneficiary_id |
String | case_id or non-case_id of the beneficiary. . |
transaction_type |
String | Type of transaction. |
lcy_currency |
String | Local currency of the transaction in ISO 4217 format. |
fcy_currency |
String | Local currency of the transaction in ISO 4217 format. |
transaction_mode |
String | Mode of the transaction. |
purpose_of_transaction |
String | Purpose of the transaction. |
transaction_behavior |
String | Behavior of the client during the transaction. |
transaction_beneficial_owner |
Boolean | Whether the client is the beneficial owner of the transaction. |
You can also filter search results based on range parameters using the $lte and $gte operators.
| Range Parameter | Type | Description |
|---|---|---|
total_lcy_amount |
String | Total amount of the transaction in local currency. |
total_fcy_amount |
String | Total amount of the transaction in foreign currency. |
transaction_date |
String | Date of the transaction. |
created_at |
String | Date created. |
updated_at |
String | Date updated. |
Sort Parameters
You can sort search results with these parameters.
| Parameter | Type | Description |
|---|---|---|
transaction_date |
String | ASC or DESC. |
created_at |
String | ASC or DESC. |
updated_at |
String | ASC or DESC. |
total_lcy_amount |
String | ASC or DESC. |
total_fcy_amount |
String | ASC or DESC. |
Retrieve a transaction
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/kyc/transactions/{transaction_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"created_at": "2025-11-24T15:20:34.014Z",
"updated_at": "2025-11-24T15:20:34.014Z",
"custom_transaction_id": "TX12232343",
"fx_rate": "1.23234000",
"payment_mode": "PY2",
"payment_bank": "JP Morgan Chase",
"payment_account_number": "0293458233",
"payment_card": "VISA",
"payment_card_hash": "a94af1b3c9f4d50e8c9bb776b81234fe",
"payment_card_bin": "412345",
"session_ip_address": "203.0.113.45",
"session_device": "iPhone 16 Max Pro",
"session_ip_country": "SG",
"session_device_hash": "devicehash_49f0b12a88c5448e9d90",
"session_vpn": false,
"originator": {
"originator_id": "4e0ef1a1-5e6c-4c6d-95d9-634323bdd4eb",
"originator_type": "case",
"originator_custom_id": "C8735519284",
"originator_name": "Zachariah Valentine",
"originator_entity_type": "individual"
},
"beneficiary": {
"beneficiary_id": "66e64993-9845-466c-bdad-ffc47da6e4be",
"beneficiary_type": "case",
"beneficiary_custom_id": "C1296117358",
"beneficiary_name": "Rayden Williamson",
"beneficiary_entity_type": "individual"
},
"items": [
{
"item_id": "e981d646-70c1-4838-b3bb-18d33a22c2cf",
"item": "Steel Components",
"category": "Industrial",
"quantity": "120.00000000",
"rate": "50.00000000",
"lcy_amount": "6000.00000000",
"fcy_amount": null
},
{
"item_id": "4328125f-15bc-4685-b133-b11d2f669c22",
"item": "Packaging Materials",
"category": "Manufacturing",
"quantity": "200.00000000",
"rate": "15.50000000",
"lcy_amount": "3100.00000000",
"fcy_amount": null
}
],
"agent": true,
"relationship": "R1",
"fcy_currency": "USD",
"lcy_currency": "SGD",
"total_lcy_amount": "9100.00000000",
"total_fcy_amount": "0.00000000",
"transaction_date": "2025-11-11T09:35:58.000Z",
"transaction_status": "cleared",
"transaction_id": "858035f7-ae70-43ea-aa68-b57bd0b26df6",
"transaction_mode": "T2",
"purpose_of_transaction": "PT2",
"transaction_remarks": "Urgent processing requested",
"transaction_behavior": "B2",
"transaction_beneficial_owner": true,
"transaction_type": "TY6",
"transaction_description": "Payment for industrial materials under Invoice #INV-2045",
"transaction_source_of_funds": "SF3"
}
GET /kyc/transactions/{transaction_id}
This endpoint retrieves a specific transaction.
Create Transaction
Create a transaction
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/kyc/transactions' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
{
"custom_transaction_id": "TX12345",
"originator_id": "4e0ef1a1-5e6c-4c6d-95d9-634323bdd4eb",
"originator_type": "case",
"beneficiary_id": "66e64993-9845-466c-bdad-ffc47da6e4be",
"beneficiary_type": "case",
"transaction_type": "TY6",
"transaction_description": "Payment for industrial materials under Invoice #INV-2045",
"lcy_currency": "SGD",
"fcy_currency": "USD",
"fx_rate": "1.23234",
"payment_mode": "PY2",
"transaction_source_of_funds": "SF3",
"purpose_of_transaction": "PT2",
"transaction_remarks": "Urgent processing requested",
"transaction_behavior": "B2",
"transaction_beneficial_owner": true,
"payment_bank": "JP Morgan Chase",
"payment_account_number": "0293458233",
"payment_card": "VISA",
"payment_card_hash": "a94af1b3c9f4d50e8c9bb776b81234fe",
"payment_card_bin": "412345",
"session_ip_address": "203.0.113.45",
"session_device": "iPhone 16 Max Pro",
"session_ip_country": "SG",
"session_device_hash": "devicehash_49f0b12a88c5448e9d90",
"session_vpn": false,
"items": [
{
"item": "Steel Components",
"category": "Industrial",
"quantity": "120.00000000",
"rate": "50.00000000",
"lcy_amount": "6000.00000000",
"fyc_amount": "0.00000000"
},
{
"item": "Packaging Materials",
"category": "Manufacturing",
"quantity": "200.00000000",
"rate": "15.50000000",
"lcy_amount": "3100.00000000",
"fyc_amount": "0.00000000"
}
],
"transaction_date": "2025-11-11T09:35:58.000Z",
"lcy_amount": 220,
"transaction_mode": "T2"
}
'
JSON Response:
{
"transaction_id": "d2bc00b3-7b93-416f-a666-7f927ac834d5"
}
POST /kyc/transactions
This endpoint creates a single transaction.
Code tables
Use these codes for transaction_status, transaction_type, transaction_mode, purpose_of_transaction, payment_mode, transaction_source_of_funds, transaction_behavior. Any values not found in the code table will be stored as a custom value.
Transaction Status
| Parameter | Code |
|---|---|
Pending |
Pending |
Cleared |
Cleared |
Suspended |
Suspended |
Declined |
Declined |
Refunded |
Refunded |
Transaction Type
| Parameter | Code |
|---|---|
Buy |
TY1 |
Sell |
TY2 |
Deposit |
TY3 |
Withdraw |
TY4 |
Transfer - Local |
TY5 |
Transfer - Overseas |
TY6 |
Payment |
TY7 |
Refunded |
TY8 |
Cancelled |
TY9 |
Transaction Mode
| Parameter | Code |
|---|---|
In person |
T1 |
Video call |
T2 |
Phone call |
T3 |
Mobile app |
T4 |
Web app |
T5 |
Email |
T6 |
Purpose of Transaction
| Parameter | Code |
|---|---|
Medical |
PT1 |
Debt repayment |
PT2 |
Education |
PT3 |
Renovation |
PT4 |
Travel |
PT5 |
Wedding |
PT6 |
Consumer goods |
PT7 |
Utilities |
PT8 |
Vehicle |
PT9 |
Legal fees |
PT10 |
Payment Mode
| Parameter | Code |
|---|---|
Bank Transfer (Self) |
PY1 |
Bank Transfer (Domestic) |
PY2 |
Bank Transfer (International) |
PY3 |
Credit Card |
PY4 |
Debit Card |
PY5 |
E-Wallet (Regulated) |
PY6 |
E-Wallet (Unregulated) |
PY7 |
Cryptocurrency (Regulated) |
PY8 |
Cryptocurrency (Unregulated) |
PY9 |
Cash |
PY10 |
Cheqeue |
PY11 |
Prepaid Cards (Identified) |
PY12 |
Prepaid Card (Annoymous) |
PY13 |
Source of Funds
| Parameter | Code |
|---|---|
Revenue |
SF1 |
Loan |
SF2 |
Equity |
SF3 |
Grant |
SF4 |
Donation |
SF55 |
Recurring Salary |
SF6 |
Freelance Salary |
SF7 |
Rent Income |
SF8 |
Investment |
SF9 |
Pension |
SF10 |
Inheritance |
SF11 |
Family |
SF12 |
Commissions |
SF13 |
Gambling winnings |
SF14 |
Behavior of Client
| Parameter | Code |
|---|---|
Friendly |
B1 |
Relaxed |
B2 |
Arrogant |
B3 |
Emotional |
B4 |
Shy |
B5 |
Sad |
B6 |
Courteous |
B7 |
Rough |
B8 |
Abnormal |
B9 |
Update Transactions
Update a transaction
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/kyc/transactions/{transaction_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"custom_transaction_id": "TX123345",
"originator_id": "4e0ef1a1-5e6c-4c6d-95d9-634323bdd4eb",
"originator_type": "case",
"beneficiary_id": "66e64993-9845-466c-bdad-ffc47da6e4be",
"beneficiary_type": "case",
"transaction_type": "TY6",
"transaction_description": "Payment for industrial materials under Invoice #INV-2045",
"lcy_currency": "SGD",
"fcy_currency": "USD",
"fx_rate": "1.23234",
"payment_mode": "PY2",
"transaction_source_of_funds": "SF3",
"purpose_of_transaction": "PT2",
"transaction_remarks": "Urgent processing requested",
"transaction_behavior": "B2",
"transaction_beneficial_owner": true,
"payment_bank": "JP Morgan Chase",
"payment_account_number": "0293458233",
"payment_card": "VISA",
"payment_card_hash": "a94af1b3c9f4d50e8c9bb776b81234fe",
"payment_card_bin": "412345",
"session_ip_address": "203.0.113.45",
"session_device": "iPhone 16 Max Pro",
"session_ip_country": "SG",
"session_device_hash": "devicehash_49f0b12a88c5448e9d90",
"session_vpn": false,
"items": [
{
"item": "Steel Components",
"category": "Industrial",
"quantity": "120.00000000",
"rate": "50.00000000",
"lcy_amount": "6000.00000000",
"fyc_amount": "0.00000000"
},
{
"item": "Packaging Materials",
"category": "Manufacturing",
"quantity": "200.00000000",
"rate": "15.50000000",
"lcy_amount": "3100.00000000",
"fyc_amount": "0.00000000"
}
],
"transaction_date": "2025-11-11T09:35:58.000Z",
"lcy_amount": 220,
"transaction_mode": "T2"
}'
PATCH /kyc/transactions/{transaction_id}
This endpoint updates a single transaction.
Delete Transactions
Delete a transaction
Request:
curl -X 'DELETE' \
'https://api.onehypernet.com/v1/kyc/transactions/{transaction_id}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}'
DELETE /cases/kyc/transactions/{transaction_id}
This endpoint deletes a transaction and all its data.
Matches
Retrieve a match
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/match/{screen_id}/{match_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"EntityGUID": "4535484E-8EC4-448C-A7D0-1277A82CEAAA",
"EntityTypeDesc": "Organization",
"Gender": "Not Applicable",
"Name": "Grand Company Limited",
"FirstName": null,
"MiddleName": null,
"LastName": "Grand Insurance Company Limited",
"Prefix": null,
"Suffix": null,
"Title": null,
"IsDeceased": "0",
"DeceasedDate": {
"DeceasedYear": null,
"DeceasedMonth": null,
"DeceasedDay": null
},
"EntityID": "9107382",
"LookupID": "1A2C0543-2075-453A-8439-AB61F71707E6",
"LastUpdated": "2022-11-10 05:10:39.577",
"EntityAddresses": [
{
"EntityAddressGUID": "13BE6B3E-DF31-4F84-8A63-68D797158DD0",
"AddressTypeDesc": "Business",
"Address1": "8 Surrey Street",
"Address2": null,
"City": "Norwich",
"StateProvinceRegion": "Norfolk",
"PostalCode": "NR1 3NG",
"Country": "United Kingdom",
"ISOStandard": "GBR",
"LastUpdated": "2019-06-10 22:51:52.443"
}
],
"EntityAliases": [
{
"EntityAliasGUID": "0D80BD8F-135E-42AC-B999-C8C8D85D8881",
"AliasTypeDesc": "AKA",
"EnglishDescription": "Basic Latin",
"Name": "",
"FirstName": "",
"MiddleName": "",
"LastName": "Gresham Fire and Accident Insurance Society Limited(The)",
"Prefix": "",
"Suffix": "",
"LastUpdated": "2018-06-06 10:07:51.807"
}
],
"EntityCountryAssociations": [
{
"EntityCountryAssociationGUID": "F72D12DD-11B5-45E6-ACCF-27AF99EAC97C",
"AssociationTypeDesc": "Associated",
"AdministrativeUnitName": "United Kingdom",
"ISOStandard": "GBR",
"OwnershipPercentageCalc": null,
"LastUpdated": "2018-06-06 10:07:51.807"
},
{
"EntityCountryAssociationGUID": "EDFE7067-00DD-4014-92BB-B372CEDC453C",
"AssociationTypeDesc": "Ownership",
"AdministrativeUnitName": "Norway",
"ISOStandard": "NOR",
"OwnershipPercentageCalc": "2.55",
"LastUpdated": "2019-04-26 17:33:14.507"
}
],
"EntityPositions": [
{
"EntityPositionGUID": "3C84CFBF-55ED-47ED-B58E-4F0D8B32A8FA",
"Position": "SOE involved in Finance/Insurance",
"LastUpdated": "2018-06-06 10:07:51.807"
}
],
"EntityRelationships": [
{
"RelatedEntityGUID": "3E942470-4F2F-4C3B-A393-B3061D5030EC",
"EntityRelationshipGUID": "74DF380C-6A0E-496F-A5A7-E78356009DAC",
"GroupDesc": "MSOE-MSWF",
"RelationshipDesc": "Decision Infl Key Member",
"OwnershipPercentage": null,
"LastUpdated": "2019-07-05 01:03:14.573",
"RelatedEntityName": "Castagno, John"
},
{
"RelatedEntityGUID": "53A8BE24-E896-471C-A01F-A314902D0EE1",
"EntityRelationshipGUID": "0AD9DD86-3FF0-433D-AD3A-C9961BDC8C74",
"GroupDesc": "MSOE-MSWF",
"RelationshipDesc": "Decision Infl Key Member",
"OwnershipPercentage": null,
"LastUpdated": "2019-09-05 09:11:56.490",
"RelatedEntityName": "Barker, Robin"
}
],
"EntityRemarks": [
{
"EntityRemarkGUID": "EFB1A4B4-1C5B-46C4-8A55-1854FB472EB7",
"Remark": "Description:¶Gresham Insurance Company Limited is engaged in the transaction of general insurance business. The company was incorporated on June 27, 1910 and operates in the United Kingdom.¶¶Additional information:¶Company number: 00110410.",
"LastUpdated": "2018-06-06 10:07:51.807"
}
],
"EntitySourceItems": [
{
"EntitySourceItemGUID": "CDDD53F8-DD52-4A87-B274-59A35B619AB4",
"SourceURI": "https://www.aviva.com/content/dam/aviva-corporate/documents/investors/pdfs/reports/2017/Annual_Report_and_Accounts_2017.pdf",
"LastUpdated": "2018-06-06 10:07:51.807"
},
{
"EntitySourceItemGUID": "57E8D36A-91D2-41A2-A9F6-2A9DC8302161",
"SourceURI": "https://beta.companieshouse.gov.uk/company/00110410/filing-history/MzE0ODgyNDUwM2FkaXF6a2N4/document?format=pdf&download=0",
"LastUpdated": "2018-06-06 10:07:51.807"
}
],
"EntitySegments": {
"EntitySOEs": [
{
"EntitySOEGUID": "5DE776CC-940D-48C0-BB63-44FBD98614AF",
"IsActive": "1",
"LastUpdated": "2018-06-06 10:07:51.807",
"EntitySOEDomains": [
{
"EntitySOEDomainGUID": "965A47F6-A2DC-44CB-B3BF-4E4C185C2CA8",
"SOEDomainDesc": "Finance/Insurance",
"LastUpdated": "2018-06-06 10:07:51.807"
}
],
"EntitySOESubcategories": [
{
"EntitySOESubCategoryGUID": "E6CAAE97-8184-4F25-8271-44372AF16FC4",
"SubCategoryLabel": "Multiple Minority",
"LastUpdated": "2022-11-10 05:10:39.577"
}
]
}
]
},
"individualSources": []
}
GET /cases/match/{screen_id}/{match_id}
This endpoint retrieves a specific match of a screen.
Update single match
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/match/{screen_id}/{match_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
-d '{
"status": "possible"
}'
PATCH /cases/match/{screen_id}/{match_id}
This endpoint updates a single match of a case.
Patch Parameters
| Parameter | Type | Description |
|---|---|---|
status |
String | Status of the match: Positive, Possible, False, Unresolved |
comment |
String | Comments or remarks to be added for this match. |
Update multiple matches
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/update-multiple-matches' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
'{"matches":["match_id","match_id"],"status":"false","screen_id": "593a22b5-3536-4e70-93c6-f8e0d1d0c6f6","case_id":"e3bf9903-1d85-4bb2-9cdf-9484875bbaab"}'
PATCH /cases/update-multiple-matches
This endpoint updates multiple matches of a case.
| Parameter | Type | Description |
|---|---|---|
status |
String | Status of the match: Positive, Possible, False, Unresolved |
Ongoing Monitoring
Retrieve monitoring updates
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/monitoring?date={yyyy-mm-dd}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
[
{
"case_id": "1bff98ce-2e6f-4eb8-b53c-b8e618cc1c23",
"new_matches": 0,
"updated_profiles": 1,
"deleted_profiles": 0
},
{
"case_id": "3a686809-0859-4c0e-97cb-c3e055df6f28",
"new_matches": 1,
"updated_profiles": 0,
"deleted_profiles": 0
}
]
GET /cases/monitoring
This endpoint retrieves updates for ongoing monitoring searches. Ongoing monitoring is performed daily. Call this endpoint daily from 0900 (GMT+8) onwards to retrieve all ongoing monitoring updates.
Administrative
Retrieve number of screens
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/screen-summary' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"numberOfScreen": {
"today": 72,
"month": 450,
"year": 5979,
"contractYear": 5979
},
"totalOngoingMonitoring": 127
}
GET /cases/screen-summary
This endpoint retrieves the number of screens done in your account by day, month, calendar year, and contract year. It also retrieves the number of active ongoing monitoring entities.
Retrieve number of summary generations
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/summary-count' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"count": 3
}
GET /rba/summary-count
This endpoint retrieves the number of AI summaries generated in your account.
Retrieve number of summary generations
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/rba/variable-score-count' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"count": 3
}
GET /rba/variable-score-count
This endpoint retrieves the number of AI risk scoring done on free-text variables (as "Others") in your account.
Retrieve users
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/users' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"metadata": {
"total": 3
},
"data": [
{
"user_id": "ea553e66-8c77-4d97-8b5c-970a9992e1a1",
"full_name": "Andy Lim",
"email": "andylim@silvertransfer.com",
"branches": [
{
"branch_id": "2b039ebb-7269-48f9-8661-bcb9edb874c1",
"branch_name": "Headquarters"
},
{
"branch_id": "5d18beb0-6774-48df-9cde-65e82ad4d35b",
"branch_name": "Subsidiary"
}
]
},
{
"user_id": "743c9a5c-83c1-48fe-aca1-e903479632cd",
"full_name": "Elizabeth Goh",
"email": "elizabethgoh@silvertransfer.com",
"branches": [
{
"branch_id": "5d18beb0-6774-48df-9cde-65e82ad4d35b",
"branch_name": "Subsidiary"
}
]
},
{
"user_id": "2ca14a29-acd0-49a6-b004-c487fba1ecca",
"full_name": "Roger Wong",
"email": "rogerwong@silvertransfer.com",
"branches": [
{
"branch_id": "5d18beb0-6774-48df-9cde-65e82ad4d35b",
"branch_name": "Subsidiary"
}
]
}
]
}
GET /cases/users
This endpoint retrieves the details of all users in your account.
Retrieve tags
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/tag' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"data": [
{
"tag_id": "cc5182eb-a996-4336-9f9c-0d1d9fc36db6",
"tag_name": "Exchange",
"tag_color": "#4ADE80",
"cases": 8
},
{
"tag_id": "be4a6bfa-7651-4815-b0ed-38dfd456045a",
"tag_name": "Remittance",
"tag_color": "#F97316",
"cases": 16
}
],
"metadata": {
"total": 2
}
}
GET /cases/tag
This endpoint retrieves all the tags in your account.
Create a tag
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/cases/tag' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
{
"tag_name": "remittance",
"tag_color": "#105ce8"
}'
JSON Response:
{
"tag_id": "9ea909d6-fe30-4f33-9597-f933db9f5626"
}
POST /cases/tag
This endpoint creates a tag.
Update a tag
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/tag/{tag_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
{
"tag_name": "remittance",
"tag_color": "#105ce8"
}'
PATCH /cases/tag/{tag_id}
This endpoint edits a tag.
Delete a tag
Request:
curl -X 'DELETE' \
'https://api.onehypernet.com/v1/cases/tag/{tag_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
DELETE /cases/tag/{tag_id}
This endpoint deletes a tag.
Retrieve branches
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/cases/branches' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"metadata": {
"total": 2
},
"data": [
{
"branch_id": "2b039ebb-7269-48f9-8661-bcb9edb874c1",
"branch_name": "Headquarters",
"created_at": "2024-10-25T09:32:21.452Z",
"updated_at": "2024-10-25T09:32:21.452Z",
"users": [
{
"user_id": "ea553e66-8c77-4d97-8b5c-970a9992e1a1",
"full_name": "Andy Lim"
}
]
},
{
"branch_id": "5d18beb0-6774-48df-9cde-65e82ad4d35b",
"branch_name": "Subsidiary",
"created_at": "2024-10-29T13:06:34.279Z",
"updated_at": "2024-10-29T13:06:34.279Z",
"users": [
{
"user_id": "ea553e66-8c77-4d97-8b5c-970a9992e1a1",
"full_name": "Andy Lim"
},
{
"user_id": "743c9a5c-83c1-48fe-aca1-e903479632cd",
"full_name": "Elizabeth Goh"
},
{
"user_id": "2ca14a29-acd0-49a6-b004-c487fba1ecca",
"full_name": "Roger Wong"
}
]
}
]
}
GET /cases/branches
This endpoint retrieves the details of all branches in your account.
Create branch
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/cases/branches' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}' \
-H 'Content-Type: application/json' \
-d '{
"branch_name": "Subsidiary",
"user_ids": [
"2ca14a29-acd0-49a6-b004-c487fba1ecca",
"743c9a5c-83c1-48fe-aca1-e903479632cd"
]
}'
JSON Response:
{
"branch_id": "5712621f-dea7-499f-b2c9-01c34128e5c4"
}
POST /cases/branches
This endpoint creates a new branch.
Update branch
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/cases/branches/{branch_id}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}'\
-H 'Content-Type: application/json' \
-d '{
"branch_name": "Subsidiary",
"user_ids": [
"2ca14a29-acd0-49a6-b004-c487fba1ecca",
"743c9a5c-83c1-48fe-aca1-e903479632cd"
]
}'
PATCH /cases/branches/{branch_id}
This endpoint updates the details of a branch.
Delete a branch
Request:
curl -X 'DELETE' \
'https://api.onehypernet.com/v1/cases/branches/{branch_id}' \
-H 'accept: */*' \
-H 'Authorization: Bearer {token}' \
\
DELETE /cases/branches/{branch_id}
This endpoint deletes a branch.
Webhooks
You can configure webhooks to notify you when certain events happen. A POST request will be made to your registered endpoint when the webhook is triggered.
- Use HTTPS only
- Use a unique endpoint
Retrieve Endpoint
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/webhook/rtsus' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"data": [
{
"endpoint_id": "accb95ce-94ff-4ab5-919a-095a4d87eade",
"url": "https://<your-website>/<your-webhook-endpoint>",
"event": "un"
},
{
"endpoint_id": "6207e1f2-9ef9-4d0a-9700-c08f7a95fcd6",
"url": "https://<your-website>/<your-webhook-endpoint>",
"event": "moha"
}
],
"metadata": {
"total": 2
}
}
GET /webhook/rtsus
This endpoint allows you to retrieve registered endpoints.
Register Endpoint
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/webhook/rtsus' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
-d '{
"event": "un",
"url": "https://<your-website>/<your-webhook-endpoint>"
"secret": "key"
}'
JSON Response:
{
"endpoint_id": "9ca14g37-acd0-43a6-w124-c487fba1idkm"
}
POST /webhook/rtsus
This endpoint allows you to register an endpoint to receive a JSON body when certain events occur.
| Event | Description |
|---|---|
un |
Any listings or amendments to the UNSC Consolidated List. |
moha |
Any listings or amendments to the Malaysia Ministry of Home Affairs Sanction List Sanctions. |
Update Endpoint
Request:
curl -X 'PATCH' \
'https://api.onehypernet.com/v1/webhook/rtsus/{endpoint_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
-d '{
"event": "un",
"url": "https://<your-website>/<your-webhook-endpoint>"
"secret": "key"
}'
PATCH /webhook/rtsus/{endpoint_id}
This endpoint allows you to update a registered endpoint.
Delete Endpoint
Request:
curl -X 'DELETE' \
'https://api.onehypernet.com/v1/webhook/rtsus' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
-d '{
"endpoint_id": ["dfa69e81-0b45-4ba9-aba6-8242ace1fd12", "73bf7c69-531f-4490-911f-eb27384cd362"]
}'
DELETE /webhook/rtsus
This endpoint allows you to delete a registered endpoint.
Simulate Webhook Trigger
Request:
curl -X 'POST' \
'https://api.onehypernet.com/v1/webhook/rtsus/simulate' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
-d '{
"event_type": "un_listing",
"endpoint_id: "9ca14g37-acd0-43a6-w124-c487fba1idkm"
}'
JSON Response:
{
"data": [
{
"name": "ZAFAR IQBAL",
"type": "Individual",
"alias": [
{
"name": "Zaffer Iqbal",
"quality": "Good"
},
{
"name": "Malik Zafar Iqbal Shehbaz",
"quality": "Good"
},
{
"name": "Muhammad Zafar Iqbal",
"quality": "Low"
}
],
"event": "un",
"address": [
{
"city": "Lahore",
"street": "Masjid al-Qadesia, 4 Lake Road",
"country": "Pakistan"
}
],
"comment": "Senior leader and co-founder of Lashkar-e-Tayyiba (QDe.118) (LeT) who has held various senior leader positions in LeT and its front organization, Jamaat-ud-Dawa (JUD) (listed as an alias of LeT). As of 2010, in charge of LeT/JUD finance department, director of its education department and president of its medical wing. Other title: Professor. Review pursuant to Security Council resolution 2253 (2015) was concluded on 21 Feb. 2019. Review pursuant to Security Council resolution 2610 (2021) was concluded on 8 November 2022. INTERPOL-UN Security Council Special Notice web link:https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals",
"data_id": "2983973",
"document": [
{
"note": "expired on 21 Aug. 2011, passport booklet number A2815665",
"number": "DG5149481",
"date_of_issue": "2006-08-22",
"type_of_document": "Passport"
},
{
"number": "35202- 4135948-7",
"type_of_document": "National Identification Number"
}
],
"list_type": [
"UN List"
],
"listed_on": "2012-03-14",
"reference": "QDi.308",
"event_type": "un_amendment",
"first_name": "ZAFAR",
"nationality": [
"Pakistan"
],
"second_name": "IQBAL",
"version_num": "1",
"un_list_type": "Al-Qaida",
"date_of_birth": [
{
"date": "1953-10-04",
"type_of_date": "EXACT"
}
],
"last_day_updated": [
"2019-05-01",
"2025-01-08"
]
},
{
"type": "Corporate",
"alias": [
{
"name": "Lajnat ul Masa Eidatul Afghania",
"quality": "a.k.a."
},
{
"name": "Ahya ul Turas",
"quality": "a.k.a."
}
],
"event": "un",
"address": [
{
"city": " Peshawar",
"street": "Headquarters – G.T. Road (probably Grand Trunk Road), near Pushtoon Garhi Pabbi",
"country": "Pakistan"
},
{
"city": "Jalabad",
"street": "Cheprahar Hadda, Mia Omar Sabaqah School",
"country": "Afghanistan"
}
],
"comment": "Associated with the Revival of Islamic Heritage Society (QDe.070). Abu Bakr al-Jaziri (QDi.058) served as finance chief of ASC. Review pursuant to Security Council resolution 1822 (2008) was concluded on 8 Jun. 2010. Review pursuant to Security Council resolution 2368 (2017) was concluded on 15 November 2021. INTERPOL-UN Security Council Special Notice web link:https://www.interpol.int/en/How-we-work/Notices/View-UN-Notices-Individuals",
"data_id": "113226",
"list_type": [
"UN List"
],
"listed_on": "2002-01-11",
"reference": "QDe.069",
"event_type": "un_amendment",
"first_name": "AFGHAN SUPPORT COMMITTEE (ASC)",
"version_num": "1",
"un_list_type": "Al-Qaida",
"last_day_updated": [
"2011-12-13",
"2021-11-15",
"2025-01-08"
],
"organization_name": "AFGHAN SUPPORT COMMITTEE (ASC)"
}
]
}
POST /webhook/rtsus/simulate
This endpoint allows you to simulate a webhook trigger to facilitate your development process.
| Event Type | Description |
|---|---|
un_listing |
Any listings to the UNSC Consolidated List. |
un_amendment |
Any amendments to the UNSC Consolidated List . |
moha_listing |
Any listings to the Malaysia Ministry of Home Affairs Sanction List. |
moha_amendment |
Any amendments to the Malaysia Ministry of Home Affairs Sanction List. |
One-Off Screening
These endpoints are only for users on the one-off screening module. Screens will be deleted after 30 days.
One-Off Screen
| Parameter | Type | Description |
|---|---|---|
q (required) |
String | Search query string (e.g. full or partial name). Must be URL-encoded (e.g. space as %20) |
entity_type (required) |
String | individual or corporate |
match_strength (required) |
String | exact, strong, medium, fuzzy. |
country |
String | Nationality of the individual or country of incorporation of the corporate in ISO 3166 format |
dob |
String | Year of birth of the individual. |
gender |
String | male, female |
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/kyc/search?q={q}&entity_type={entity_type}&match_strength={match_strength}&country={country}&dob={dob}&gender={gender}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
[
{
"entityName": "Alexander Michael Hartman",
"entityType": "Individual",
"categories": [
"Adverse Media",
"Secondary PEP"
],
"sub_categories": [
"Secondary PEP"
],
"countries": [
"Freedonia"
],
"overview": "Son of a former cabinet minister in the Republic of Freedonia.",
"prefix": "",
"suffix": "Jr.",
"primary_country": "Freedonia",
"gender": "Male",
"dob": [
"1982"
],
"isBlacklist": false,
"screen_id": "9f3c4a12-6b8e-4d9a-9c1b-1e7d5a4b2f90",
"match_id": "a18d7f44-2c9e-4e61-9b72-0e4c3a1f8d55",
"screened_at": "2025-12-23T07:21:54.620Z"
},
{
"entityName": "Hartman Alexander Michael",
"entityType": "Individual",
"categories": [
"Primary PEP",
"Adverse Media"
],
"sub_categories": [
"Primary PEP"
],
"countries": [
"Freedonia"
],
"overview": "Former Minister of Infrastructure of the Republic of Freedonia (2016–2022). Subject of a public procurement investigation in 2021.",
"prefix": "",
"suffix": "Sr",
"primary_country": "Freedonia",
"gender": "Male",
"dob": [
"1956"
],
"isBlacklist": false,
"screen_id": "9f3c4a12-6b8e-4d9a-9c1b-1e7d5a4b2f90",
"match_id": "c2b6a9e1-7f5a-4c8d-9e13-6d2f4a8b91cc",
"screened_at": "2025-12-23T07:21:54.620Z"
}
]
GET /search?q={q}&entity_type={entity_type}
This endpoint screens the entity without creating a case.
Retrieve a Match from One-Off Screen
Request:
curl -X 'GET' \
'https://api.onehypernet.com/v1/kyc/screen/{screen_id}/{match_id}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {token}'
JSON Response:
{
"match_id": "b3a6c9f2-1d57-4e6a-8a8c-4c9b0f4e2d11",
"screen_id": "7c2f1a90-3d4a-4d2b-9c7f-1e5a8d9c3b20",
"data": {
"Name": "Hartman, Adrian Michael",
"Title": null,
"Gender": "Male",
"Prefix": null,
"Suffix": "III",
"EntityID": "9182746",
"LastName": "Hartman",
"LookupID": "D1B7F5A0-8D2A-4D3C-9A11-7F7B2E3C9B6A",
"FirstName": "Adrian",
"EntityDOBs": [
{
"BirthDate": {
"BirthDay": "14",
"BirthYear": "2011",
"BirthMonth": "7"
},
"LastUpdated": "2019-04-22 09:15:44.120",
"EntityDOBGUID": "F4C3A1B2-9D8E-4A77-8C10-2E6A9B3F1D22"
}
],
"EntityGUID": "8E1F3B2C-6A7D-4C18-9E4B-2A6D9C1F7B33",
"IsDeceased": "0",
"MiddleName": "Michael",
"LastUpdated": "2024-10-18 06:12:31.905",
"isBlacklist": false,
"DeceasedDate": {
"DeceasedDay": null,
"DeceasedYear": null,
"DeceasedMonth": null
},
"EntitySegments": {
"EntityPEPs": [
{
"IsActivePEP": null,
"LastUpdated": "2020-01-09 18:22:10.450",
"IsPrimaryPEP": "0",
"EffectiveDate": {
"EffectiveDay": null,
"EffectiveYear": null,
"EffectiveMonth": null
},
"EntityPEPGUID": "2B7A9C10-4F11-4B77-9A3C-6E2D8F1A0B55",
"GoverningRole": null,
"ExpirationDate": {
"ExpirationDay": null,
"ExpirationYear": null,
"ExpirationMonth": null
},
"PEPAdminLevelDesc": "National",
"IsInCountryPEPOnly": null,
"GoverningInstitution": null,
"EffectiveDateTypeDesc": null,
"EntityPEPSubcategories": [
{
"LastUpdated": "2020-01-09 18:22:10.450",
"SubCategoryDesc": "Family Member",
"SubCategoryLabel": "Secondary PEP",
"EntityPEPSubCategoryGUID": "9C3A1B20-7D4E-4A11-8F22-5B6C7D8E9F10"
}
],
"ExpirationDateTypeDesc": null,
"AdministrativeUnitLevel0": null,
"AdministrativeUnitLevel1": null,
"AdministrativeUnitLevel2": null,
"AdministrativeUnitLevel3": null,
"AdministrativeUnitLevel4": null,
"ISOAdministrativeUnitLevel0": null
}
]
},
"EntityTypeDesc": "Individual",
"EntityPositions": [
{
"Position": "Grandson of Elias Adrian Hartman, former Minister of Infrastructure of the Republic of Freedonia.",
"LastUpdated": "2024-10-18 06:12:31.905",
"EntityPositionGUID": "1D9A7B3C-5E6F-4A12-9C10-7B3C5E6F1A22"
}
],
"EntitySourceItems": [
{
"SourceURI": "https://example.org/news/freedonia-hartman-family-profile-2019",
"LastUpdated": "2019-04-22 09:15:44.120",
"EntitySourceItemGUID": "0A1B2C3D-4E5F-4A6B-8C7D-9E0F1A2B3C4D"
},
{
"SourceURI": "https://example.org/archive/freedonia-infrastructure-minister-2021",
"LastUpdated": "2021-06-03 14:02:11.008",
"EntitySourceItemGUID": "5E6F1A22-3B4C-4D5E-8F60-1A223B4C5D6E"
}
],
"individualSources": [],
"EntityRelationships": [
{
"GroupDesc": "Family",
"LastUpdated": "2019-04-22 09:15:44.120",
"RelationshipDesc": "Mother",
"RelatedEntityGUID": "3C2B1A09-8E7D-4C6B-9A10-2B3C4D5E6F70",
"RelatedEntityName": "Voss Hartman, Clara",
"OwnershipPercentage": null,
"EntityRelationshipGUID": "7A6B5C4D-3E2F-4A11-9B22-1C2D3E4F5A66"
},
{
"GroupDesc": "Family",
"LastUpdated": "2019-04-22 09:15:44.120",
"RelationshipDesc": "Father",
"RelatedEntityGUID": "6F70A1B2-C3D4-4E5F-8A90-1B2C3D4E5F60",
"RelatedEntityName": "Hartman, Adrian Michael",
"OwnershipPercentage": null,
"EntityRelationshipGUID": "1A2B3C4D-5E6F-4A11-8C22-3D4E5F607A8B"
},
{
"GroupDesc": "Family",
"LastUpdated": "2019-04-22 09:15:44.120",
"RelationshipDesc": "Grandfather",
"RelatedEntityGUID": "2D3E4F5A-6B7C-4D8E-9F10-1A2B3C4D5E6F",
"RelatedEntityName": "Hartman, Elias Adrian",
"OwnershipPercentage": null,
"EntityRelationshipGUID": "9F10A1B2-C3D4-4E5F-8A90-1B2C3D4E5F61"
}
],
"EntityCountryAssociations": [
{
"ISOStandard": "FRE",
"LastUpdated": "2019-04-22 09:15:44.120",
"AssociationTypeDesc": "PEP",
"AdministrativeUnitName": "Republic of Freedonia",
"OwnershipPercentageCalc": null,
"EntityCountryAssociationGUID": "4D5E6F70-1A2B-4C3D-9E10-2B3C4D5E6F71"
}
]
},
"created_at": "2025-12-22T12:08:30.530Z"
}
GET /search/{screen_id}/{match_id}
This endpoint retrieves a match from the one-off screen.
Errors
The OneHypernet KYC API uses conventional HTTP response codes to indicate success or failure of the API request.
- Codes in the
2xxrange indicate a successful call. - Codes in the
4xxrange indicate an error that failed with the request data, such as wrong or missing parameters. - Codes in the
5xxrange indicate an unknown error or an error with OneHypernet's servers.
| Error Code | Meaning |
|---|---|
| 400 | Bad Request -- Your request is invalid. |
| 401 | Unauthorized -- Your authentication details are wrong. |
| 403 | Forbidden -- You are not authorized to perform the request. |
| 404 | Not Found -- What you are requesting for does not exist. |
| 429 | Too Many Requests -- You have exceeded your throttle limits. |
| 500 | Internal Server Error -- Unknown error, please contact us if this persists. |
| 503 | Service Unavailable -- We're temporarily offline for maintenance. Please try again later. |