API Reference
Home

Start a New Evaluation

post
https://riskos.socure.com/api/evaluation

Performs a new evaluation in RiskOS™.

Select the type of evaluation below to access the corresponding schema.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Headers
string

Specifies the API version used for the request.

Body Params
string
enum
required

Your environment-specific workflow identifier. You can find this value in the RiskOS™ Dashboard > Developer Workbench > Integration Checklist.

Note: The workflow name must be unique within your RiskOS™ environment. It is not scoped by use case and must identify a single active workflow for each Evaluation API request.

Allowed:
string
required

Required, customer-defined unique identifier for the request.

This value must be unique for each evaluation. Reusing an ID causes RiskOS™ to treat the request as a re-run and can impact processing behavior, results, and downstream workflows.

date-time
required

The timestamp indicating when the evaluation was initiated, in ISO 8601 / RFC 3339 format.

data
object
required

The main payload for the Consumer Onboarding workflow.

Responses

400

Bad Request – The request was invalid or cannot be otherwise served.

401

Unauthorized - No valid API key provided.

403

Forbidden - IP Address was rejected.

404

Not Found - The requested resource does not exist.

429

Too Many Requests - The rate limit for this API has been exceeded.

500

Internal Server Error – An unexpected condition occurred on the server.

Updated 17 days ago

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Choose an example:
application/json

Updated 17 days ago