# Person credit report ## getPersonReportTranslated `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`\ `* 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"`\ `}'` #### Query Parameters | Name | Type | Description | | ------------ | ------ | -------------------------------------------------------------------------- | | type | string | Type of report. Must be "private" or "noimmovables". Default is "private". | | language | string | 2-letter language code.Must be "en", "et" or "ru". Default is "en". | | token | string | Your 'access token' (API key). | | code | string | Personal code. | | code\_origin | string | 3-letter country code. | {% tabs %} {% tab title="200 " %} ```javascript { "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" } } ], "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" } } ] } ``` {% endtab %} {% tab title="400 Invalid country code" %} ```javascript { "error": "error", "code": 400, "message": "This report type is not supported" } ``` {% endtab %} {% tab title="401 Invalid token" %} ```javascript { "error": "error", "code": 401, "message": "Token is wrong" } ``` {% endtab %} {% tab title="402 Not enough credit" %} ```javascript { "error": "error", "code": 402, "message": "Monthly requests limit exceeded" } ``` {% endtab %} {% tab title="403 " %} ```javascript { "error": "error", "code": 403, "message": "This request is not allowed for you" } ``` {% endtab %} {% tab title="404 Could not find a person matching this query" %} ```javascript { "error": "error", "code": 404, "message": "No such person" } ``` {% endtab %} {% tab title="409 " %} ```javascript { "error": "error", "code": 409, "message": "Something went wrong" } ``` {% endtab %} {% tab title="422 Validation failed" %} ```javascript { "error": "error", "code": 422, "message": "Schema validation error" } ``` {% endtab %} {% tab title="423 " %} ```javascript { "error": "error", "code": 423, "message": "Locked. Wait for previous request to complete" } ``` {% endtab %} {% tab title="500 " %} ```javascript { "error": "error", "code": 500, "message": "Internal server error" } ``` {% endtab %} {% endtabs %}