Authentication

Atlas authenticates your requests using API keys. To get your API keys, you need to create an account for free on the Atlas sign up page. After sign-up, you will be required to submit compliance documents before you can go live.

Getting your API keys

1. Log in to the Atlas Dashboard.
2. Open Settings → Developer.
3. Copy your API keys.

Authenticating requests to the API

The Atlas API follows the Representational State Transfer (REST) standard to organize its API. It accepts and returns JSON-encoded data and uses standard HTTP response codes, authentication, and verbs.

The keys shown in your dashboard depend on your account mode. If your account is in test mode, you will see test keys; if it’s in live mode, you will see live keys. Test mode requests don’t affect your live data or interact with the banking networks.

Base URL

The base URL for Atlas is the same for all environments. There is no separate test or production URL, the API key you use determines whether your request runs in test mode or live mode.

The Base URL for all requests is:

https://atlas.tryduplo.com/api/v1

The requests are authenticated using the Bearer Token authentication scheme. For every request you send, you need to include an Authorization header with the value Bearer <YOUR_API_KEY>.

For example:

curl https://atlas.tryduplo.com/api/v1 \
  -H "Authorization: Bearer pk_test_123" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

Related guides

• Compliance and Verification
• Configure and Verify Webhooks
• Encrypting Atlas Payloads
• Go-Live Checklist