Signicat Data Verification API (1.0.0)

Download OpenAPI specification:Download

Signicat: support@signicat.com URL: https://developer.signicat.com/docs/support.html

Introduction

The Data Verification API returns normalised data from carefully-selected data sources through a single point of integration, making it easy for you to interpret and use the responses regardless of the source.

The Data Verification API is a RESTful API that uses the OAuth 2.0 protocol for authorisation. All request and response bodies are formatted in JSON.

This API reference provides information on available endpoints and how to interact with them. To learn more about the features of this product, visit the Data Verification documentation.

Get started

Initial preparations

Before you can use the API, you must have completed the following initial preparations:

Sign up to the Signicat Dashboard.
In the Signicat Dashboard, set up an organisation and an account. It is also possible to add a domain, but this is not necessary for this API.
You can find out how to configure these in our Initial setup instructions.

If you require support, you can contact us at support@signicat.com.

Get API client credentials

To access the Data Verification API, you need to create an API client and a client secret with the correct permissions. To connect and authenticate to the API, you need to complete the following steps:

You need to set up an API client as described in the set up an API client guide. From this step, you will obtain a Client ID and a Client Secret.
To connect to the Data Verification API you need to configure the required permissions for you API client. Ensure that you select both the Data Verification for natural persons and the Data Verification for organisations permissions.

We recommend that you create one API client per API product, but this can depend on your use case or configuration.

You are now all set to use the Data Verification API!

Learn more about how to authenticate and send your first request to the API in the Obtaining an access token documentation.

Organizations

This API returns information about an organization.

Learn more about the different data sources in the developer documentation. Also, refer to Sources section (below) to learn how to configure the data sources which you would like to use.

Basic

Retrieve basic info about an organization

path Parameters

country required	string ISO 3166-1 country code
id required	string Id of the organization

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax`, `external` and `IBAN`, defaults to `organization` or `IBAN` based on endpoint and is only used by a limited number of sources.
name	string Company Name
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"name": "SIGNICAT AS",
"names": [{"name": "SIGNICAT AS",
"type": "registered",
"start": null,
"end": null
}
],
"organizationNumber": "989584022",
"vatNumber": "989584022",
"registrationDate": null,
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
},
"businessAddress": {"street": "Gryta 2A",
"postalCode": "7010",
"city": "TRONDHEIM",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
},
"addresses": [{"type": "postal",
"startDate": null,
"endDate": null,
"isActive": true,
"street": "Postboks 1234",
"postalCode": "0001",
"city": "OSLO",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
},
{"type": "business",
"startDate": null,
"endDate": null,
"isActive": true,
"street": "Gryta2A",
"postalCode": "7010",
"city": "TRONDHEIM",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
}
],
"organizationType": {"name": "Aksjeselskap",
"code": "AS",
"url": "https://data.brreg.no/enhetsregisteret/api/organisasjonsformer"
},
"legalStatus": "active",
"employees": 132,
"industries": [{"code": "58.29",
"description": "Other software publishing",
"section": "J",
"level": 4
}
],
"contact": null,
"metadata": {"sources": ["no-brreg"
],
"urls": ["https://data.brreg.no/enhetsregisteret/api/enheter/989584022"
],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Authorization

This endpoint returns which people are allowed to sign and act on behalf of an organization.
If multiple people have to sign together, those people will be mentioned together in a so-called “combination”. If multiple combinations exist, they will all be calculated by the API and returned. The API will report if it was able to calculate all combinations, only a part of the possible combinations, or no combinations. The API will also return a list of the individual people with signing rights and their respective roles.

path Parameters

country required	string ISO 3166-1 country code
id required	string Id of the organization

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax`, `external` and `IBAN`, defaults to `organization` or `IBAN` based on endpoint and is only used by a limited number of sources.
name	string Company Name
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"signature": {"status": "complete",
"description": "Styret i fellesskap, Styrets leder alene",
"combinations": [{"signers": [{"name": {"status": "partial",
"full": "Anne Marie Dahl",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1970-04-02",
"role": {"code": "boardLeader",
"description": "Styrets leder"
}
},
{"name": {"status": "partial",
"full": "Lars Nilsen",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1983-10-26",
"role": {"code": "boardMember",
"description": "Styremedlem"
}
},
{"name": {"status": "partial",
"full": "Kari Elisabeth Strand",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1988-07-07",
"role": {"code": "boardMember",
"description": "Styremedlem"
}
}
],
"description": "Styret i fellesskap"
},
{"signers": [{"name": {"status": "partial",
"full": "Anne Marie Dahl",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1970-04-02",
"role": {"code": "boardLeader",
"description": "Styrets leder"
}
}
],
"description": "Styrets leder alene"
}
],
"basis": {"people": [{"name": {"status": "partial",
"full": "Anne Marie Dahl",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1970-04-02",
"role": {"code": "boardLeader",
"description": "Styrets leder"
},
"roles": [{"code": "boardLeader",
"description": "Styrets leder"
}
]
},
{"name": {"status": "partial",
"full": "Lars Nilsen",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1983-10-26",
"role": {"code": "boardMember",
"description": "Styremedlem"
},
"roles": [{"code": "boardMember",
"description": "Styremedlem"
}
]
},
{"name": {"status": "partial",
"full": "Kari Elisabeth Strand",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1983-07-07",
"role": {"code": "boardMember",
"description": "Styremedlem"
},
"roles": [{"code": "boardMember",
"description": "Styremedlem"
}
]
},
{"name": {"status": "partial",
"full": "Øystein Magnus Haugen",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1980-05-01",
"role": {"code": "ceo",
"description": "Daglig leder/administrerende direktør"
},
"roles": [{"code": "ceo",
"description": "Daglig leder/administrerende direktør"
}
]
}
]
},
"metadata": {"sources": ["no-brreg"
],
"urls": ["https://data.brreg.no/enhetsregisteret/api/enheter/989584022"
],
"lastChanged": null,
"rawJson": null
}
},
"powerOfProcuration": {"status": "complete",
"description": "Daglig leder alene",
"combinations": [{"signers": [{"name": {"status": "partial",
"full": "Øystein Magnus Haugen",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "1980-05-01",
"role": {"code": "ceo",
"description": "Daglig leder/administrerende direktør"
}
}
],
"description": "Daglig leder alene"
}
],
"basis": {"people": [{"name": null,
"dateOfBirth": null,
"role": null,
"roles": null
}
]
},
"metadata": {"sources": ["no-brreg"
],
"urls": ["https://data.brreg.no/enhetsregisteret/api/enheter/989584022/prokura"
],
"lastChanged": null,
"rawJson": null
}
},
"metadata": {"accountingYear": null,
"sources": ["no-brreg"
],
"urls": ["https://data.brreg.no/fullmakt/enheter/989584022/prokura",
"https://data.brreg.no/fullmakt/enheter/989584022/signatur"
],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Ownership

Retrieve ownership info for an organization

path Parameters

country required	string ISO 3166-1 country code
id required	string Id of the organization

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax`, `external` and `IBAN`, defaults to `organization` or `IBAN` based on endpoint and is only used by a limited number of sources.
name	string Company Name
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"companies": [{"name": "SIGNICAT AS",
"organizationNumber": {"domestic": "989584022",
"dunsNumber": null,
"legalEntityIdentifier": null
},
"percentage": 75,
"percentageRange": null,
"votingRights": null,
"votingRightsRange": null
}
],
"persons": [{"name": {"status": "partial",
"full": "LARS NILSEN",
"first": null,
"last": null,
"middle": null
},
"dateOfBirth": "0000-00-00",
"percentage": 25,
"percentageRange": null,
"votingRights": null,
"votingRightsRange": null
}
],
"otherShareholders": null,
"metadata": {"sources": ["no-bisnode"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Roles

Retrieve information about roles in an organization

path Parameters

country required	string ISO 3166-1 country code
id required	string Id of the organization

query Parameters

expand	Array of strings Optionally request one or more attributes, by default all available attributes are included.
idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax`, `external` and `IBAN`, defaults to `organization` or `IBAN` based on endpoint and is only used by a limited number of sources.
name	string Company Name
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"persons": [{"name": {"status": "all",
"full": "SKJEGGESTAD THOMAS",
"first": "THOMAS",
"last": "SKJEGGESTAD",
"middle": null
},
"address": {"street": "KAMFJORDÅSEN 86",
"postalCode": "3227",
"city": "SANDEFJORD",
"country": null
},
"dateOfBirth": "1956-02-03",
"nationality": null,
"identityNumber": null,
"role": "ceo",
"roles": [{"role": "ceo",
"startDate": null,
"endDate": null
}
]
},
{"name": {"status": "all",
"full": "LANGLI MAIA ANNE",
"first": "MAIA",
"last": "LANGLI",
"middle": "ANNE"
},
"address": {"street": "EBBESENS GATE 191",
"postalCode": "1636",
"city": "FREDRIKSTAD",
"country": null
},
"dateOfBirth": "1972-11-17",
"nationality": null,
"identityNumber": null,
"role": "boardLeader",
"roles": [{"role": "boardLeader",
"startDate": null,
"endDate": null
}
]
},
{"name": {"status": "all",
"full": "SØRHAUG LINE HEDVIG",
"first": "LINE",
"last": "SØRHAUG",
"middle": "HEDVIG"
},
"address": {"street": "HAUGSTUA 204",
"postalCode": "9017",
"city": "TROMSØ",
"country": null
},
"dateOfBirth": "1965-05-19",
"nationality": null,
"identityNumber": null,
"role": "boardMember",
"roles": [{"role": "boardMember",
"startDate": null,
"endDate": null
}
]
},
{"name": {"status": "all",
"full": "JULIE BAUDIN",
"first": "JULIE",
"last": "BAUDIN",
"middle": null
},
"address": {"street": "UTVANDRET",
"postalCode": null,
"city": null,
"country": null
},
"dateOfBirth": "1966-03-22",
"nationality": null,
"identityNumber": null,
"role": "boardMember",
"roles": [{"role": "boardMember",
"startDate": null,
"endDate": null
}
]
}
],
"companies": [{"name": "Ernst & Young AS",
"organizationNumber": {"domestic": "976389387",
"dunsNumber": null,
"legalEntityIdentifier": null
},
"role": "accountant",
"roles": [{"role": "accountant",
"startDate": null,
"endDate": null
}
]
},
{"name": "AZETS INSIGHT AS",
"organizationNumber": {"domestic": "983338917",
"dunsNumber": null,
"legalEntityIdentifier": null
},
"role": "bookkeeper",
"roles": [{"role": "bookkeeper",
"startDate": null,
"endDate": null
}
]
}
],
"others": null,
"metadata": {"sources": ["no-bisnode"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Ultimate beneficial owners

Retrieve information about ultimate beneficial owners for an organization

path Parameters

country required	string ISO 3166-1 country code
id required	string Id of the organization

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax`, `external` and `IBAN`, defaults to `organization` or `IBAN` based on endpoint and is only used by a limited number of sources.
name	string Company Name
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"ultimateBeneficiaryOwners": [{"ownership": {"directOwnership": 100,
"directOwnershipRange": null,
"indirectOwnership": null,
"indirectOwnershipRange": null,
"integratedOwnership": null,
"integratedOwnershipRange": null,
"votingRights": null,
"votingRightsRange": null,
"votingPower": null,
"votingPowerRange": null
},
"name": {"status": "partial",
"full": "HANNESTAD MARIE GRETE",
"first": null,
"last": null,
"middle": null
},
"address": {"street": "REDDALSVEIEN 146",
"postalCode": "4886",
"city": "GRIMSTAD",
"country": null
},
"birth": {"monthOfBirth": "04",
"yearOfBirth": "1960",
"dateOfBirth": "1960-04-03",
"country": null
},
"gender": "unknown",
"identityNumber": null,
"nationality": null,
"role": "unknown"
}
],
"metadata": {"sources": ["no-bisnode"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Finance

Retrieve financial info for an organization

path Parameters

country required	string ISO 3166-1 country code
id required	string Id of the organization

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax`, `external` and `IBAN`, defaults to `organization` or `IBAN` based on endpoint and is only used by a limited number of sources.
name	string Company Name
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"creditRating": {"score": "AAA",
"ratingSystem": "Bisnode AAA",
"description": "Highest credit worthiness",
"link": "https://www.bisnode.com/about-bisnode/what-we-do/our-approach-to-risk-and-credit/credit-rating-model-company/",
"year": 2020
},
"numberOfPaymentRemarks": 0,
"profitAndLoss": [{"turnover": 231750000,
"grossProfit": 8305000,
"netProfit": -2706000,
"netProfitAfterTax": null,
"year": 2019,
"currency": "SEK"
},
{"turnover": 231750000,
"grossProfit": 8305000,
"netProfit": -2706000,
"netProfitAfterTax": null,
"year": 2018,
"currency": "SEK"
},
{"turnover": 231750000,
"grossProfit": 8305000,
"netProfit": -2706000,
"netProfitAfterTax": null,
"year": 2017,
"currency": "SEK"
}
],
"netWorth": [ ],
"metadata": {"sources": ["bisnode"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Account Holder Verification

Retrieve account details if a bank account is found (using an IBAN) and it matches the name provided.

path Parameters

country required	string ISO 3166-1 country code
accountNumber required	string Account number of the organization

query Parameters

idList	Array of strings Parameter used to specify a list of id checks. Allowed values are `NL_KVK`, `NL_KVK_BRANCH`, `EU_VAT`, `FR_SIREN`, `FR_SIRET` and `UK_CRN`. This parameter applies to a limited number of sources. For data sources in Italy, this is a required parameter and must be set to `EU_VAT`. Format to specify the attribute should be as follows NL_KVK, 01234565
idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax`, `external` and `IBAN`, defaults to `organization` or `IBAN` based on endpoint and is only used by a limited number of sources.
name	string Company Name
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source
id	string Id of the organization

Responses

Response samples

Content type

application/json

{"accountNumber": "string",
"isValidAccountNumber": true,
"validationDetails": [{"isMatching": true,
"matchType": "unknown",
"description": "string"
}
],
"country": {"name": "string",
"alpha2": "string",
"alpha3": "string",
"numeric": "string"
},
"accountDetails": {"accountType": "unknown",
"accountStatus": "unknown",
"isJoinedAccount": true,
"numberOfHolders": 0,
"foreign": true,
"countryOfAccount": {"name": "string",
"alpha2": "string",
"alpha3": "string",
"numeric": "string"
}
},
"metadata": {"sources": ["string"
],
"urls": ["string"
],
"lastChanged": "2019-08-24T14:15:22Z",
"rawJson": "string",
"isCache": true
}
}

Screening

AML/CFT screening against lists with politically exposed persons (PEP), sanctions and adverse media.

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax` and `external`, defaults to `organization` and is only used by a limited number of sources.
countries	string <= 50 characters Comma-separated list of countries to include in the search - ISO 3166-1 format
id	string <= 100 characters Id of the entity to search for
name	string <= 100 characters Name of the entity to search for
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source
listType	string Comma-separated string of list types to screen against, defaults to all lists. Allowed values are `pep`, `sanction` and `adverseMedia`.
offset	integer <int32> Used for paging
limit	integer <int32> Set how many results you want per page (max/default 100)

Responses

Response samples

Content type

application/json

{"offset": 0,
"limit": 100,
"size": 1,
"links": {"next": null,
"previous": null,
"first": "http://k8s-test.signicat.io/information/organizations/screening?listType=pep%2csanction&name=OrgName&limit=100",
"self": null
},
"data": [{"entityType": "organization",
"listType": "sanction",
"matchStrength": {"score": 20,
"certainty": "low"
},
"sourceName": "SCREENING_SOURCE",
"name": {"status": "partial",
"full": "OrgName AB",
"first": null,
"last": null,
"middle": null
},
"gender": "unknown",
"aliases": [{"status": "partial",
"full": "OrgName AB",
"first": null,
"last": null,
"middle": null
}
],
"associates": [ ],
"datesOfBirth": [ ],
"addresses": [{"street": "Hålebäcksvägen 7",
"postalCode": "79026",
"city": "ENVIKEN",
"country": {"name": null,
"alpha2": "SE",
"alpha3": "SWE",
"numeric": "752"
}
}
],
"comments": [ ],
"functions": [ ],
"media": [{"title": null,
"excerpt": null,
"url": "https://google.com",
"date": null
}
],
"roles": [{"roleType": "Type of role",
"organization": "Organization Name",
"description": "Role description",
"startDate": null,
"endDate": null
}
]
}
],
"metadata": {"sources": ["trapets"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Search - Beta

Search for an organization.

        Remarks when searching multiple sources:
        Functionality is subject to change without prior notice.

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `organization`, `tax` and `external`, defaults to `organization` and is only used by a limited number of sources.
countries	string <= 50 characters Comma-separated list of countries to include in the search - ISO 3166-1 format
id	string <= 100 characters Id of the entity to search for
name	string <= 100 characters Name of the entity to search for
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source
cursor	string Cursor returned for paginating multiple sources, cannot be used together with `offset` and `limit`.
offset	integer <int32> Used for paging
limit	integer <int32> Set how many results you want per page (max/default 100)

Responses

Response samples

Content type

application/json

{"offset": 0,
"limit": 100,
"size": 1,
"links": {"next": null,
"previous": null,
"first": "https://api.signicat.com/info/lookup/organizations/search?countries=no&name=signicat&cursor=eyJpi45...",
"self": "https://api.signicat.com/info/lookup/organizations/search?countries=no&name=signicat&cursor=eyJpi45..."
},
"data": [{"organizationNumber": "989584022",
"taxNumber": "832879",
"externalId": "NO989584022",
"name": "SIGNICAT AS",
"links": {"self": "https://api.signicat.com/info/lookup/countries/NO/organizations/989584022"
},
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
},
"address": null
}
],
"metadata": {"sources": ["no-brreg",
"opencorporates"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Persons

This API returns information about a person.

Learn more about the different data sources in the developer documentation. Also, refer to Sources section (below) to learn how to configure the data sources which you would like to use.

Basic

Retrieve basic info about a person

path Parameters

country

required

string

ISO 3166-1 country code

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `PersonalId`, `Passport`, `IdentityCard`, `DriversLicense`, `TravelDocument`, `ResidentPermit`, `TaxNumber` and `VoterId`, defaults to `PersonalId` and is only used by a limited number of sources.
identityNumber	string The national identity number used to identify the person
givenName	string The persons given name
surname	string The persons surname
dateOfBirth	string or null <yyyy-MM-dd> The persons date of birth
caseRef	string Case reference if required by the source
street	string The persons street address
streetNumber	string The persons street address number
postalCode	string The persons postal code
city	string The persons city place
gender	string The person's gender. Optional parameter. Allowed values are `Male`, `Female`, `Other`, `Unknown`. Defaults to `Unknown` and only applies to a limited number of data sources.
phoneNumber	string PhoneNumber for the Identity verification
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"names": [{"isActive": true,
"startDate": "1997-03-04T12:30:00.000Z",
"endDate": null,
"status": "all",
"full": "Esther Kristin Hall",
"first": "Esther",
"last": "Hall",
"middle": "Kristin"
}
],
"birth": {"location": "TØNSBERG",
"monthOfBirth": "March",
"yearOfBirth": "1997",
"dateOfBirth": "1997-03-02",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
},
"death": {"isDead": true,
"monthOfDeath": "04",
"yearOfDeath": "2017",
"dateOfDeath": "2017-04-09"
},
"nationalities": [{"isActive": true,
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
},
"startDate": "1997-03-04T12:30:00.000Z",
"endDate": null
}
],
"citizenships": null,
"permanentAddresses": [{"isActive": true,
"isConfidential": true,
"startDate": "2018-08-02T12:30:00.000Z",
"endDate": null,
"addressLines": null,
"street": "Tistelvegen 207",
"postalCode": "7033",
"city": "TRONDHEIM",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
}
],
"postalAddresses": [{"isActive": true,
"isConfidential": true,
"startDate": "2018-08-02T12:30:00.000Z",
"endDate": null,
"addressLines": null,
"street": "Tistelvegen 207",
"postalCode": "7033",
"city": "TRONDHEIM",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
}
],
"foreignAddresses": [ ],
"metadata": {"sources": ["no-infotorg-dsf"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Address Deprecated

Retrieve address info for a person. This endpoint is deprecated, use Basic instead.

path Parameters

country

required

string

ISO 3166-1 country code

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `PersonalId`, `Passport`, `IdentityCard`, `DriversLicense`, `TravelDocument`, `ResidentPermit`, `TaxNumber` and `VoterId`, defaults to `PersonalId` and is only used by a limited number of sources.
identityNumber	string The national identity number used to identify the person
givenName	string The persons given name
surname	string The persons surname
dateOfBirth	string or null <yyyy-MM-dd> The persons date of birth
caseRef	string Case reference if required by the source
street	string The persons street address
streetNumber	string The persons street address number
postalCode	string The persons postal code
city	string The persons city place
gender	string The person's gender. Optional parameter. Allowed values are `Male`, `Female`, `Other`, `Unknown`. Defaults to `Unknown` and only applies to a limited number of data sources.
phoneNumber	string PhoneNumber for the Identity verification
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"permanent": {"street": "Tors veg 30 C",
"postalCode": "7035",
"city": "TRONDHEIM",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
},
"postal": {"street": "Mjølnervegen 6",
"postalCode": "7035",
"city": "TRONDHEIM",
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
},
"foreign": null,
"metadata": {"sources": ["no-freg"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Finance

Retrieve finance info for a person

path Parameters

country

required

string

ISO 3166-1 country code

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `PersonalId`, `Passport`, `IdentityCard`, `DriversLicense`, `TravelDocument`, `ResidentPermit`, `TaxNumber` and `VoterId`, defaults to `PersonalId` and is only used by a limited number of sources.
identityNumber	string The national identity number used to identify the person
givenName	string The persons given name
surname	string The persons surname
dateOfBirth	string or null <yyyy-MM-dd> The persons date of birth
caseRef	string Case reference if required by the source
street	string The persons street address
streetNumber	string The persons street address number
postalCode	string The persons postal code
city	string The persons city place
gender	string The person's gender. Optional parameter. Allowed values are `Male`, `Female`, `Other`, `Unknown`. Defaults to `Unknown` and only applies to a limited number of data sources.
phoneNumber	string PhoneNumber for the Identity verification
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"creditScore": {"score": "4",
"scoringSystem": "Bisnode AAA",
"link": null,
"year": null
},
"numberOfPaymentRemarks": 1,
"incomeAndWealth": [{"year": 2019,
"currency": "NOK",
"grossIncome": 302461,
"netIncome": 164092,
"wealth": 102002
},
{"year": 2018,
"currency": "NOK",
"grossIncome": null,
"netIncome": 131897,
"wealth": 90675
}
],
"metadata": {"sources": ["bisnode"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Identity Verification

Verification of a person identity

path Parameters

country

required

string

ISO 3166-1 country code

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `PersonalId`, `Passport`, `IdentityCard`, `DriversLicense`, `TravelDocument`, `ResidentPermit`, `TaxNumber` and `VoterId`, defaults to `PersonalId` and is only used by a limited number of sources.
identityNumber	string The national identity number used to identify the person
givenName	string The persons given name
surname	string The persons surname
dateOfBirth	string or null <yyyy-MM-dd> The persons date of birth
caseRef	string Case reference if required by the source
street	string The persons street address
streetNumber	string The persons street address number
postalCode	string The persons postal code
city	string The persons city place
gender	string The person's gender. Optional parameter. Allowed values are `Male`, `Female`, `Other`, `Unknown`. Defaults to `Unknown` and only applies to a limited number of data sources.
phoneNumber	string PhoneNumber for the Identity verification
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"status": "notIdentified",
"description": "string",
"metadata": {"sources": ["string"
],
"urls": ["string"
],
"lastChanged": "2019-08-24T14:15:22Z",
"rawJson": "string",
"isCache": true
}
}

Account Holder Verification

Retrieve account details if a bank account is found (using an IBAN) and it matches the name provided.

path Parameters

country required	string ISO 3166-1 country code
accountNumber required	string Account number of the person

query Parameters

idType	string Optional hint to what kind of id being used. Allowed values are `PersonalId`, `Passport`, `IdentityCard`, `DriversLicense`, `TravelDocument`, `ResidentPermit`, `TaxNumber` and `VoterId`, defaults to `PersonalId` and is only used by a limited number of sources.
identityNumber	string The national identity number used to identify the person
givenName	string The persons given name
surname	string The persons surname
dateOfBirth	string or null <yyyy-MM-dd> The persons date of birth
caseRef	string Case reference if required by the source
street	string The persons street address
streetNumber	string The persons street address number
postalCode	string The persons postal code
city	string The persons city place
gender	string The person's gender. Optional parameter. Allowed values are `Male`, `Female`, `Other`, `Unknown`. Defaults to `Unknown` and only applies to a limited number of data sources.
phoneNumber	string PhoneNumber for the Identity verification
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source

Responses

Response samples

Content type

application/json

{"accountNumber": "string",
"isValidAccountNumber": true,
"validationDetails": [{"isMatching": true,
"matchType": "unknown",
"description": "string"
}
],
"country": {"name": "string",
"alpha2": "string",
"alpha3": "string",
"numeric": "string"
},
"accountDetails": {"accountType": "unknown",
"accountStatus": "unknown",
"isJoinedAccount": true,
"numberOfHolders": 0,
"foreign": true,
"countryOfAccount": {"name": "string",
"alpha2": "string",
"alpha3": "string",
"numeric": "string"
}
},
"metadata": {"sources": ["string"
],
"urls": ["string"
],
"lastChanged": "2019-08-24T14:15:22Z",
"rawJson": "string",
"isCache": true
}
}

Search - Beta

Search for an person. Functionality is subject to change without prior notice.

query Parameters

dateOfBirth	string <= 10 characters Date of birth of the entity to search for, accepted formats: `yyyy-MM-dd`, `yyyy-MM` or `yyyy`
postalCode	string Search person through postal code
countries	string <= 50 characters Comma-separated list of countries to include in the search - ISO 3166-1 format
id	string <= 100 characters Id of the entity to search for
name	string <= 100 characters Name of the entity to search for
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source
offset	integer <int32> Used for paging
limit	integer <int32> Set how many results you want per page (max/default 100)

Responses

Response samples

Content type

application/json

{"offset": 0,
"limit": 100,
"size": 1,
"links": {"next": null,
"previous": null,
"first": null,
"self": null
},
"data": [{"id": null,
"name": {"status": "partial",
"full": "Example Full Name",
"first": null,
"last": null,
"middle": null
},
"country": {"name": null,
"alpha2": "NO",
"alpha3": "NOR",
"numeric": "578"
}
}
],
"metadata": {"sources": ["no-freg",
"fi-dvv"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Screening

AML/CFT screening against lists with politically exposed persons (PEP), sanctions and adverse media.

query Parameters

dateOfBirth	string <= 10 characters Date of birth of the entity to search for, accepted formats: `yyyy-MM-dd`, `yyyy-MM` or `yyyy`
postalCode	string Search person through postal code
countries	string <= 50 characters Comma-separated list of countries to include in the search - ISO 3166-1 format
id	string <= 100 characters Id of the entity to search for
name	string <= 100 characters Name of the entity to search for
source	string <= 50 characters Optional name of the source to use
rawJson	boolean Optionally include the raw data received from the upstream if supported by the source
listType	string Comma-separated string of list types to screen against, defaults to all lists. Allowed values are `pep`, `sanction` and `adverseMedia`.
offset	integer <int32> Used for paging
limit	integer <int32> Set how many results you want per page (max/default 100)

Responses

Response samples

Content type

application/json

{"offset": 0,
"limit": 100,
"size": 1,
"links": {"next": null,
"previous": null,
"first": "http://k8s-test.signicat.io/information/organizations/screening?listType=pep%2csanction&name=OrgName&limit=100",
"self": null
},
"data": [{"entityType": "organization",
"listType": "sanction",
"matchStrength": {"score": 20,
"certainty": "low"
},
"sourceName": "SCREENING_SOURCE",
"name": {"status": "partial",
"full": "OrgName AB",
"first": null,
"last": null,
"middle": null
},
"gender": "unknown",
"aliases": [{"status": "partial",
"full": "OrgName AB",
"first": null,
"last": null,
"middle": null
}
],
"associates": [ ],
"datesOfBirth": [ ],
"addresses": [{"street": "Hålebäcksvägen 7",
"postalCode": "79026",
"city": "ENVIKEN",
"country": {"name": null,
"alpha2": "SE",
"alpha3": "SWE",
"numeric": "752"
}
}
],
"comments": [ ],
"functions": [ ],
"media": [{"title": null,
"excerpt": null,
"url": "https://google.com",
"date": null
}
],
"roles": [{"roleType": "Type of role",
"organization": "Organization Name",
"description": "Role description",
"startDate": null,
"endDate": null
}
]
}
],
"metadata": {"sources": ["trapets"
],
"urls": [ ],
"lastChanged": null,
"rawJson": null,
"isCache": false
}
}

Sources

Contains information about the different sources used by the API.

It is possible to instruct the API to use a preferred source across profiles by including a JWT of the following model in the request headers. { "ver": 1, "rules": [ { "scope": [ "basic", ], "sources": [ "nameOfSource" ] } ], "strict": true }

If the source is specified by query parameter for a request, this will be used instead of any header.

Organization

Returns the data sources available for organizations.

Responses

Response samples

200

Content type

application/json

{"providers": {"global": [{"id": "3b69a782-2c28-4fb2-b27e-5b3c14743b3d",
"profiles": ["screening"
],
"name": "trapets",
"description": "PEP and Sanction screening against Trapets InstantWatch KYC"
}
],
"no": [{"id": "221a4e31-11fb-417b-a9dc-ee49bd630f6c",
"profiles": ["ownership",
"ubo",
"roles"
],
"name": "no-bisnode",
"description": "Provides data from bisnode"
},
{"id": "97dd9017-cdc5-4f32-b937-1ce57815ba6d",
"profiles": ["basic",
"authorization"
],
"name": "no-brreg",
"description": "Provides data from brreg"
}
],
"fi": [{"id": "17066a39-74af-4c61-a6c9-d2f490ad2dd9",
"profiles": ["basic"
],
"name": "fi-prh",
"description": "Prh organization lookup"
},
{"id": "32747ec3-aee2-44d8-b6c0-ffeec3430d50",
"profiles": ["ubo",
"roles",
"authorization"
],
"name": "fi-bisnode",
"description": "Bisnode Finland companies API"
},
{"id": "2e657179-83f9-4ea8-9306-4744a5c50257",
"profiles": ["ownership",
"roles"
],
"name": "fi-asiakastieto",
"description": "Asiakastieto organization lookup"
}
],
"se": [{"id": "995934e9-766c-48b0-ac8f-3a870f7cb54c",
"profiles": ["basic",
"ubo",
"roles",
"authorization"
],
"name": "se-bolagsverket",
"description": "Provides data from Bolagsverket"
}
],
"be": [{"id": "c355866a-67c5-4c38-bfd3-9b5303d9c9e8",
"profiles": ["basic",
"roles"
],
"name": "be-databe",
"description": "Databe organization lookup"
},
{"id": "a1b7fc00-7fbe-4427-b7ee-9b98ff458690",
"profiles": ["basic"
],
"name": "dk-cvr",
"description": "Provides data from CVR - det Centrale Virk"
}
]
},
"profiles": ["authorization",
"basic",
"finance",
"ownership",
"roles",
"screening",
"ubo"
]
}

Natural person

Returns the data sources available for natural persons.

Responses

Response samples

200

Content type

application/json

{"providers": {"no": [{"id": "a76fc04c-0c7c-488b-b138-07c1ccb7ad2e",
"profiles": ["address"
],
"name": "no-freg",
"description": "Norwegian population registry lookup"
},
{"id": "e09bf673-15b3-4c5c-b713-8145e8a418dc",
"profiles": ["address"
],
"name": "no-infotorg-dsf",
"description": "Norwegian population registry lookup through Infotorg"
}
],
"fi": [{"id": "815cfd0b-f587-40cb-9782-60ec2dd4323d",
"profiles": ["address"
],
"name": "fi-dvv",
"description": "Dvv person lookup"
}
],
"se": [{"id": "56103e78-0da1-41bd-a8a9-f776d44a213e",
"profiles": ["address"
],
"name": "se-spar",
"description": "Statens Personadressregister lookup"
}
],
"dk": [{"id": "5ea4c5f6-740d-4621-8c31-be4a1858580c",
"profiles": ["address"
],
"name": "dk-cpr",
"description": "Provides data from CPR - Det Centrale Personregister"
}
]
},
"profiles": ["address"
]
}

BusinessRegistry

List registration authorities

Retrieves a list of business registration authorities globally

Responses

Response samples

200

Content type

application/json

[{"self_url": "https://api.signicat.com/info/lookup/businessregistry/RA000071",
"authorityCode": "RA000071",
"countryCode": "CM",
"country": "Cameroon",
"localizedName": "Planning and Regional De…t (Ministry of Economy)",
"internationalName": "Planning and Regional De…t (Ministry of Economy)",
"jurisdiction": "Cameroon"
},
{"self_url": "https://api.signicat.com/info/lookup/businessregistry/RA000201",
"authorityCode": "RA000201",
"countryCode": "DE",
"country": "Germany",
"localizedName": "Handelsregister",
"internationalName": "Commercial Register",
"jurisdiction": "Ansbach"
}
]

Retrieve registration authority

Retrieves detailed information about a specific registration authority

path Parameters

authorityCode

required

string

Responses

Response samples

200
404

Content type

application/json

{"responsibleOrgLocalizedName": "Centre National du Registre du Commerce (CNRC)",
"responsibleOrgInternationalName": "National Center of the Trade Register",
"website": "https://sidjilcom.cnrc.dz/web/cnrc/accueil",
"authorityCode": "RA000003",
"countryCode": "DZ",
"country": "Algeria",
"localizedName": "Registre du Commerce",
"internationalName": "Trade Register",
"jurisdiction": "Algeria"
}

Geodata

List countries

Lists all countries in the world with English name and ISO 3166-1 country code

query Parameters

lang	string Default: "en" Language for result. Defaults to English

Responses

Response samples

200

Content type

application/json

[{"self_url": "https://api.signicat.com/info/lookup/geodata/countries/AD?lang=en",
"countryCode": "AD",
"countryName": "Andorra",
"isoAlpha3": "AND",
"isoNumeric": "020"
},
{"self_url": "https://api.signicat.com/info/lookup/geodata/countries/BG?lang=en",
"countryCode": "BG",
"countryName": "Bulgaria",
"isoAlpha3": "BGR",
"isoNumeric": "100"
},
{"self_url": "https://api.signicat.com/info/lookup/geodata/countries/CH?lang=en",
"countryCode": "CH",
"countryName": "Switzerland",
"isoAlpha3": "CHE",
"isoNumeric": "756"
}
]

Retrieve country info

Retrieves basic geographical information about a country

path Parameters

countryCode

required

string

ISO 3166-1 alpha-2 country code to look up

query Parameters

lang	string Default: "en" Language for result. Defaults to English

Responses

Response samples

200
404

Content type

application/json

{"self_url": "https://api.signicat.com/info/lookup/geodata/countries/AD?lang=en",
"subdivisions_url": "https://api.signicat.com/info/lookup/geodata/countries/AD/subdivisions?lang=en",
"continent": "EU",
"capital": "Andorra la Vella",
"languages": ["ca"
],
"population": "77006",
"countryCode": "AD",
"isoAlpha3": "AND",
"countryName": "Andorra",
"continentName": "Europe",
"currencyCode": "EUR",
"isoNumeric": "020"
}

List country subdivisions

Retrieves a list over top level administrative subdivisions for a country with name and ISO 3166-2 region code

path Parameters

countryCode

required

string

ISO 3166-1 alpha-2 country code to look up

query Parameters

lang	string Default: "en" Language for result. Defaults to English

Responses

Response samples

200
404

Content type

application/json

[{"name": "Andorra la Vella",
"isoCode": "07"
},
{"name": "La Massana",
"isoCode": "04"
},
{"name": "Ordino",
"isoCode": "05"
},
{"name": "Sant Julià de Loria",
"isoCode": "06"
},
{"name": "Canillo",
"isoCode": "02"
},
{"name": "Escaldes-Engordany",
"isoCode": "08"
},
{"name": "Encamp",
"isoCode": "03"
}
]