BVbvnk
Onboarding

Search questionnaire submissions

:::info Customers API v1 If you already have an integration with Customers API v1, you can continue using it. BVNK will continue to support this API going forward. :::

Returns previously submitted questionnaire answer sets matching the supplied filters

get/platform/v1/customers/questionnaires

Request

Query parameters

customerReferencestring uuid required
Example:52ec68a9-1ff1-4b7c-a8b5-0630de484e42

Unique customer reference used when the questionnaire was submitted.

codesstring[]

One or more questionnaire codes to include (comma-separated).

statusesstring[]

One or more validation states to filter by.

Response

Array of questionnaire submissions that meet the criteria.

customerReferencestring uuid required

Unique customer reference used when the questionnaire was submitted.

questionnaireCode'financialServicesQuestionnaireFull' | 'amlCryptoComplianceQuestionnaireFull' | 'gamblingQuestionnaireFull' | 'fintechsQuestionnaireFull' | 'otherQuestionnaireFull' | 'eddQuestionnaire' required

Questionnaire code

status'INIT' | 'OK' | 'NOK' required

One or more validation states to filter by.

submittedDatestring date-time required

Date and time of the submitted questionnaire

Example response

[
  {
    "customerReference": "52ec68a9-1ff1-4b7c-a8b5-0630de484e42",
    "questionnaireCode": "amlCryptoComplianceQuestionnaireFull",
    "status": "OK",
    "submittedDate": "2025-05-14T14:45:00Z",
    "sections": [
      {
        "code": "nature_of_business_section",
        "items": [
          {
            "code": "products_services_offered",
            "value": "embedded"
          }
        ]
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 3 revisions of this API.