Error Codes

If there is something wrong, an error will be returned. Depending on the language parameter provided in the request, the error will be delivered in English or Swedish language.

Language-Specific Errors

In this documentation we have decided to describe the Swedish texts as most of our customers would request reports in Swedish language.

Error Response Format

All error responses include metaData and error only. Null fields are omitted from the JSON response. The detail field within error is optional and may be omitted when no additional context is available.

Example response: 400 Bad Request

{
  "metaData": {
    "apiLogId": 547637,
    "timeStamp": "2026-07-21T09:14:33",
    "resource": "DateCheck Company (1219)",
    "method": "GET",
    "requestUrl": "https://se-webservice.apps.creditsafe.com/datecheck/company?language=en&referencedate=2021-01-01&searchnumber=5565144408"
  },
  "error": {
    "code": "23",
    "text": "Reference date too old",
    "detail": "Reference date may not be older than 2021-07-21"
  }
}

HTTP 400 - Bad Request

Code	Text	Detail
R1	The language must be either en (default) or sv (swedish)
21	Referensdatum saknas
22	Fel format på referensdatum	Referensdatumformatet ska vara yyMMdd, yyyyMMdd or yyyy-mm-dd
23	Referensdatum för gammalt	Referensdatum får inte vara äldre än yyyy-mm-dd

Reference Date Format

Ensure your reference date follows one of the accepted formats:

YYMMDD (6 digits)
YYYYMMDD (8 digits)
YYYY-MM-DD (ISO format with hyphens)

HTTP 403 - Forbidden

Authentication and authorization errors:

Code	Text	Detail
R2	Token får inte saknas eller vara tom
R3	Sluttiden för token är ogiltig
R4	Token har gått ut
R5	Token är ogiltig
R6	Ogiltig token-utgivare

Token Issues

For token-related errors (R2-R6), refer to the Authenticate API documentation for guidance on obtaining and refreshing tokens.

Access Denial Errors

Code	Text	Detail
7	Ej tillgång till tjänsten	Ditt kundkonto har inte tjänsten DateCheck Company (1219)
7	Ej tillgång till tjänsten	Ditt kundkonto har inte tjänsten DateCheck Consumer (1220)
7	Ej tillgång till tjänsten	Användaren har inte tjänsten DateCheck Company (1219)
7	Ej tillgång till tjänsten	Användaren har inte tjänsten DateCheck Consumer (1220)
7	Ej tillgång till tjänsten	Ingen åtkomst för kontot eller användaren till tjänsten DateCheck Company (1219)
7	Ej tillgång till tjänsten	Ingen åtkomst för kontot eller användaren till tjänsten DateCheck Consumer (1220)

Access Issues

If you receive error code 7, contact your Creditsafe account manager or the integration team at integration@creditsafe.se to verify your account has the necessary service access configured.

Quota Exhaustion Errors

Code	Text	Detail
8	Rapporter/poäng slut	Inga kvarvarande rapporter för kontot eller användaren till tjänsten DateCheck Company (1219)
8	Rapporter/poäng slut	Inga kvarvarande rapporter för kontot eller användaren till tjänsten DateCheck Consumer (1220)

Report Quota

Error code 8 indicates that your account has exhausted its report quota. Contact your Creditsafe account manager to purchase additional reports or review your usage.

Company Type Access Errors

Code	Text	Detail
17	Ej tillgång till denna företagstyp	Ej tillgång till denna företagstyp – AB
17	Ej tillgång till denna företagstyp	Ej tillgång till denna företagstyp – HB/KB
17	Ej tillgång till denna företagstyp	Ej tillgång till denna företagstyp – EF
17	Ej tillgång till denna företagstyp	Ej tillgång till denna företagstyp – Others

Company Type Abbreviations:

AB = Aktiebolag (Limited company)
HB/KB = Handelsbolag/Kommanditbolag (Trading company/Partnership)
EF = Enskild firma (Sole trader)
Others = Other company types

Company Type Access

Your account may be restricted to specific company types. Error code 17 indicates the company you're searching for is of a type not included in your service agreement. Contact your Creditsafe account manager to adjust your access permissions.

HTTP 404 - Not Found

Code	Text	Detail
15	Ingen träff
15	Ingen träff	Söknumret får inte saknas eller vara tomt

No Match Found

Error code 15 indicates that:

The search number (person number or organization number) was not found in the database, or
The search number parameter was missing or empty

Verify that the searchnumber parameter is correctly formatted and contains only digits.

Common Error Resolution Steps

Authentication Errors (R2-R6)
- Verify your token is valid and not expired
- Obtain a new token from the Authenticate API
- Ensure the token is included in the Authorization header
Access Errors (Code 7)
- Confirm your account has DateCheck service access
- Check that the specific service type (Company/Consumer) is enabled
- Contact integration@creditsafe.se for access issues
Format Errors
- Verify searchnumber contains only digits (10-12 for companies, 12 for consumers)
- Check referencedate follows accepted format (YYMMDD, YYYYMMDD, or YYYY-MM-DD)
- Ensure referencedate is not older than allowed limits (36/60 months)
Not Found Errors (Code 15)
- Verify the search number is correct
- Check that the number exists in the Swedish business register or population register
- Ensure you're using the correct endpoint (company vs consumer)

HTTP 504 - Gateway Timeout

If a report request takes more than 30 seconds, a 504 Gateway Timeout response will be returned.

Server Timeout

A 504 Gateway Timeout is most likely a server environment issue at Creditsafe. Please report this kind of issue to Creditsafe support at integration@creditsafe.se including details on the request that timed out (search criteria, timestamp, and any transaction IDs).