Authentication

Obtaining Your API Key

To access the API, you need an API key. Please contact our sales team to obtain your key.

API Key Rotation

On request, API keys will be rotated on a six-month cycle to ensure ongoing security. When a rotation is due, our team will issue a new API key and notify you via email. Please update your integrations promptly upon receiving your new key.

API Key IP Validation

As an additional layer of security, IP validation can be enabled for your API key. When active, API requests are restricted to a pre-approved list of IP addresses tied to your key's domain, ensuring that only traffic from trusted sources is accepted.

Enabling IP Validation

IP validation is available on request. To enable it, contact our support team with the IP addresses or ranges you wish to allowlist. Our team will configure the restriction and confirm once it is active.

Managing Your Allowlist

If your infrastructure changes and you need to update your approved IP addresses, reach out to our team and we will apply the changes. We recommend reviewing your allowlist periodically to remove any IPs that are no longer in use.

Authentication Type

The API uses Basic Authentication for secure access.

Authentication Format

To authenticate, include the Authorization header in every API request. The header should contain a Base64-encoded string of your email address and API key.

Format:

Authorization: Basic BASE64_ENCODED_CREDENTIALS

Where BASE64_ENCODED_CREDENTIALS is the Base64 encoding of:

YOUR_EMAIL:YOUR_API_KEY

How to Generate Your Credentials

1. Combine your email and API key with a colon separator: YOUR_EMAIL:YOUR_API_KEY
2. Encode the combined string using Base64

Example

If your email is [email protected] and your API key is abc123:

1. Combine them: [email protected]:abc123
2. Base64 encode: dXNlckBleGFtcGxlLmNvbTphYmMxMjM=
3. Add the header:

   Authorization: Basic dXNlckBleGFtcGxlLmNvbTphYmMxMjM=

Code Examples

cURL

curl -X GET "https://app.daloopa.com/api/v2/companies" \
  -H "Authorization: Basic $(echo -n '[email protected]:abc123' | base64)"

Python

import base64
import requests

email = "[email protected]"
api_key = "abc123"

credentials = base64.b64encode(f"{email}:{api_key}".encode()).decode()

headers = {
    "Authorization": f"Basic {credentials}"
}

response = requests.get("https://app.daloopa.com/api/v2/companies", headers=headers)

JavaScript (Node.js)

const email = "[email protected]";
const apiKey = "abc123";

const credentials = Buffer.from(`${email}:${apiKey}`).toString("base64");

const response = await fetch("https://app.daloopa.com/api/v2/companies", {
  headers: {
    "Authorization": `Basic ${credentials}`
  }
});