Testing integrations for free with our new developer sandbox

Testing API integrations gets expensive quickly when you are experimenting with data schemas, debugging JSON parsers, or setting up test suites.

To help you build and test risk free, we launched a simulated search endpoint at /api/sandbox/search.

How the sandbox works

The sandbox acts like our production company search, returning the same JSON structure. To prevent developers from using it as a free database in production, it has two constraints:

• Fictional data: Regardless of your search parameters, the sandbox returns the same three fictional Austrian mock companies.
• Added latency: Every request has a delay of 2.5 seconds.

Sandbox features

• No credit cost: Calling the sandbox is free and does not use any trial or subscription credits.
• Matching schemas: The mock payload matches the production search fields exactly, including keys like fnr, name, sitz, and rechtsform. You can build your app against the sandbox and swap the base URL to production when you are ready.
• Rate limits: The endpoint allows five requests per minute per account, returning a 429 error if you exceed this limit.

How to query the sandbox

First, register for a free account at firmafind.at/sign-up to get an API key.

Then, add the key to the x-api-key header and query the endpoint:

curl -X GET "https://firmafind.at/api/sandbox/search?q=test" \
 -H "x-api-key: YOUR_API_KEY"

Mock response format

The sandbox returns the same payload structure as the live /api/companies search, with a _meta field explaining that the data is mock data:

{
	"data": [
		{
			"fnr": "123456a",
			"name": "AlpenQuelle Getränke GmbH",
			"sitz": "Salzburg",
			"rechtsform": "Gesellschaft mit beschränkter Haftung (GmbH)",
			"status": "aktiv",
			"gericht": "Landesgericht Salzburg",
			"country": "AT",
			"_meta": {
				"message": "This is a static sandbox response. Upgrade to production for live data.",
				"hint": "Real API endpoints provide live queries across registered Austrian companies."
			}
		},
		{
			"fnr": "789012b",
			"name": "GipfelMarkt Supermärkte AG",
			"sitz": "Innsbruck",
			"rechtsform": "Aktiengesellschaft (AG)",
			"status": "aktiv",
			"gericht": "Landesgericht Innsbruck",
			"country": "AT",
			"_meta": {
				"message": "This is a static sandbox response. Upgrade to production for live data.",
				"hint": "Production API returns historical balance sheets, managers, shareholder details, and annual reports."
			}
		},
		{
			"fnr": "345678c",
			"name": "NovaTech Software Entwicklung GmbH",
			"sitz": "Wien",
			"rechtsform": "Gesellschaft mit beschränkter Haftung (GmbH)",
			"status": "aktiv",
			"gericht": "Handelsgericht Wien",
			"country": "AT",
			"_meta": {
				"message": "This is a static sandbox response. Upgrade to production for live data.",
				"hint": "Test integrations easily; the schema structure is identical to our live production JSON payload."
			}
		}
	],
	"meta": {
		"count": 3,
		"is_sandbox": true,
		"simulated_latency_ms": 2500
	}
}

You can read the full specifications in the API documentation.

If you run into issues while setting this up, send us a message at [email protected].