socure

Socure Decision API

Socure's rule-based decisioning module returns a single deterministic outcome — accept, reject, review, refer, or resubmit — derived from ID+ module scores and customer-configured rules. Decision rules are authored in the Socure Console and applied on every ID+ call when the `decision.module` block is included in the request modules array.

Socure Decision API is one of 6 APIs that socure publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Decisioning, Rules Engine, and Identity Verification. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://developer.socure.com/docs/id-plus/modules/decision

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/socure/refs/heads/main/openapi/socure-decision-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/socure/refs/heads/main/capabilities/decision-decisioning.yaml

OpenAPI Specification

socure-decision-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Socure Decision API
  version: '3.0'
  description: |
    The Decision module returns a deterministic outcome — accept, reject, review,
    refer, or resubmit — derived from ID+ module scores and customer-configured rules
    authored in the Socure Console. Decision is applied on every ID+ call when the
    `decision` module is included in the request modules array.
servers:
- url: https://api.socure.com
  description: Production
- url: https://sandbox.socure.com
  description: Sandbox
security:
- SocureToken: []
tags:
- name: Decision
paths:
  /api/3.0/EmailAuthScore:
    post:
      tags:
      - Decision
      operationId: evaluateDecision
      summary: Evaluate A Decision
      description: |
        Invoke the Decision module alongside other ID+ modules. The Decision block in
        the response carries the configured rule set name, version, and the resulting
        outcome.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - modules
              properties:
                modules:
                  type: array
                  items:
                    type: string
                    enum:
                    - decision
                    - kyc
                    - sigma
                    - synthetic
                    - watchlist
                customerUserId:
                  type: string
                firstName:
                  type: string
                surName:
                  type: string
                dob:
                  type: string
                  format: date
                nationalId:
                  type: string
      responses:
        '200':
          description: Decision result.
          content:
            application/json:
              schema:
                type: object
                properties:
                  referenceId:
                    type: string
                  decision:
                    type: object
                    properties:
                      name:
                        type: string
                      value:
                        type: string
                        enum:
                        - accept
                        - reject
                        - review
                        - refer
                        - resubmit
                      ruleSet:
                        type: string
                      version:
                        type: string
components:
  securitySchemes:
    SocureToken:
      type: apiKey
      in: header
      name: Authorization