Screening results

A search response has one entry per subject, and each entry carries the list entries that matched it. This page describes every property so hits can be interpreted correctly. Property names are camelCase and properties with a null value are omitted.

Company and person screenings return a compact form with a short line per hit, described in Company and person screening; the full entry of one of their hits has the Hit properties below.

Top level

Order

Summary

SubjectResult

Hit

One list entry that matched a subject. A person entry and an organisation entry share the same shape; properties that only apply to one of them are marked.

Role

A public or political function held by a person. Present on PEP entries.

Relationship

A connection between the list entry and another person or organisation. relationshipType is what the named person is to the entry: on a PEP, Spouse names the PEP’s spouse. On the tic engine family members and close associates are on the list as persons: a hit for a PEP’s spouse names the PEP under relationships, see Hits with tic.

Engagement

Reserved for a role or ownership in a company. The lists do not populate this data today, so the array is empty or absent.

Example response

Two subjects were screened. The first produced one PEP hit, the second produced nothing.

{
  "requestedAtUtc": "2026-09-03T09:14:22.318Z",
  "testMode": false,
  "order": {
    "documentOrderGuid": "3f1c9b2e-7d44-4a1b-9c0e-2b6f0a8d5e71",
    "orderedAtUtc": "2026-09-03T09:14:22.301Z",
    "price": 5.00,
    "currency": "SEK"
  },
  "summary": {
    "subjectCount": 2,
    "individualHitCount": 1,
    "entityHitCount": 0,
    "totalHitCount": 1,
    "servicesQueried": ["EU_GLOBAL", "UN_CONSOLIDATED", "OFAC", "PEP_Edge"]
  },
  "results": [
    {
      "reference": "cust-1001",
      "name": "Anna Exempelsson",
      "hitCount": 1,
      "hits": [
        {
          "type": "individual",
          "name": "Anna Exempelsson",
          "birthDate": "1975-04-12",
          "hitRating": 4,
          "hitRatingDescription": "Träff på namn och födelseår eller födelsedatum",
          "listType": "PEP",
          "listItemDataType": "Individual",
          "sourceName": "PEP_Edge",
          "externalId": "SE-113942",
          "lastUpdatedUtc": "2026-08-30T02:15:07",
          "isMale": false,
          "countries": ["SWE"],
          "citizenships": ["SWE"],
          "aliases": ["Anna Exempelsson", "Anna Maria Exempelsson"],
          "roles": [
            {
              "roleType": "NationalLegislature",
              "roleTypeDescription": "Nationalförsamling",
              "title": "Riksdagsledamot",
              "organization": "National Parliament",
              "from": "20220926"
            }
          ],
          "relationships": [
            {
              "name": "Karl Exempelsson",
              "relationshipType": "Spouse"
            }
          ]
        }
      ]
    },
    {
      "reference": "cust-1002",
      "identityNumber": "5560000000",
      "hitCount": 0,
      "hits": []
    }
  ]
}

Warnings and errors

A 200 OK response can still carry warnings and errors about individual subjects. Both are arrays of strings. Each message starts with the subject’s reference (or its name or identity number if no reference was given) so it can be tied back to a subject.

• Warning - the subject was screened, but part of its data was ignored. An invalid country code such as SWD produces a warning and the code is disregarded.
• Error - the subject was not screened. The other subjects in the call were. Its result has notScreenedReason screeningError, also when the screening is fetched again.

When no subject could be screened, the call fails with 502 and code screening_failed instead: nothing is stored or billed, and you can try again.

HTTP status codes

Reference values

Role types

Values of roleType on a Role. roleTypeDescription carries it in words.

Legal forms

Values of legalForm on an organisation hit.

LimitedCompany, PrivateBusinessGovCtrl, ForeignCompany, Bank, SoleProprietorship, GeneralPartnership, Society, Foundation, HousingCompany, StateCountyCompany, ReligiousOrganization, InsuranceCompany, Collaborations

Operational status

Values of operationalStatus on an organisation hit.

Active, InactiveSleeping, UnderLiquidation, Liquidated, UnderBankruptcy, Bankrupt, Dissolved, Merged, Unregistered, Unknown, Dissolving, DissolvingByForce, DissolvedByForce, UnderReconstruction, CompanyDataOutOfDate

Engagement types

Values of engagementType on an Engagement, for when the lists start populating engagements.

Accountant, AssistantStatistician, Associate, Bearer, BeneficialOwner, BoardMember, CEO, Chairman, Commissioner, CompanyStructureOwner, Deputy, DeputyAccountant, DeputyBoardMember, DeputyCEO, DeputyChairman, DeputyCommissioner, DeputyLaymanAccountant, DeputyLiquidator, EmployeeRepresentative, ExternalCEO, ExternalCompanySignatory, ExternalDeputyCEO, GeneralPartner, InsuranceRepresentative, KeyPerson, LaymanAccountant, LiableAccountant, LimitedPartner, Liquidator, Manager, ManagingClerk, NotificationRecipient, NotKnown, Owner, Procurator

Country types

The countries array on a hit merges every country registered to the entry. The underlying registrations are typed as Citizenship, Jurisdiction, Registration, Residential or Other. Only the Citizenship type is broken out separately, as citizenships.

Data not returned

The list entries hold more data than the API returns today. The following is available on the underlying entries but not exposed: postal addresses, additional identity documents such as passport numbers, images, the original list an entry was consolidated from, and for organisations the registered owners, representatives, beneficial owners, industry codes, foundation date and signatory rules. Contact support if your use case needs any of it.