GET
/
datasets
/
companies
/
{companyId}
/
se
/
debtor-summary
curl --request GET \
  --url https://api.tic.io/datasets/companies/{companyId}/se/debtor-summary \
  --header 'x-api-key: <api-key>'
{
  "foreclosure": true,
  "debtRestructuring": true,
  "recordOfPaymentApplications": {
    "numberOfCases": 123,
    "totalAmountInSEK": 123,
    "lastCaseDate": 123
  },
  "recordOfNonPayment": {
    "numberOfCases": 123,
    "totalAmountInSEK": 123,
    "lastCaseDate": 123
  },
  "debtBalance": {
    "lastUpdated": 123,
    "totalAmountInSEK": 123,
    "public": [
      {
        "description": "<string>",
        "totalAmountInSEK": 123,
        "numberOfCases": 123
      }
    ],
    "private": {
      "numberOfCases": 123,
      "totalAmountInSEK": 123
    }
  }
}

​
Details

This endpoint will return the most recent debtors summary for companies registered in Sweden. If the response is 404, Not Found, it means there are no debt cases. A successful response code 200 will include a debt balance (debtBalance) which contains the current debts to public vs private entities. A public entity includes debt cases, referred in Sweden as A-mål (A-case), regarding debts to the central government, municipality, regions and various authorities. Example of a public debt are taxes. Private debt cases, referred in Sweden as E-mål (E-case), are debts to individuals and companies.

For public debt cases additional information is included in the description property which holds information about the case type and the creditor. The debt balance is the actual balance on the date and time supplied in the property lastUpdated (Unix epoch). The update frequency is described in the table below.

PropertyContains
debtBalanceWeekly updated debt balance for public vs. private debt cases
recordOfPaymentApplicationsDaily updated contains payment applications made by creditors
recordOfNonPaymentDaily updated contains records of non payment ()
foreclosureDaily updated information if there is a current foreclousre (Swedish: utmätning)
debtRestructuringDaily updated information if there is a current debt restructuring (Swedish: skuldsanering)

​
Caution !

The four properties recordOfPaymentApplications, recordOfNonPayment, foreclosure, debtRestructuring may not be identical between credit reference agencies until second quarter of 2025. The reason is that the central authority, Kronofogdemyndigheten, which are the source of this information closed down their so called initial data loading for new actors until second quarter 2025. To solve that problem we had to acquired the current state of record of payment applications and record of non payment from another source and use the daily partial updates from Kronofogdemyndigheten from 2024-12-11 and onwards.

This could technically cause a slight deviation in registration entries. To cirumvent that issue we have decided to keep a more relaxed approch in credit scoring of such records until second quarter of 2025.

Meanwhile this does not affect debtBalance since that data is delivered weekly to all credit reference agencies.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
companyId
integer
required

The id of the company

Response

200 - application/json

The search response

The response is of type object.