Quickstart

Get a sandbox key and make your first authenticated call.

What you can do today

Key issuance and authentication are live. The plan endpoints are still being built — this guide covers getting authenticated, which is the prerequisite for everything else.

1. Create an organization

Sign up for the dashboard and create your organization. It starts in Pending while we review it — you can create sandbox keys and build against them straight away.

2. Create a sandbox key

In the dashboard, go to API keys and create a key in Test mode. It looks like sk_test_….

You'll see the secret exactly once

We store only a hash, so we genuinely cannot show it to you again or recover it if you lose it. Put it in your secret manager before closing the dialog. If you do lose it, rotate the key — rotation issues a replacement and revokes the old one immediately.

3. Make your first call

List your customers. It's read-only and moves no money, so it's the safe first call — an empty list confirms your key works. The API is Cybrid-compatible, on https://bank.dattaremit.com.

curl https://api.dattaremit.com/api/customers \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "total": 0,
  "page": 0,
  "per_page": 10,
  "objects": []
}

A { total, page, per_page, objects } page, exactly as Cybrid returns it. Create a customer next — see the Create Customer reference.

4. Handle errors

Errors match Cybrid exactly. Branch on message_code — it's the stable contract. error_message is for humans and may be reworded.

{
  "status": 401,
  "error_message": "Signature verification raised",
  "message_code": "authentication_failed"
}
unauthorized401Missing, malformed, revoked or unknown key.
organization_inactive403Your organization is pending review or suspended.
ip_allowlist_required403A live key was used while your allowlist is empty.
ip_not_allowed403The calling address isn't on your allowlist.
unknown_endpoint404No such endpoint.