Institution Disclosures
Institution Disclosure APIs enable financial institutions to define and manage disclosure content used across digital banking experiences. These endpoints allow institutions to create, update, enable, disable, and retrieve disclosure definitions that govern regulatory agreements, online statements, and other institution‑level disclosures presented to end users.
End-user benefits
- Financial institutions can define and manage disclosure content used across digital banking experiences.
- Disclosures are used to govern regulatory agreements, online statements, and other institution‑level disclosures presented to end users.
Integration capabilities
- Manage institution disclosure definitions and content types.
- Drive registration and onboarding disclosure workflows.
Disclosure content types
| Type | Description |
|---|---|
URL | Content hosted at a URL |
CONFIG | Content in configuration format |
RAW | Raw text content |
Scopes
| Scope | Description |
|---|---|
disclosures:read | Retrieve disclosure information |
disclosures:write | Create, update, or delete disclosures |
Required headers
| Header | Description |
|---|---|
Authorization | Bearer token (V2 authentication) |
transactionId | Unique identifier for request tracking |
Error codes (DSC_*)
| Code | Message | HTTP Status Code |
|---|---|---|
| DSC_10002 | Invalid request | 400 |
| DSC_10003 | Invalid operation | 501 |
| DSC_10009 | Invalid query param | 400 |
| DSC_11001 | Full authentication was not provided in the request | 401 |
| DSC_11002 | The authentication token is invalid | 401 |
| DSC_11003 | The authentication does not authorize this request | 401 |
| DSC_11004 | A location id is required for business banking users | 400 |
| DSC_12001 | Request should only contain printable ASCII characters | 400 |
| DSC_12002 | Request is missing a transactionId header | 400 |
| DSC_12003 | Request transactionId header is too long | 400 |
| DSC_12004 | Required fields are not provided or not valid | 400 |
| DSC_12005 | Request cannot be blank | 400 |
| DSC_12006 | Invalid or empty account type in request | 400 |
| DSC_12007 | Request header is too long | 400 |
| DSC_12011 | One of the request field lengths is greater than max length | 400 |
| DSC_12012 | Disclosure ids from request body and URL do not match | 400 |
| DSC_12013 | Request callingAppId header is too long | 400 |
| DSC_13001 | Data not found for user | 400 |
| DSC_13002 | Disclosures are not retrieved successfully | 500 |
| DSC_13003 | Disclosures are not created successfully | 500 |
| DSC_13004 | Disclosures are not updated successfully | 500 |
| DSC_22001 | Internal validation error | 500 |
| DSC_23002 | Error interacting with CBS Service | 500 |
| DSC_23003 | Error interacting with CAS Service | 500 |
| DSC_90000 | Server cannot handle this request | 400 |
| DSC_99997 | Client error | 400 |
| DSC_99999 | Internal server error | 500 |
Endpoints
Create Institution Disclosure
Creates a new disclosure definition for the financial institution. The disclosure can contain
List Institution Disclosures
Retrieves all disclosures configured for the financial institution. Returns all disclosure
Update Institution Disclosure
Updates an existing institution disclosure definition. Use this to modify disclosure content,