link

# Quick start guide

This guide will show you how to carry out your first AML check. Note that AML self declaration is only available in Norway.

# Before you start

If you don't have an account already, you need to create a free Signicat account (opens new window).

This guide assumes that you have access to the production environment.

# 1. Create a client on the Dashboard

Follow the steps in How to create an API client. Select the following scopes:

  • self_declaration_write
  • self_declaration_read

Default settings

You can override some of the default settings of the API, such as the type of flow that the end-user goes through or the style of the generated self declaration document. To do so, open the Dashboard (opens new window) and go to Tools > Setting Sets > AML Self Declaration (the AML Self Declaration entry is under "Products").

# 2. Open Postman or a similar tool

Our developers like to use Postman. It can be downloaded from https://www.getpostman.com (opens new window).

You can also download the OpenAPI document for our APIs from our API Reference (opens new window)(click the "Download" button at the top of the page).

# 3. Get access token

  1. Create a new empty request.
  2. Open the Authorization tab and set the authorisation type to OAuth 2.0.
  3. Click Get New Access Token.
  4. Fill in the fields as shown in the image below. Bear in mind that you can only get an access token for scopes that you have access to. The scopes you can access, as well as your Client ID and Client Secret can be found on the PDF you received after onboarding. They are also listed in the developer dashboard (opens new window).

click-to-zoom

  1. Click Request Token, and then Use Token.

# 4. Create an assignment

Create an assignment for one or several persons using the Assignment endpoint (opens new window). Include the request sample below (body raw → application/json), or create your own sample.

Email and phone number

For testing, replace the Email and Mobile under Persons with an address and a phone number that you have access to, so you can view the notifications.

POST https://amlselfdeclaration-api.azurewebsites.net/Assignment

Request sample

{
  "Flow": "SelfDeclaration",
  "ExternalId": "001",
  "Persons": [
    {
      "FirstName": "Rosa",
      "LastName": "Walters",
      "Address": {
        "Street": "Main street 1",
        "PostalCode": "7052",
        "City": "Trondheim",
        "CountryCode": "NO",
        "Country": "Norway"
      },
      "Mobile": {
        "Prefix": "0047",
        "Number": "phone_number_here"
      },
      "Email": "email_address_here",
      "Notifications": "Email",
      "Language": "EN"
    }
  ],
  "Styling": {
    "ColorTheme": "Default",
    "ThemeMode": "Light",
    "Spinner": "Document"
  },
  "Language": "EN"
}

The response will include the StatusUrl, which you can use to keep track of the status of the assignment. You will also get one URL for each person included in the assignment (under "Persons"): these are the URLs your end-users must use to fill in the self declaration form. End-users will also receive a notification containing their respective URLs by email or SMS, depending on what you specified under Notifications.

Response sample

{
    "Id": "9f261eda-6ef6-ea11-af8c-000d3ab010d6",
    "Created": "2020-09-14T09:44:16.4541367Z",
    "StatusUrl": "https://amlselfdeclaration-app-test.azurewebsites.net/status?jwt=eyJ0eXA...",
    "Flow": "SelfDeclaration",
    "ExternalId": "001",
    "AssignmentIdentifier": null,
    "Persons": [
        {
            "Id": "a0261eda-6ef6-ea11-af8c-000d3ab010d6",
            "Created": "2020-09-14T09:44:16.4703079Z",
            "Url": "https://amlselfdeclaration-app-test.azurewebsites.net?jwt=eyJ0eXA...",
            "Identity": null,
            "Files": {},
            "FirstName": "Rosa",
            "LastName": "Walters",
            "BirthDate": null,
            "Address": {
                "Street": "Main street 1",
                "PostalCode": "7052",
                "City": "Trondheim",
                "CountryCode": "NO",
                "Country": "Norway"
            },
            "Mobile": {
                "Prefix": "0047",
                "Number": "00000000"
            },
            "Email": "address@email.com",
            "Notifications": "Email",
            "Tags": [],
            "Language": "EN",
            "QuestionIds": "3,6,7,8"
        }
    ],
    "Tags": [],
    "Styling": {
        "ColorTheme": "Default",
        "ThemeMode": "Light",
        "Spinner": "Document",
        "BackgroundColor": ""
    },
    "CallbackUrl": null,
    "Deadline": "2020-09-16T09:44:16.4541369Z",
    "Language": "EN"
}

# 5. Retrieve information

When the customer has filled in and signed the form, and the AML check has been completed, you can obtain the relevant information using the Fetch assignment (opens new window) endpoint. This endpoint will include a link to an electronically signed document with all the details provided by the end-user. You can also download it from the status page (see the StatusUrl parameter in the response). In the example below, we are retrieving information about the assignment we created in the previous step. Notice that the ID used in the request is the one that was returned in Id in the response above.

GET https://amlselfdeclaration-api.azurewebsites.net/Assignment/{assignment ID}

Response example

{
    "Id": "9f261eda-6ef6-ea11-af8c-000d3ab010d6",
    "Created": "2020-09-14T09:44:16.453",
    "StatusUrl": "https://amlselfdeclaration-app-test.azurewebsites.net/status?jwt=eyJ0eXA...",
    "Flow": "SelfDeclaration",
    "ExternalId": "001",
    "AssignmentIdentifier": null,
    "Persons": [
        {
            "Id": "a0261eda-6ef6-ea11-af8c-000d3ab010d6",
            "Created": "2020-09-14T09:44:16.47",
            "Url": "https://amlselfdeclaration-app-test.azurewebsites.net?jwt=eyJ0eXA...",
            "Identity": null,
            "Files": {},
            "FirstName": "Rosa",
            "LastName": "Walters",
            "BirthDate": null,
            "Address": {
                "Street": "Main street 1",
                "PostalCode": "7052",
                "City": "Trondheim",
                "CountryCode": "NO",
                "Country": "Norway"
            },
            "Mobile": {
                "Prefix": "0047",
                "Number": "00000000"
            },
            "Email": "address@email.com",
            "Notifications": "Email",
            "Tags": [],
            "Language": "EN",
            "QuestionIds": "3,6,7,8"
        }
    ],
    "Tags": [],
    "Styling": {
        "ColorTheme": "Default",
        "ThemeMode": "Light",
        "Spinner": "Document",
        "BackgroundColor": ""
    },
    "CallbackUrl": null,
    "Deadline": "2020-09-16T09:44:16.453",
    "Language": "EN"
}
Last updated: 8/9/2021, 12:45:58 PM