Person credit report
postgetPersonReportTranslated
post
https://in.bisnode.ee/rest/getPersonReportTranslated
Needed Headers: Content-type: application/json
Includes various information about a person to evaluate trustworthiness of a person such as:
* General information
* Current tax arrears
* Trade bans
* Tags
* Debt collection cases
* Enforcements notices
* Court decisions on debt
* Payment remarks in connected companies
* Political parties
* Court cases
* Immovables ("noimmovables" report type doesn't include this information)
* Bancruptcy process notices
Example Curl request:
curl -X POST -k -H 'Content-type: application/json' -i 'https://in.bisnode.ee/rest/getPersonReportTranslated' --data '{
"token": "0c725874e737c8195de547f67692d8b976726561",
"code": "11111111",
"code_origin": "EST",
"type": "private",
"language": "en"
}'Request
Response
Request
Query Parameters
type
optional
string
Type of report. Must be "private" or "noimmovables". Default is "private".
language
optional
string
2-letter language code.Must be "en", "et" or "ru". Default is "en".
token
required
string
Your 'access token' (API key).
code
required
string
Personal code.
code_origin
required
string
3-letter country code.
Response
200: OK
{"header": {"created_at": "10\/07\/2019 15:04:12","created_by": "BISNODE ESTONIA AS","generator_class": "PersonReportCalculator","generator_version": "v1.0"},"report": {"pdf": "","html": "","created_at": "10\/07\/2019 15:04:12","type": "private"},"general": {"id": "111111","name": "Karl Karll","code": "11111111111","code_origin": {"type": "RIIGID","code": "EST","et": "Eesti","en": "Estonia","ru": "\u042d\u0441\u0442\u043e\u043d\u0438\u044f"},"birth_date": "1951-06-14","type": "person","gender": "M"},"tax_arrears_current": [{"amount": 0,"scheduled": 0,"disputed": 0,"intress": 0,"total": 0,"from": null,"num_of_declarations": 0}],"trade_ban": [{"type": {"type": "TRADE_BAN","code": "trade_ban","et": "\u00c4rikeeld","en": "Trade ban","ru": " \u0417\u0430\u043f\u0440\u0435\u0442 \u043d\u0430 \u0442\u043e\u0440\u0433\u043e\u0432\u043b\u044e"},"status": {"type": "TRADE_BAN","code": "IN_FORCE","et": "J\u00f5us","en": "In force","ru": "\u0412 \u0441\u0438\u043b\u0435"},"term_of_validity": "Pankrotimenetluse l\u00f5ppemiseni","scope": "Osaline 01.01.2017 Harju Maakohtu m\u00e4\u00e4rusega lubatud Karl Karll (isikukood 11111111111) tegutseda kuni pankrotimenetluse l\u00f5puni EBS Juhtimiskoolituse Keskus O\u00dc (registrikood 11111111), Aktsiaseltsi Estonian Business School Group (registrikood 11111111) ja Eesti Ol\u00fcmpiakomitee (registrikood 11111111) T\u00e4itevkomitee juhatuse liikmena.","start_date": "2015-03-13","end_date": "2019-06-17"}],"tags": [{"title": "Tankist","description": "Marked as tankist","slug": "tankist"}],"debt_collection_cases": [{"id": "150618","source_id": "18","company_id": null,"claimant": "Julianus Inkasso O\u00dc","reg_code": "39103274915","start_date": "2018-03-12","end_date": null,"area": {"type": "JULIANUS_AREA","code": "A4","et": "Muud finantsteenused","en": "Other financial services","ru": "\u0414\u0440\u0443\u0433\u0438\u0435 \u0444\u0438\u043d\u0430\u043d\u0441\u043e\u0432\u044b\u0435 \u0443\u0441\u043b\u0443\u0433\u0438"},"amount": "2232.56","status": {"type": "JULIANUS_STATUS","code": "A","et": "Avalikustatud","en": "Active","ru": "\u0410\u043a\u0442\u0438\u0432\u0435\u043d"},"last_seen": "2019-07-10","created_at": "2019-07-10 15:12:34","updated_at": "2019-07-10 15:12:34","source_name": "Julianus Inkasso O\u00dc","source_url": "https:\/www.taust.ee","active": true},{"id": "150626","source_id": "18","company_id": null,"claimant": "IPF Digital Estonia O\u00dc","reg_code": "39103274915","start_date": "2014-01-03","end_date": "2018-03-07","area": {"type": "JULIANUS_AREA","code": "A4","et": "Muud finantsteenused","en": "Other financial services","ru": "\u0414\u0440\u0443\u0433\u0438\u0435 \u0444\u0438\u043d\u0430\u043d\u0441\u043e\u0432\u044b\u0435 \u0443\u0441\u043b\u0443\u0433\u0438"},"amount": "2463.52","status": {"type": "JULIANUS_STATUS","code": "\u041a","et": "Lahendatud","en": "Resolved","ru": "\u0420\u0435\u0448\u0435\u043d"},"last_seen": "2018-03-07","created_at": "2019-07-10 15:12:34","updated_at": "2019-07-10 15:12:34","source_name": "Julianus Inkasso O\u00dc","source_url": "https:\/www.taust.ee","active": false}],"enforcement_notices": [{"debtor": {"type": "ATA_DEBTOR_TYPE","code": "F","et": "F\u00fc\u00fcsiline isik","en": "Individual","ru": "\u0424\u0438\u0437\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e"},"debtor_name": "Karl Karll","claimant": {"type": "ATA_CLAIMANT","code": "MUUD","et": "M\u00e4\u00e4ramata","en": "Unspecified","ru": "\u041d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d\u043e"},"action": {},"code": "11111111111","birth_date": null,"amount": "30114.11","created_at": "2017-09-08","checked_at": "2017-09-09"}],"court_decisions_on_debt": [{"debtor_type": {"type": "ATA_DEBTOR_TYPE","code": "F","et": "F\u00fc\u00fcsiline isik","en": "Individual","ru": "\u0424\u0438\u0437\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043b\u0438\u0446\u043e"},"debtor_name": "Karl Karll","claimant": {"type": "ATA_CLAIMANT","code": "MUUD","et": "M\u00e4\u00e4ramata","en": "Unspecified","ru": "\u041d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d\u043e"},"action": {"type": "ATA_ACTION","code": "maksek\u00e4sk","et": "Maksek\u00e4sk","en": "Order of payment","ru": "\u041f\u043b\u0430\u0442\u0435\u0436\u043d\u043e\u0435 \u043f\u043e\u0440\u0443\u0447\u0435\u043d\u0438\u0435"},"code": "11111111111","birth_date": null,"amount": "4856.35","created_at": "2019-06-10"}],"payment_remarks_in_connected_companies": [{"tax_arrears": false,"ata_debts": false,"debt_collection_cases": false,"company_name": "ABC O\u00dc","reg_code": "11111111","role": {"type": "ISIKROLLID","code": "JUHL","et": "Juhatuse liige","en": "Management board member","ru": "\u0427\u043b\u0435\u043d \u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u044f"},"status": {"type": "LEGAL_STATUS_EST","code": "A","et": "Aktiivne","en": "Active","ru": "\u0410\u043a\u0442\u0438\u0432\u043d\u044b\u0439"}}],"political_parties": [{"name": "Eesti Reformierakond","member_since": "2005-01-26","member_to": "2014-10-03"}],"court_cases": {"link": "https:\/\/www.riigiteataja.ee\/kohtulahendid\/koik_menetlused.html","total": 4,"cases": [{"case_no": "1-02-65442\\3","start_date": "2009-09-05","category": "","resolution_date": "2009-12-13","type_of_case": {"type": "COURT_CASE","code": "CC13","et": "Kriminaalasi","en": "Criminal case","ru": "\u0423\u0433\u043e\u043b\u043e\u0432\u043d\u043e\u0435 \u0434\u0435\u043b\u043e"},"type_of_proceeding": {"type": "COURT_CASE","code": "CC4","et": "Kohtu I astme menetlus","en": "Proceeding of court of first instance","ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0441\u0442\u0432\u043e I \u0441\u0442\u0435\u043f\u0435\u043d\u0438 "},"type_of_resolution": {"type": "COURT_CASE","code": "CC14","et": "Kohtuotsus","en": "Court decision","ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u0435"}},{"case_no": "1-05-98763\/27","start_date": "2018-10-31","category": "Isikuvastased s\u00fc\u00fcteod, Isikuvastased s\u00fc\u00fcteod, Rahvatervisevastased s\u00fc\u00fcteod","resolution_date": "2019-02-01","type_of_case": {"type": "COURT_CASE","code": "CC13","et": "Kriminaalasi","en": "Criminal case","ru": "\u0423\u0433\u043e\u043b\u043e\u0432\u043d\u043e\u0435 \u0434\u0435\u043b\u043e"},"type_of_proceeding": {"type": "COURT_CASE","code": "CC4","et": "Kohtu I astme menetlus","en": "Proceeding of court of first instance","ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u043f\u0440\u043e\u0438\u0437\u0432\u043e\u0434\u0441\u0442\u0432\u043e I \u0441\u0442\u0435\u043f\u0435\u043d\u0438 "},"type_of_resolution": {"type": "COURT_CASE","code": "CC14","et": "Kohtuotsus","en": "Court decision","ru": "\u0421\u0443\u0434\u0435\u0431\u043d\u043e\u0435 \u0440\u0435\u0448\u0435\u043d\u0438\u0435"}}]},"immovables": [{"immovable_no": "1111","type": {"type": "IMMOVABLES","code": "ABCDE02","et": "Korteriomand","en": "Apartment ownership","ru": "\u041a\u0432\u0430\u0440\u0442\u0438\u0440\u043d\u0430\u044f \u0441\u043e\u0431\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0441\u0442\u044c"},"cadastral_code": "11111:111:0101","address": "Pinna tn 31 , Tallinna linnaosa, Tallinn, Harju maakond","area": "700 m2","apt_no": "1","registry_code_of_apartment_association": "11111111","purpose": {"type": "IMMOVABLES","code": "ABCD01","et": "Elamumaa 100%","en": "Residental land 100%","ru": "\u0417\u0435\u043c\u043b\u044f \u0434\u043b\u044f \u0436\u0438\u043b\u0438\u0449\u043d\u043e\u0433\u043e \u0441\u0442\u0440\u043e\u0438\u0442\u0435\u043b\u044c\u0441\u0442\u0432\u0430 100%"}}],"bankruptcy_process_notices": [{"code": "11111111111","created_at": "2015-11-08","message_type": {"type": "BANKRUPTCY","code": "BA197","et": "V\u00f5lausaldajate \u00fcldkoosoleku teade","en": "Notice of the time, place and agenda of a general meeting of creditors","ru": "\u0423\u0432\u0435\u0434\u043e\u043c\u043b\u0435\u043d\u0438\u0435 \u043e\u0431 \u043e\u0431\u0449\u0435\u043c \u0441\u043e\u0431\u0440\u0430\u043d\u0438\u0438 \u043a\u0440\u0435\u0434\u0438\u0442\u043e\u0440\u043e\u0432"}}]}
400: Bad Request
Invalid country code
{"error": "error","code": 400,"message": "This report type is not supported"}
401: Unauthorized
Invalid token
{"error": "error","code": 401,"message": "Token is wrong"}
402: Payment Required
Not enough credit
{"error": "error","code": 402,"message": "Monthly requests limit exceeded"}
403: Forbidden
{"error": "error","code": 403,"message": "This request is not allowed for you"}
404: Not Found
Could not find a person matching this query
{"error": "error","code": 404,"message": "No such person"}
409: Conflict
{"error": "error","code": 409,"message": "Something went wrong"}
422: Unprocessable Entity
Validation failed
{"error": "error","code": 422,"message": "Schema validation error"}
423: Locked
{"error": "error","code": 423,"message": "Locked. Wait for previous request to complete"}
500: Internal Server Error
{"error": "error","code": 500,"message": "Internal server error"}