> For the complete documentation index, see [llms.txt](https://partner.doc.bunq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partner.doc.bunq.com/documentation/bunq-as-a-service/chapter-7-compliance/compliance-webhooks.md).

# Compliance webhooks

<details open>

<summary><strong>Webhook Body Example (<code>USER_INFORMATION_INQUIRY</code>):</strong></summary>

<pre class="language-json"><code class="lang-json">{
    "NotificationUrl": {
        "target_url": "https://your-webhook-endpoint.com/notifications",
        "category": "USER_INFORMATION_INQUIRY",
        "event_type": "USER_INFORMATION_INQUIRY_EXPECTING_REPLY_FROM_USER",
        "object": {
            "UserInformationInquiry": {
                "id": 17,
                "created": "2025-08-13 15:32:55.697184",
<strong>                "updated": "2025-08-13 15:32:55.817014",
</strong>                "user_id": 1358,
                "title": "We need additional information",
                "subtitle": "To continue your bunq experience, please provide the following information.",
                "purpose": "COMPLIANCE_TRANSACTION_MONITORING",
                "all_entry": [
                    {
                        "UserInformationInquiryEntry": {
                            "id": 17,
                            "created": "2025-08-13 15:32:55.755341",
                            "updated": "2025-08-13 15:32:55.755341",
                            "type": "USER_PERSON_SOURCE_OF_FUND",
                            "status": "PENDING",
                            "all_data_submitted": [],
                            "assistant_conversation": {
                                "id": 17,
                                "created": "2025-08-13 15:32:55.750785",
                                "updated": "2025-08-13 15:32:55.750785",
                                "user_id": 1358,
                                "user_subject_id": 1358,
                                "label_user": {
                                    "uuid": "d556bfc8-c1d4-4d79-a758-e3c2f9360546",
                                    "display_name": "New bunqer",
                                    "country": "NL",
                                    "avatar": {...},
                                    "public_nick_name": "New bunqer",
                                    "type": "PERSON"
                                },
                                "assistant_id": 18,
                                "type": "USER_INFORMATION_INQUIRY",
                                "typing_indicator_status": "INACTIVE",
                                "feedback_status": "NONE",
                                "read_status": "READ"
                            },
                            "context": [],
                            "reject_reason": null
                        }
                    }
                ],
                "assistant_conversation": {...}
            }
        }
    }
}
</code></pre>

**Webhook fields:**

**NotificationUrl Object:**

| `target_url` | Your configured webhook endpoint URL                     |
| ------------ | -------------------------------------------------------- |
| `category`   | Notification category (e.g., `USER_INFORMATION_INQUIRY`) |
| `event_type` | Specific event type within the category                  |
| `object`     | The actual object that triggered the notification        |

**UserInformationInquiry Object:**

| `id`                     | Unique identifier for the inquiry                                  |
| ------------------------ | ------------------------------------------------------------------ |
| `created`                | Timestamp when the inquiry was created                             |
| `updated`                | Timestamp when the inquiry was last updated                        |
| `user_id`                | ID of the user for whom the inquiry was created                    |
| `title`                  | Title of the inquiry (e.g., "We need additional information")      |
| `subtitle`               | Subtitle explaining the inquiry purpose                            |
| `purpose`                | Purpose of the inquiry (e.g., `COMPLIANCE_TRANSACTION_MONITORING`) |
| `all_entry`              | Array of inquiry entries with specific information requests        |
| `assistant_conversation` | Conversation details for user interaction                          |

**UserInformationInquiryEntry Object:**

| `id`                     | Unique identifier for the inquiry entry                            |
| ------------------------ | ------------------------------------------------------------------ |
| `type`                   | Type of information requested (e.g., `USER_PERSON_SOURCE_OF_FUND`) |
| `status`                 | Status of the entry (e.g., `PENDING`)                              |
| `all_data_submitted`     | Array of data submitted by the user                                |
| `assistant_conversation` | Conversation context for this specific entry                       |
| `context`                | Additional context information                                     |
| `reject_reason`          | Reason for rejection (if applicable)                               |

</details>