Sift

Sift Decisions API

Apply and retrieve decisions (block, watch, accept) against Sift users, orders, sessions, and content. Decisions feed Sift's ML models, drive downstream webhooks, and are the modern replacement for the legacy Labels API.

Sift Decisions API is one of 6 APIs that Sift 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 and 1 JSON Schema definition.

Tagged areas include Decisions, Fraud, and Workflows. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, sample payloads, 1 Naftiko capability spec, and 1 JSON Schema.

GitHub OpenAPI

Documentation

📖
Documentation
https://developers.sift.com/docs/curl/decisions-api

Specifications

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

Examples

📝
Example
https://raw.githubusercontent.com/api-evangelist/sift-com/refs/heads/main/examples/sift-apply-decision-example.json

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/sift-com/refs/heads/main/json-schema/sift-decision-schema.json

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/sift-com/refs/heads/main/capabilities/decisions-decisions.yaml

OpenAPI Specification

sift-decisions-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Sift Decisions API
  description: |
    The Sift Decisions API records analyst or automation decisions (for example
    block, watch, or accept) against users, orders, sessions, and content. Decisions
    feed Sift's machine learning models and drive downstream webhook notifications.
  version: '205'
  contact:
    name: Sift
    url: https://sift.com
    email: [email protected]
  license:
    name: Sift API Terms of Service
    url: https://sift.com/legal-and-compliance
servers:
  - url: https://api.sift.com/v205
    description: Sift Production API
security:
  - BasicAuth: []
tags:
  - name: Decisions
    description: Apply and retrieve decisions on Sift entities.
paths:
  /accounts/{account_id}/users/{user_id}/decisions:
    post:
      summary: Sift Apply Decision To User
      description: Apply an analyst or workflow decision to a user entity.
      operationId: applyUserDecision
      tags: [Decisions]
      parameters:
        - $ref: '#/components/parameters/AccountId'
        - $ref: '#/components/parameters/UserId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DecisionRequest'
      responses:
        '200':
          description: Decision applied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DecisionResponse'
    get:
      summary: Sift Get User Decision
      description: Retrieve the latest decision status for a user.
      operationId: getUserDecision
      tags: [Decisions]
      parameters:
        - $ref: '#/components/parameters/AccountId'
        - $ref: '#/components/parameters/UserId'
      responses:
        '200':
          description: User decision details.
  /accounts/{account_id}/users/{user_id}/orders/{order_id}/decisions:
    post:
      summary: Sift Apply Decision To Order
      description: Apply an analyst or workflow decision to an order entity.
      operationId: applyOrderDecision
      tags: [Decisions]
      parameters:
        - $ref: '#/components/parameters/AccountId'
        - $ref: '#/components/parameters/UserId'
        - $ref: '#/components/parameters/OrderId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DecisionRequest'
      responses:
        '200':
          description: Decision applied.
  /accounts/{account_id}/users/{user_id}/sessions/{session_id}/decisions:
    post:
      summary: Sift Apply Decision To Session
      description: Apply a decision to a session entity.
      operationId: applySessionDecision
      tags: [Decisions]
      parameters:
        - $ref: '#/components/parameters/AccountId'
        - $ref: '#/components/parameters/UserId'
        - $ref: '#/components/parameters/SessionId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DecisionRequest'
      responses:
        '200':
          description: Decision applied.
  /accounts/{account_id}/users/{user_id}/content/{content_id}/decisions:
    post:
      summary: Sift Apply Decision To Content
      description: Apply a decision to user-generated content.
      operationId: applyContentDecision
      tags: [Decisions]
      parameters:
        - $ref: '#/components/parameters/AccountId'
        - $ref: '#/components/parameters/UserId'
        - $ref: '#/components/parameters/ContentId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DecisionRequest'
      responses:
        '200':
          description: Decision applied.
  /accounts/{account_id}/decisions:
    get:
      summary: Sift List Decisions
      description: List the configured decisions for the Sift account.
      operationId: listDecisions
      tags: [Decisions]
      parameters:
        - $ref: '#/components/parameters/AccountId'
      responses:
        '200':
          description: A list of decisions configured for the account.
components:
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic
  parameters:
    AccountId:
      name: account_id
      in: path
      required: true
      schema:
        type: string
    UserId:
      name: user_id
      in: path
      required: true
      schema:
        type: string
    OrderId:
      name: order_id
      in: path
      required: true
      schema:
        type: string
    SessionId:
      name: session_id
      in: path
      required: true
      schema:
        type: string
    ContentId:
      name: content_id
      in: path
      required: true
      schema:
        type: string
  schemas:
    DecisionRequest:
      type: object
      required: [decision_id, source]
      properties:
        decision_id:
          type: string
          description: Identifier of the decision to apply (configured in the Sift Console).
        source:
          type: string
          enum: [MANUAL_REVIEW, AUTOMATED_RULE, CHARGEBACK]
        analyst:
          type: string
        description:
          type: string
        time:
          type: integer
    DecisionResponse:
      type: object
      properties:
        entity:
          type: object
        decision:
          type: object
        time:
          type: integer