API
Endpoints

Endpoints

ℹ️

All endpoints require a valid access token with a specific scope for access. Please read Authentication and Authorization documentation.

Managing Applications

Create application

POST /v1/applications.create

The endpoint creates an application on the specific workflow and market. All input parameters can be found on the "Integration" tab in a workflow on the Bits Dashboard.

The POST /v1/applications.create will return a sessionToken which is a Bearer token and is only authorized to perform actions on the application it just created. The sessionToken is used to start the no-code onboarding.

Request
curl
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -d '{
    "workflowId": "<WORKFLOW_ID>",
    "market": "<MARKET>",
    "redirectUrl": "<REDIRECT_URL>",
  }' \
  https://api.bits.bi/v1/applications.create
 
PropertyTypeDescription
workflowIdstringIdentifies which workflow to commence for the application.
marketstringIdentifies the market to commence the application.
redirectUrlstringIdentifies the URL the applicant should be redirected to once the application is complete.
Response
{
  "id": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100",
  "sessionToken": "eyJhbGciOiJIUz..."
}
PropertyTypeDescription
idstringIdentifier for the created application.
sessionTokenstringAccess token used to execute the application.

GET organization data on Applications

Fetch organization general information

POST /v1/applications.organization.get

The endpoint returns the organization information on an application.

Request

{
  "applicationId": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100"
}
PropertyTypeDescription
applicationIdstringIdentifies which application to fetch the information from.

Response

{
  "organizationName": "Taraxacum AB",
  "organizationNumber": {
    "id": "55937532453",
    "issuingCountry": "SE"
  },
  "legalType": "Private Liability Company",
  "registrationDate": "2022-04-11",
  "visitAddress": {
    "addressLine1": "Drottninggatan 32",
    "postalCode": "11145",
    "city": "Stockholm",
    "country": "SE",
    "region": "STOCKHOLM"
  },
  "postalAddress": {
    "addressLine1": "Drottninggatan 32",
    "addressLine2": "",
    "postalCode": "11145",
    "city": "STOCKHOLM",
    "country": "SE",
    "region": "STOCKHOLM"
  },
  "companyStatus": "Aktivt",
  "numberOfEmployeesInterval": "10-19 anställda",
  "industryCode": "62010",
  "businessActivity": "Programvaruproducenter",
  "registeredCorporateTaxDate": "2022-07-27",
  "registeredCorporateVatDate": "2022-07-01"
}

Fetch org contact details

POST /v1/applications.organization.contactDetails.get

The endpoint returns the organization contact details on an application.

Request

{
  "applicationId": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100"
}
PropertyTypeDescription
applicationIdstringIdentifies which application to fetch the information from.

Response

{
  "firstName": "Lois",
  "lastName": "Lane",
  "email": "lois.lane@metropolis.com",
  "phoneNumber": "+46701234567"
}

Fetch signing combinations

POST /v1/applications.organization.signingCombinations.get

The endpoint will return the signing combinations for an organization on an application.

Request

{
  "applicationId": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100"
}
PropertyTypeDescription
applicationIdstringIdentifies which application to fetch the information from.

Response

{
  "data": [
    [
      {
        "type": "PERSON",
        "name": "Kentsson, Kenta",
        "roles": ["Ledamot"],
        "personalIdentityNumber": {
          "id": "191212121212",
          "issuingCountry": "SE"
        },
        "hasAdminRights": true
      }
    ],
    [
      {
        "type": "PERSON",
        "name": "Testsson, Ola Per",
        "roles": ["Ledamot", "Ordförande"],
        "personalIdentityNumber": {
          "id": "19721111114321",
          "issuingCountry": "SE"
        },
        "hasAdminRights": false
      },
      {
        "type": "PERSON",
        "name": "Lantzio, Lorentz",
        "roles": ["Ledamot"],
        "personalIdentityNumber": {
          "id": "198212121212",
          "issuingCountry": "SE"
        },
        "hasAdminRights": false
      }
    ]
  ]
}

Fetch signed by

POST /v1/applications.organization.signedBy.get

The endpoint will return the person who signed the application. Normally this might be the person who performed the onboarding on behalf of the organization.

Request

{
  "applicationId": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100"
}
PropertyTypeDescription
applicationIdstringIdentifies which application to fetch the information from.

Response

{
  "data": [
    {
      "name": "Clark Kent",
      "personalIdentityNumber": {
        "id": "197803111934",
        "issuingCountry": "SE"
      },
      "pepHits": [
        {
          "name": "Clark Kent",
          "personalIdentityNumber": {
            "id": "197803111934",
            "issuingCountry": "SE"
          },
          "dateOfBirth": "1978-03-11",
          "gender": "Male",
          "pepCountry": "SE",
          "roles": [
            {
              "active": true,
              "category": "Politician or government official",
              "detailedCategory": "Head of State",
              "description": "President of the United States",
              "fromDate": "2017-01-20",
              "toDate": "2021-01-20"
            }
          ],
          "source": {
            "name": "some-source",
            "link": "http://test.testy"
          }
        }
      ],
      "sanctionHits": [
        {
          "name": "Clark Kent",
          "akas": ["Superman", "Mr. Kent"],
          "gender": "Male",
          "dateOfBirths": ["1978-03-11"],
          "citizenships": ["SE"],
          "legalBasis": "terrorist",
          "source": {
            "name": "EU",
            "link": "http://eu.eu"
          },
          "listedDate": "1990-01-10"
        }
      ]
    }
  ]
}

Fetch board members

POST /v1/applications.organization.boardMembers.get

The endpoint will return the board members for an organization on an application.

Request

{
  "applicationId": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100"
}
PropertyTypeDescription
applicationIdstringIdentifies which application to fetch the information from.

Response

{
  "data": [
    [
      {
        "type": "ORGANIZATION",
        "name": "ACM 2001 AB",
        "roles": ["Bolagsman"],
        "organizationIdentifier": {
          "id": "5560572850",
          "issuingCountry": "SE"
        }
      },
      {
        "type": "ORGANIZATION",
        "name": "Swedec AB",
        "roles": ["Bolagsman"],
        "organizationIdentifier": {
          "id": "5567164818",
          "issuingCountry": "SE"
        }
      }
    ],
    [
      {
        "type": "PERSON",
        "name": "Clark Kent",
        "roles": ["Ledamot"],
        "personalIdentityNumber": {
          "id": "197601030029",
          "issuingCountry": "SE"
        }
      },
      {
        "type": "PERSON",
        "name": "Lois Lane",
        "roles": ["Ledamot"],
        "organizationIdentifier": {
          "id": "198207140029",
          "issuingCountry": "SE"
        }
      }
    ]
  ]
}

GET person data on Applications

POST /v1/applications.person.get

Fetch person data

The endpoint will return information on the person related to an application. For KYC that would correspond to the applicant or onboarded customer. While for KYB it could be the person who performed the auth or IDV step while onboarding the organization.

Request

{
  "applicationId": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100"
}
PropertyTypeDescription
applicationIdstringIdentifies which application to fetch the information from.

Response

{
  "firstName": "Lois",
  "lastName": "Lane",
  "personalIdentityNumber": {
    "id": "197803111934",
    "issuingCountry": "SE"
  },
  "pepHits": [
    {
      "name": "Lois Lane",
      "personalIdentityNumber": {
        "id": "197803111934",
        "issuingCountry": "SE"
      },
      "dateOfBirth": "1978-03-11",
      "gender": "Female",
      "pepCountry": "SE",
      "roles": [
        {
          "active": true,
          "category": "Politician or government official",
          "detailedCategory": "Head of State",
          "description": "President of the United States",
          "fromDate": "2017-01-20",
          "toDate": "2021-01-20"
        }
      ],
      "source": {
        "name": "some-source",
        "link": "http://test.testy"
      }
    }
  ],
  "sanctionHits": [
    {
      "name": "Lois Lane",
      "akas": ["Red Tornado", "Mrs. Lane"],
      "gender": "Female",
      "dateOfBirths": ["1978-03-11"],
      "citizenships": ["SE"],
      "legalBasis": "terrorist",
      "source": {
        "name": "EU",
        "link": "http://eu.eu"
      },
      "listedDate": "1990-01-10"
    }
  ]
}

Fetch person contact details

POST /v1/applications.person.contactDetails.get

The endpoint returns the person contact details on an application.

Request

{
  "applicationId": "bits:application::4d72cbf4-070c-4b64-b8a6-86baaee34100"
}
PropertyTypeDescription
applicationIdstringIdentifies which application to fetch the information from.

Response

{
  "email": "lois.lane@metropolis.com",
  "phoneNumber": "+46701234567"
}