Public developer API
GET /v1/ping
Proves that your live key, project and network are accepted. Needs no scope and moves no money. Answers for draft and paused projects too.
Access
A project-specific API key (Authorization: Bearer dapi_live_...) and its Business ID (X-Business-Id). Rate limited per business (120 calls a minute by default).
Call it first after issuing a key or activating a project. A refusal names exactly what to fix: project_not_active, project_not_found, ip_not_allowed, business_on_hold or invalid_live_api_key.
Example request
curl --request GET \
--url 'https://production.dutchapi.co/v1/ping' \
--header 'X-Business-Id: YOUR_BUSINESS_ID' \
--header 'Authorization: Bearer bsk_live_YOUR_BUSINESS_SECRET'
Response 200
{
"ok": true,
"organization": {
"id": "3f1c2a9e-5b7d-4c21-9a0e-6d2b8c1f4e70",
"name": "Acme Payments Ltd"
},
"project": {
"id": "8b2e4c6a-1d3f-4a5b-9c7d-0e1f2a3b4c5d",
"product": "payments",
"status": "active"
},
"key": {
"scopes": [
"accounts:read",
"transactions:read",
"payouts:create"
]
},
"request_id": "req_4f9a1c2b3d4e5f60",
"ip": "203.0.113.7"
}
Errors
| Status | error | Meaning |
|---|---|---|
| 400 | business_id_required | Send X-Business-Id with your public Business ID. |
| 403 | business_id_mismatch | This Business ID does not belong to the project key. |
| 401 | invalid_live_api_key | The key is wrong or was revoked. |
| 401 | project_key_required | Use a project-specific API key. |
| 404 | project_not_found | No project with that id uses this key. |
| 403 | project_not_active | Take the project live in the dashboard first (Projects, Go live). |
| 403 | business_on_hold | The Dutch API team placed the business on hold. |