Checkbase User Guide

Welcome to Checkbase

Run credibility checks, set up continuous monitoring, and integrate with the API.

Getting Access

1. Request a demo: Click the Request a Demo button (top right) to open the popup.
2. Account creation: We create your business account and email the invite.
3. Activate: Open the invite, set password, and log in.
4. Start: Scanning and Monitoring are enabled immediately.
API key: X-API-Key is issued when your workspace is live.

Run a Risk Check Scan

Log in to your Checkbase account.
Go to /business.
Enter the company name you want to verify.
Select the correct company and confirm its NZBN.
Click Run a Scan to start background checks.
Review the results or/and download the report to make an informed decision.
View your recent activity — the dashboard shows your last five scans and the total number of scans performed this month.

Continuous Monitoring

Open /monitoring.
Add a single company or upload a CSV.
When uploading CSV, ensure each row has the correct Company Name and NZBN. For single company entries, select the correct one from the dropdown.
Once added, Checkbase periodically monitors for director or shareholder changes, insolvency or liquidation events, deregistration notices, Gazette and media mentions, and more.
You will receive email alerts and dashboard notifications (coming soon) whenever changes are detected.
You can delete individual companies or perform bulk deletions anytime to manage your monitoring list.

Tip: Always double-check company name and NZBN accuracy to ensure correct tracking.

Bulk Upload (CSV) - Continuous monitoring

Use this format:

company_name,nzbn, notes
CHECKBASE LIMITED, 99000000000001, Anything you want to keep noted

Upload the file in /monitoring. All rows queue automatically.

Developer Integration (API)

Add this header to all requests:

X-API-Key: YOUR_API_KEY

Submit a Scan

curl -X POST https://api.checkbase.co.nz/api/v1/check  -H "Content-Type: application/json"  -H "X-API-Key: YOUR_API_KEY"  -d '{"entity_name":"ACME CONSTRUCTION LIMITED","entity_type":"company"}'

Fetch Results

curl https://api.checkbase.co.nz/api/v1/jobs/cb_20251027_001  -H "X-API-Key: YOUR_API_KEY"

Monitoring API

Method	Endpoint	Description
POST	`/api/v1/monitor`	Register entity for alerts
GET	`/api/v1/alerts`	Retrieve triggered alerts
DELETE	`/api/v1/monitor/{entity_id}`	Stop monitoring

Error Codes

Code	Meaning	Action
400	Invalid request	Check body
401	Missing/invalid key	Verify X-API-Key
404	Job not found	Check job_id
429	Rate limit	Retry later
500	Server error	Retry or contact support

Support

Email: support@checkbase.co.nz

Site: checkbase.co.nz