Get Disclosure Status

curl https://api.zbdpay.com/api/v1/widget/users/{userId}/disclosures \
  -H "apikey: YOUR_API_KEY"

{
  "success": true,
  "message": "Publisher user ToS status retrieved successfully.",
  "data": [
    {
      "type_id": 2,
      "name": "Terms of Service",
      "version": "1.4.0",
      "tos_current": true,
      "accepted_at": "2026-01-15T12:00:00Z"
    },
    {
      "type_id": 6,
      "name": "Electronic Funds Transfer",
      "version": "1.0.0",
      "tos_current": false,
      "accepted_at": null
    }
  ],
  "error": null
}

GET

api

widget

users

{userId}

disclosures

curl https://api.zbdpay.com/api/v1/widget/users/{userId}/disclosures \
  -H "apikey: YOUR_API_KEY"

{
  "success": true,
  "message": "Publisher user ToS status retrieved successfully.",
  "data": [
    {
      "type_id": 2,
      "name": "Terms of Service",
      "version": "1.4.0",
      "tos_current": true,
      "accepted_at": "2026-01-15T12:00:00Z"
    },
    {
      "type_id": 6,
      "name": "Electronic Funds Transfer",
      "version": "1.0.0",
      "tos_current": false,
      "accepted_at": null
    }
  ],
  "error": null
}

Description

Returns the user’s acceptance status for each current disclosure type. Use this from your server only if your integration needs to check disclosure acceptance outside the hosted widget. Most integrations can let the widget handle disclosure prompts during the session. The API key determines the publisher/project context. userId is the ZBD user ID returned when the widget user is created or resolved.

Configuration

Header Parameters

apikey

string

required

Your ZBD project API key.

Path Parameters

userId

string

required

The ZBD user ID returned when the widget user is created or resolved.

curl https://api.zbdpay.com/api/v1/widget/users/{userId}/disclosures \
  -H "apikey: YOUR_API_KEY"

{
  "success": true,
  "message": "Publisher user ToS status retrieved successfully.",
  "data": [
    {
      "type_id": 2,
      "name": "Terms of Service",
      "version": "1.4.0",
      "tos_current": true,
      "accepted_at": "2026-01-15T12:00:00Z"
    },
    {
      "type_id": 6,
      "name": "Electronic Funds Transfer",
      "version": "1.0.0",
      "tos_current": false,
      "accepted_at": null
    }
  ],
  "error": null
}

tos_current means the user has accepted the current version of that disclosure type. A value of false means there is no acceptance on record, or the user’s latest acceptance is for an older version.

Errors

Status	Reason
`401`	Missing or invalid API key
`403`	The API key is not allowed to access widget disclosure APIs
`404`	`userId` does not belong to the project associated with the API key

Create Session Submit Disclosure Acceptance

⌘I

Overview

Events

API Reference

Testing

Description

Configuration

Header Parameters

Path Parameters

Errors

​Description

​Configuration

​Header Parameters

​Path Parameters

​Errors

Description

Configuration

Header Parameters

Path Parameters

Errors