Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.responsibleailabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

Overview: Compliance API | Credits: 0 (free)
Lists all active compliance timers for the authenticated organization. Timers are auto-created by events emitted via /emit and track regulatory deadlines for DSR SLAs, breach notifications, and data retention.

​
Query parameters

​
status
string
Filter by status: "active" or "overdue".
​
type
string
Filter by timer type (e.g., "dsr_sla", "certin_notification", "dpbi_detailed_report").
​
approaching_days
integer
Return only active timers with deadline within this many days.

​
Timer types

TypeCreated ByDeadlineRegulation
dsr_sladsr.received event90 daysRule 14(3)
certin_notificationbreach.detected event6 hoursCERT-In Directions 2022
dpbi_initial_intimationbreach.detected eventImmediateDPDP Act
dpbi_detailed_reportbreach.detected event72 hoursRule 7
pre_erasure_noticeretention.started eventretention_days - 2S.8(7)
erasure_executionretention.started eventretention_daysS.8(7)

​
Request

curl -s "https://api.responsibleailabs.ai/railscore/v1/compliance/dpdp/timers?status=active&approaching_days=15" \
  -H "Authorization: Bearer YOUR_RAIL_API_KEY"

​
Response

{
  "result": {
    "timers": [
      {
        "timer_id": "tmr_abcd1234",
        "type": "dsr_sla",
        "request_id": "dsr_456",
        "user_id": "u_hashed_abc",
        "org_id": "org_xyz",
        "started_at": "2026-05-10T10:00:00+00:00",
        "deadline": "2026-08-08T10:00:00+00:00",
        "days_remaining": 86,
        "status": "active",
        "alert_at": "2026-07-14T10:00:00+00:00"
      }
    ],
    "summary": {
      "total_active": 173,
      "overdue": 2,
      "approaching_15_days": 12
    }
  },
  "credits_consumed": 0
}
​
result.timers
array
Array of timer objects matching the query filters.
​
result.timers[].timer_id
string
Unique timer identifier (prefixed with tmr_).
​
result.timers[].type
string
Timer type from the table above.
​
result.timers[].deadline
string
ISO-8601 deadline. After this time, the timer status changes to "overdue".
​
result.timers[].days_remaining
number
Days until deadline. Negative values indicate overdue timers.
​
result.timers[].status
string
"active" or "overdue".
​
result.timers[].alert_at
string
ISO-8601 timestamp for when an early warning should be triggered (typically 75% through the SLA window).
​
result.summary
object
Aggregate counts: total_active, overdue, and timers approaching within the queried window.