Skip to content

Sandbox Environment

The GetSignatory sandbox environment is available for testing during development. The sandbox feature allows you to build integrations without fetching live data and incurring charges for reports.


Sandbox Configuration

To use the sandbox environment, a dedicated Sandbox API service must be configured in Creditsafe's backend. All parameters and responses in the sandbox version of GetSignatory mirror those of the live service.

Authorization works exactly the same as in the live environment using CONNECT Authenticate. Any charges incurred in the sandbox are applied to the Sandbox API service alone, with no charges made to the GetSignatory service.


Sandbox URLs

GetSignatory Endpoint:

https://se-webservice-sandbox.apps.creditsafe.com/getsignatory

Health Check:

https://se-webservice-sandbox.apps.creditsafe.com/getsignatory/health

Sandbox Parameter Behavior

In the sandbox version of this API, only the following parameters are actively supported:

  • searchnumber
  • transactionid

All other parameters included in the request may be ignored without error or warning.

Best Practice

Developers are encouraged to structure their requests as they would in a production environment, including all expected parameters. This ensures consistency and simplifies the transition to production usage.


Setting Up Sandbox Access

To access the sandbox environment:

  1. You will need a signed agreement with Creditsafe
  2. Our sales team will facilitate this agreement
  3. The integration team will provide the necessary credentials to get started

The Creditsafe integration team (integration@creditsafe.se) is available to assist you during the development phase with the sandbox API. They can provide:

  • Information on which search numbers to use
  • Additional test data if needed
  • Guidance on sandbox implementation
  • Support for troubleshooting issues

Transitioning to Production

At some point, you will need to transition the development environment to use the live services and verify that everything works as expected.

Caution: Letters of Disclosure

When making this switch, be cautious to avoid unintentionally generating credit reports through services like GetData or CAS, as this could trigger the sending of letters of disclosure.

Important: Using the GetSignatory API itself never results in letters of disclosure being sent.

When transitioning to production:

  1. Update your base URL from sandbox to production endpoints
  2. Use your production credentials (obtained from CONNECT Authenticate)
  3. Update any hardcoded sandbox URLs in your codebase
  4. Test the authentication flow with production credentials in a controlled manner

Disclaimer - Sandbox Data Validity

While the sandbox environment mirrors the structure and format of responses from the live API, the data itself is synthetic and may not be logically consistent or realistic. This environment is intended solely for integration testing and development purposes.