Environments
Sandbox and production base URLs, and what differs between them.
Cerrtify exposes two environments. Use the switcher in the top-right to flip every snippet on the docs site.
| Sandbox | Production | |
|---|---|---|
| Base URL | https://sandbox-api.cerrtify.com | https://api.cerrtify.com |
| BankID upstream | BankID test backend (appapi2.test.bankid.com) with Cerrtify's test certificate — added when you click Aktivera BankID i sandbox in the dashboard | BankID production |
| SPAR upstream | Skatteverket's SPAR test environment with Cerrtify's test certificate — added when you click Aktivera SPAR i sandbox in the dashboard | SPAR production with your organisation's own SPAR agreement (setup) |
| Company upstream | Built-in test companies | Bolagsverket (live lookup) and the synced company register (search) |
| Test persons | Yes — BankID test users and SPAR's test persons | No — real persons only |
| Rate limits | Generous, for development | Per-key, configurable |
| Billing | Free — no credit gate | Billed against your credit balance |
| API key | cert_* issued from the sandbox tab | Issued separately from the production tab |
Sandbox and production are isolated — a sandbox key returns 401 against production and vice versa.
Testing BankID in sandbox
To use BankID in sandbox, click Aktivera BankID i sandbox in the dashboard (Tjänster → BankID). That adds Cerrtify's test certificate to your organisation — no certificate of your own is needed. Requests go to BankID's test environment, so you sign in with a test BankID: install the BankID app configured for test and create a test user as described in BankID's test instructions. A real BankID does not work in sandbox.
Testing person data (SPAR) in sandbox
Click Aktivera SPAR i sandbox in the dashboard (Tjänster → Personadress). That adds Skatteverket's test certificate to your organisation, and sandbox lookups then go to Skatteverket's SPAR test environment, where you can look up SPAR's test persons. In production you use your own SPAR agreement with Skatteverket: upload the certificate together with Skatteverket's three numbers (kundnummer leveransmottagare, kundnummer slutkund and uppdragsnummer) in the Cerrtify dashboard. If you don't have an agreement yet, you can buy Cerrtify's help applying for one when you choose your plan. See Persondata.
Sandbox test companies
In sandbox, company lookup and search never reach Bolagsverket. They serve these fictional companies instead:
| Org.nr | Name | Legal form | City | Status |
|---|---|---|---|---|
5599000105 | Testbolaget Nordic AB | Aktiebolag | Stockholm | Active |
5599000196 | Sandbox Software Sverige AB | Aktiebolag | Göteborg | Active |
5599000287 | Nordkvist & Partner Handelsbolag | Handelsbolag | Malmö | Active |
5599000378 | Öresund Test Ekonomisk Förening | Ekonomisk förening | Lund | Active |
5599000469 | Fjäll & Vind Energi AB | Aktiebolag | Umeå | Active |
5599000550 | Avregistrerad Testbolag AB | Aktiebolag | Stockholm | Deregistered 2023-11-01 ("Konkurs avslutad") |
5599000642 | Baltic Trade & Logistics AB | Aktiebolag | Helsingborg | Active |
5599000733 | Testterrass Bostadsrättsförening | Bostadsrättsförening | Uppsala | Active |
5599000824 | Gröna Norr Stiftelse | Stiftelse | Luleå | Active |
5599000915 | Västkust Kommanditbolag | Kommanditbolag | Varberg | Active |
- Lookup (
/service/company/lookup) returns the company in Bolagsverket's response format. Any other org.nr — including real companies — returns404 company_not_foundin sandbox. Real companies only work in production. - Search (
/service/company/search) matches an exact org.nr (10 or 12 digits, hyphen allowed) or any part of the name, case-insensitive — for exampletestbolagetorenergi. Hits carry the org.nr in 12-digit form (165599000105). - Testing an inactive company: use
5599000550. Lookup returns it with"avregistrerad": true,avregistreringsdatumandavregistreringsorsak. Search hides it by default — send"active_only": falseto include it.
See Company — Lookup and search for full request examples.