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

StatuserrorMeaning
400business_id_requiredSend X-Business-Id with your public Business ID.
403business_id_mismatchThis Business ID does not belong to the project key.
401invalid_live_api_keyThe key is wrong or was revoked.
401project_key_requiredUse a project-specific API key.
404project_not_foundNo project with that id uses this key.
403project_not_activeTake the project live in the dashboard first (Projects, Go live).
403business_on_holdThe Dutch API team placed the business on hold.

Related references

Browse the complete endpoint directory, the developer portal and the security and controls guide.