Basel CA API Documentation

FREE ACCESS - Registration Required

Quick Start

1

Get Your Free API Key

Registration takes 30 seconds. No credit card required.

Get Free API Key →
2

Make Your First API Call

Include your API key in the X-API-Key header:

Get Specific Country (Trinidad & Tobago)

curl -H "X-API-Key: YOUR_API_KEY_HERE" \
  https://basel-api-free-production.up.railway.app/api/v1/ca/TT

Get All 41 Countries

curl -H "X-API-Key: YOUR_API_KEY_HERE" \
  https://basel-api-free-production.up.railway.app/api/v1/ca
3

Integrate Into Your Application

Code examples in popular languages:

JavaScript/Node.js

const response = await fetch(
  'https://basel-api-free-production.up.railway.app/api/v1/ca/BR',
  {
    headers: {
      'X-API-Key': 'YOUR_API_KEY_HERE'
    }
  }
)
const data = await response.json()
console.log(data)

Python

import requests

headers = {'X-API-Key': 'YOUR_API_KEY_HERE'}
response = requests.get(
    'https://basel-api-free-production.up.railway.app/api/v1/ca/BR',
    headers=headers
)
data = response.json()
print(data)

PHP

$ch = curl_init('https://basel-api-free-production.up.railway.app/api/v1/ca/BR');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_API_KEY_HERE']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($data);

Authentication

🔑FREE ACCESS with Registration

All API requests require a free API key. Get yours instantly at /register (no credit card required).

How to Authenticate

Include your API key in the X-API-Key header with every request:

X-API-Key: bca_1234567890abcdef...

What You Get (100% Free)

  • ✅ Unlimited API requests
  • ✅ Access to all 41 countries
  • ✅ Real-time verified data
  • ✅ No expiration date
  • ✅ Email support

Error Responses

If your API key is missing or invalid, you'll receive a 401 error:

{
  "error": "API key required",
  "message": "Include your API key in the X-API-Key header",
  "help": "Get your free key at /register"
}
Lost your API key? Register again with the same email to retrieve your existing key.

API Endpoints

GET/api/v1/ca

List all competent authorities (41 countries)

Example Request

curl -H "X-API-Key: YOUR_KEY" \
  https://basel-api-free-production.up.railway.app/api/v1/ca

Response

{
  "page": 1,
  "perPage": 50,
  "totalItems": 41,
  "totalPages": 1,
  "items": [
    {
      "country_code": "TT",
      "country_name": "Trinidad and Tobago",
      "ca_name": "Environmental Management Authority"
    }
  ]
}
GET/api/v1/ca/{country_code}

Get specific country by ISO 3166-1 alpha-2 code

Example Request

curl -H "X-API-Key: YOUR_KEY" \
  https://basel-api-free-production.up.railway.app/api/v1/ca/BR

Response

{
  "country_code": "BR",
  "country_name": "Brazil",
  "ca_name": "Ministério do Meio Ambiente",
  "email": "qualidade.ambiental@mma.gov.br",
  "phone": "+55-61-2028-1057",
  "address": "Esplanada dos Ministérios, Bloco B, 5º andar",
  "verified": true,
  "last_checked": "2026-01-17"
}

Response Format

All responses are JSON with these fields:

  • country_code: ISO 3166-1 alpha-2 code
  • country_name: Official country name
  • ca_name: Competent authority name
  • email_primary: Contact email
  • phone: Contact phone
  • address: Physical address
  • notes: Verification notes
  • last_verified_date: Last verification date

Usage Limits

Unlimited requests - Use responsibly for legitimate Basel Convention compliance purposes.

Supported Countries (41)

Currently supporting 41 countries with verified Competent Authority data:

US, CA, MX, BR, AR, CL, EC, VE, GB, FR, DE, IT, ES, SE, NO, DK, FI, BE, CH, CN, JP, KR, IN, SG, MY, TH, ID, AU, NZ, ZA, PH, VN, AT, IE, PT, GR, CZ, PL, and more...

Frequently Asked Questions

Is it really free?

Yes! 100% free with unlimited requests. No credit card, no trial period, no hidden fees. We only ask for your email for API key delivery.

Why do you need my email?

We use email to deliver your API key and occasionally send important updates about the service (new countries added, API changes, etc.). We never spam or share your email.

Are there rate limits?

No rate limits! Use the API as much as you need for legitimate Basel Convention compliance purposes. All keys have unlimited access.

How current is the data?

We verify all competent authority contact information regularly. Currently supporting 41 countries with verified data. New countries are added weekly.

Can I use this commercially?

Yes! The API is free for both personal and commercial use. Integrate it into your logistics software, compliance tools, or internal systems.

What if I lose my API key?

Just register again with the same email - we'll return your existing key immediately.

Need Help?

Contact our support team: support@dexmetal.com

Back to DexMetal.com