Welcome to BaaS! 🎉

Let's set up your first organization and project.

CURRENT PLAN

Loading... -

Requests This Month

Requests Today

Errors This Month

Avg Response

Active Projects

API Keys

Success Rate

Plan Limit

📈 Requests

Select Project

🔑 API Keys

Name	Key Prefix	Status	Requests	Last Used	Actions
Select a project

🛡️ IP Whitelist

Restrict API access to specific IPs. Empty = all IPs allowed.

IP Address	Description	Added	Actions
Select a project

🔑 Your API Key

Enter your API key to test endpoints directly

API Overview

Base URL

https://baas.dapita.net

Authentication

All API requests require an API key sent in the X-API-Key header.

curl -H "X-API-Key: baas_sk_your_key_here" https://baas.dapita.net/geo/ip/8.8.8.8

Request Headers

Header	Required	Description
`X-API-Key`	Yes	Your API key
`Content-Type`	For POST	application/json

Error Responses

Code	Description
400	Bad Request
401	Unauthorized
403	Forbidden
429	Rate limit exceeded
500	Internal Server Error

Rate Limits

Plan	Requests/Month	Requests/Hour
Free	1,000	5
Pay-as-you-go	5,000	20
Growth	50,000	100
Scale	500,000	700

Special Rate Limits

Endpoint	Limit	Reason
`/vat/validate`	1 req / 10 sec	External VIES API
`/ip/reputation`	1 req / 60 sec	External AbuseIPDB
`/email/validate`	1 req / 5 sec	SMTP verification

GET/compliance/{jurisdiction}

Data-retention & GDPR-style compliance rules for a jurisdiction. Per data category: action (delete / anonymize / restrict / retain), retention period (days), legal reference, source URL and a ready-to-use policy clause. Also returns jurisdiction-level request (days to fulfil a data-subject request + extension) and data_residency (none / local_copy_required / transfer_restricted). Falls back to EU / DEFAULT when a country has no specific rule, so the response is never empty.

Parameters

Name	Type	Required	Description
`jurisdiction`	string	Yes	ISO 3166-1 alpha-2 (ES, DE, US…) or EU / DEFAULT
`category`	string	No	contact, credentials, tokens, audit, financial or consent. Omit to return all categories.

Example Request

curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/compliance/ES?category=financial"

Response

{"jurisdiction":"ES","resolved_from":"ES","version":1,"request":{"max_days_to_fulfill":30,"extension_days":60,"legal_reference":"GDPR Art. 12(3)","resolved_from":"EU","reviewed":false},"data_residency":{"mode":"none","required":false,"resolved_from":"EU","reviewed":false},"categories":{"financial":{"action":"retain","retention_days":2190,"legal_reference":"Código de Comercio art. 30","source_url":"https://www.boe.es/buscar/act.php?id=BOE-A-1885-6627","clause":{"en":"Accounting books and records are retained for 6 years.","es":"..."},"resolved_from":"ES","version":1,"reviewed":false}}}

Field guide

Field	Meaning
`action`	`delete` erase · `anonymize` irreversibly de-identify (row kept) · `restrict` keep but block processing (legal hold) · `retain` keep and use
`retention_days`	`0` delete now · `N` keep N days then delete · `null` keep indefinitely
`request`	Days to fulfil a data-subject request (`max_days_to_fulfill`) plus permitted `extension_days`
`data_residency`	`none` · `local_copy_required` (primary copy stays in-country) · `transfer_restricted` (cross-border needs assessment/approval); `required` is a bool shortcut
`resolved_from`	Which tier supplied the rule: the country, `EU`, or `DEFAULT` (shown per category and on request / data_residency)
`version`	Policy version — store it with any action you take to prove which rule applied; the top-level value is the max, use it for cache invalidation
`reviewed`	`false` until confirmed by legal counsel — treat unreviewed rules as provisional

How to use correctly

Fetch GET /compliance/{jurisdiction} once per user's jurisdiction; cache by version with a short TTL and refetch when it changes.
Per data category, read action + retention_days to decide whether and when to delete, anonymize, restrict or retain.
For data-subject (deletion / access) requests, take the deadline from request.max_days_to_fulfill (plus extension_days).
Choose the storage region according to data_residency before storing personal data.
Generate policy text from clause and keep source_url as proof of the legal basis.
Record the (jurisdiction, category, version) you acted on, so the exact rule can be reproduced later.

Try It

Jurisdiction (ISO alpha-2)

Category (optional)

GET/geo/ip/{ip}

Get geolocation data for an IP address.

Parameters

Name	Type	Required	Description
`ip`	string	Yes	IPv4 or IPv6 address

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/geo/ip/8.8.8.8

Response

{"ip":"8.8.8.8","country_code":"US","country":"United States","city":"","timezone":"America/Chicago","latitude":37.751,"longitude":-97.822}

Try It

IP Address

GET/ip/me

Get geolocation data for your current IP address.

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/ip/me

Response

{"ip":"57.131.32.227","country_code":"FR","country":"France","city":"","timezone":"Europe/Paris","latitude":48.8582,"longitude":2.3387}

Try It

GET/ip/reputation/{ip}

Get IP reputation data including abuse score, reports, and threat indicators. Rate limited: 1 request per 60 seconds.

Parameters

Name	Type	Required	Description
`ip`	string	Yes	IPv4 or IPv6 address

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/ip/reputation/8.8.8.8

Response

{"ip":"8.8.8.8","is_public":true,"abuse_score":0,"country_code":"US","isp":"Google LLC","domain":"google.com","total_reports":140,"last_reported_at":"2025-12-29T02:57:13Z","is_whitelisted":true,"is_tor":false,"source":"abuseipdb"}

Try It

IP Address

GET/country/{code?}

Get country information. Without code returns all countries. With code returns specific country details.

Parameters

Name	Type	Required	Description
`code`	string	No	ISO 2-letter country code. Empty = all countries.
`format`	query	No	Use "compact" for smaller payload (list mode only)

Example Requests

# All countries
curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/country/list

# Compact format
curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/country/list?format=compact"

# Single country
curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/country/ES

Response (single)

{"code":"ES","name":"Spain","native_name":"España","flag":"🇪🇸","dial_code":"+34","currency":"EUR","languages":["es"],"capital":"Madrid","region":"Europe"}

Try It

Country Code (empty = all)

Format

GET/geo/countries

Get countries with detailed geographic data from GeoNames. Supports filtering.

Query Parameters

Name	Type	Required	Description
`iso`	string	No	Filter by ISO 2-letter code
`iso3`	string	No	Filter by ISO 3-letter code
`name`	string	No	Search by name
`lang`	string	No	Language code for localized names
`continent`	string	No	Filter: EU, AS, NA, SA, AF, OC, AN
`currency`	string	No	Filter by currency code
`phone`	string	No	Filter by phone code
`tld`	string	No	Filter by TLD domain

Example Requests

# All countries
curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/geo/countries

# European countries
curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/geo/countries?continent=EU"

# Single country by ISO
curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/geo/countries?iso=ES"

Response

{"count":1,"countries":[{"iso":"ES","iso3":"ESP","iso_numeric":"724","name":"Spain","capital":"Madrid","continent":"EU","continent_name":"Europe","population":46723749,"currency_code":"EUR","currency_name":"Euro","phone":"34","tld":".es"}]}

Try It

ISO Code

Continent

GET/geo/regions

Get regions/states/provinces for a country.

Query Parameters

Name	Type	Required	Description
`country`	string	Yes	ISO 2-letter country code
`code`	string	No	Filter by region code
`name`	string	No	Search by name

Example Request

curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/geo/regions?country=ES"

Response

{"count":19,"regions":[{"name":"Andalusia","asciiname":"Andalusia","country_code":"ES","country_iso3":"ESP","country_name":"Spain","admin1_code":"51","latitude":37.5,"longitude":-4.58333,"population":8631862,"timezone":"Europe/Madrid"},...]}

Try It

Country Code

GET/geo/cities

Get cities for a country with pagination. Includes postal codes.

Query Parameters

Name	Type	Required	Description
`country`	string	Yes	ISO 2-letter country code
`iso3`	string	No	ISO 3-letter country code
`admin1`	string	No	Filter by region code
`name`	string	No	Search by city name
`limit`	int	No	Results per page (default: 100, max: 1000)
`offset`	int	No	Skip N results
`short`	bool	No	Return minimal fields (true/false)

Example Requests

# Basic request with limit
curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/geo/cities?country=ES&limit=10"

# Search by city name
curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/geo/cities?country=ES&name=Madrid"

# Filter by region code
curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/geo/cities?country=ES&admin1=29"

# Short format (minimal fields)
curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/geo/cities?country=ES&short=true&limit=100"

Response

{"count":2,"total":30871,"limit":2,"offset":0,"cities":[{"name":"Madrid","asciiname":"Madrid","admin1_code":"29","admin1_name":"Comunidad de Madrid","latitude":40.4165,"longitude":-3.70256,"population":3255944,"timezone":"Europe/Madrid","continent_name":"Europe","phone_code":"34","currency_code":"EUR","currency_name":"Euro","tld":".es","postal_codes":["28001","28002",...]},...]}

Try It

Country

City Name

Limit

GET/currency/rates/{base?}

Get current exchange rates. Base defaults to EUR.

Parameters

Name	Type	Required	Description
`base`	string	No	Base currency (default: EUR)

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/currency/rates/EUR

Response

{"base":"EUR","date":"2025-12-29","rates":{"USD":1.04,"GBP":0.83,"JPY":164.5,...}}

Try It

Base Currency

GET/currency/convert

Convert amount from one currency to another.

Query Parameters

Name	Type	Required	Description
`from`	string	Yes	Source currency code
`to`	string	Yes	Target currency code
`amount`	number	Yes	Amount to convert

Example Request

curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/currency/convert?from=USD&to=EUR&amount=100"

Response

{"from":"USD","to":"EUR","amount":100,"result":96.15,"rate":0.9615}

Try It

From

Amount

GET/currency/history

Get historical exchange rates for a specific date.

Query Parameters

Name	Type	Required	Description
`base`	string	No	Base currency (default: EUR)
`date`	string	Yes	Date in YYYY-MM-DD format

Example Request

curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/currency/history?base=EUR&date=2025-12-01"

Response

{"base":"EUR","date":"2025-12-01","rates":{"USD":1.05,"GBP":0.84,...}}

Try It

Base Currency

Date

GET/currency/list/{code?}

Get currency info with symbol and flag. Without code returns all currencies.

Parameters

Name	Type	Required	Description
`code`	string	No	Currency code. Empty = all currencies.

Example Requests

# All currencies
curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/currency/list/

# Single currency
curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/currency/list/EUR

Response (single)

{"code":"EUR","name":"Euro","symbol":"€","flag":"🇪🇺"}

Try It

Currency Code (empty = all)

GET/vat/rates/{country}

Get VAT rates for a country including standard, reduced, and super-reduced rates.

Parameters

Name	Type	Required	Description
`country`	string	Yes	ISO 2-letter country code

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/vat/rates/ES

Response

{"country_code":"ES","country_name":"Spain","local_name":"IVA","standard_rate":21,"reduced_rates":[10],"super_reduced_rate":4,"parking_rate":null,"updated_at":"2025-12-03"}

Try It

Country Code

GET/vat/validate/{vat_number}

Validate EU VAT number via VIES service. Rate limited: 1 request per 10 seconds.

Parameters

Name	Type	Required	Description
`vat_number`	string	Yes	VAT number with country prefix (e.g. ESB12345678)

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/vat/validate/ESB12345678

Response

{"valid":true,"country_code":"ES","vat_number":"B12345678","company_name":"Example Company SL","company_address":"Calle Example 123, Madrid"}

Try It

VAT Number

GET/phone/validate/{number}

Validate phone number and get carrier information.

Parameters

Name	Type	Required	Description
`number`	string	Yes	Phone number with country code (e.g. +34612345678)

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/phone/validate/+34612345678

Response

{"valid":true,"number":"+34612345678","country_code":"ES","national_number":"612345678","type":"mobile","carrier":"Syma","formatted":{"international":"+34 612 34 56 78","national":"612 34 56 78","e164":"+34612345678"}}

Try It

Phone Number

GET/phone/format/{number}

Format phone number in various formats (international, national, E.164).

Parameters

Name	Type	Required	Description
`number`	string	Yes	Phone number with country code

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/phone/format/+34612345678

Response

{"number":"+34612345678","formatted":{"international":"+34 612 34 56 78","national":"612 34 56 78","e164":"+34612345678"}}

Try It

Phone Number

GET/phone/mask/{country}

Get phone input mask for a country.

Parameters

Name	Type	Required	Description
`country`	string	Yes	ISO 2-letter country code

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/phone/mask/ES

Response

{"country_code":"ES","country_name":"Spain","dial_code":"+34","mask":"### ## ## ##","example":"+34 810 12 34 56"}

Try It

Country Code

GET/email/validate/{email}

Validate email address with syntax and MX record check. Rate limited: 1 request per 5 seconds.

Parameters

Name	Type	Required	Description
`email`	string	Yes	Email address to validate

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/email/validate/test@gmail.com

Response

{"email":"test@gmail.com","valid":true,"syntax_valid":true,"mx_valid":true,"mx_records":["gmail-smtp-in.l.google.com","alt1.gmail-smtp-in.l.google.com",...],"domain":"gmail.com"}

Try It

GET/timezone/{location}

Get timezone information and current time for a location.

Parameters

Name	Type	Required	Description
`location`	string	Yes	IANA timezone identifier (e.g. Europe/Madrid)

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/timezone/Europe/Madrid

Response

{"timezone":"Europe/Madrid","offset":"+01:00","offset_seconds":3600,"current_time":"2025-12-29T12:53:42+01:00","is_dst":false}

Try It

Timezone

GET/timezones

Get all world timezones with country bindings. Filter by country code.

Parameters

Name	Type	Required	Description
`country`	query	No	ISO 2-letter country code to filter (e.g. ES, RU, US)

Example Request

curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/timezones?country=ES"

Response

{"count":6,"timezones":[{"timezone":"Europe/Madrid","utc_offset":"+01:00","offset_seconds":3600,"countries":[{"code":"ES","name":"Spain"}]},...]}

Try It

Country (optional)

GET/business-day/{country}/{date}

Check if a date is a business day (not weekend or holiday).

Parameters

Name	Type	Required	Description
`country`	string	Yes	ISO 2-letter country code
`date`	string	Yes	Date in YYYY-MM-DD format

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/business-day/ES/2025-12-25

Response

{"date":"2025-12-25","country_code":"ES","is_business_day":false,"is_weekend":false,"is_holiday":true,"holiday_name":"Christmas Day","day_of_week":"Thursday"}

Try It

Country

Date

GET/holiday/{country}/{year}

Get public holidays for a country and year.

Parameters

Name	Type	Required	Description
`country`	string	Yes	ISO 2-letter country code
`year`	int	Yes	Year (e.g. 2025)
`type`	query	No	Filter by holiday type (e.g. Public)

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/holiday/ES/2025

Response

{"country_code":"ES","year":2025,"holidays":[{"date":"2025-01-01","name":"New Year's Day"},{"date":"2025-01-06","name":"Epiphany"},{"date":"2025-12-25","name":"Christmas Day"},...]}

Try It

Country

Year

GET/languages

Get all world languages with country mappings.

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/languages

Response

{"count":279,"languages":[{"code":"aa","name":"Afar","native_name":"Afaraf","family":"Afro-Asiatic","is_regional":false,"countries":[{"country_code":"DJ","is_official":true},...]},...]}

Try It

GET/languages/{code}

Get a single language by ISO 639 code.

Parameters

Name	Type	Required	Description
`code`	string	Yes	ISO 639-1 (2-char) or ISO 639-3 (3-char) language code

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/languages/es

Response

{"code":"es","name":"Spanish","native_name":"Español","family":"Indo-European","is_regional":false,"countries":[{"country_code":"ES","is_official":true},{"country_code":"MX","is_official":true},...]}

Try It

Language Code

GET/languages/search?q={query}

Search languages by name, native name, or code.

Query Parameters

Name	Type	Required	Description
`q`	string	Yes	Search query

Example Request

curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/languages/search?q=catalan"

Response

{"count":1,"languages":[{"code":"ca","name":"Catalan","native_name":"Català","family":"Indo-European","is_regional":true,"countries":[{"country_code":"ES","is_official":false},{"country_code":"AD","is_official":true},...]},...]}

Try It

Search Query

GET/languages/country/{code}

Get all languages spoken in a country, including regional and minority languages.

Parameters

Name	Type	Required	Description
`code`	string	Yes	ISO 3166-1 alpha-2 country code

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/languages/country/ES

Response

{"count":8,"languages":[{"code":"es","name":"Spanish","native_name":"Español","family":"Indo-European","is_regional":false,"countries":[{"country_code":"ES","is_official":true}]},{"code":"ca","name":"Catalan","native_name":"Català",...},...]}

Try It

Country Code

POST/language/detect

Detect the language of a text.

Request Body

Name	Type	Required	Description
`text`	string	Yes	Text to analyze

Example Request

curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"text":"Hola, ¿cómo estás?"}' \
  https://baas.dapita.net/language/detect

Response

{"language":"Spanish","code":"es","confidence":0.66}

Try It

Text

POST/useragent/parse

Parse User-Agent string to get browser, OS, and device information.

Request Body

Name	Type	Required	Description
`user_agent`	string	Yes	User-Agent string to parse

Example Request

curl -X POST -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"}' \
  https://baas.dapita.net/useragent/parse

Response

{"user_agent":"Mozilla/5.0...","browser":"Chrome","browser_version":"120.0","os":"Windows 10/11","os_version":"10.0","device":"PC","is_mobile":false,"is_tablet":false,"is_desktop":true,"is_bot":false}

Try It

User-Agent

GET/whois/{domain}

Get WHOIS information for a domain.

Parameters

Name	Type	Required	Description
`domain`	string	Yes	Domain name (e.g. google.com)

Example Request

curl -H "X-API-Key: YOUR_KEY" https://baas.dapita.net/whois/google.com

Response

{"domain":"google.com","registrar":"MarkMonitor Inc.","created_date":"1997-09-15T04:00:00Z","expiry_date":"2028-09-14T04:00:00Z","updated_date":"2019-09-09T15:39:04Z","name_servers":["ns1.google.com","ns2.google.com","ns3.google.com","ns4.google.com"],"domain_available":false}

Try It

Domain

GET/dns/lookup/{domain}?type={type}

DNS lookup for domain. Returns A, AAAA, MX, TXT, CNAME, or NS records. Useful for email validation and domain verification.

Parameters

Name	Type	Required	Description
`domain`	string	Yes	Domain name (e.g. google.com)
`type`	query	No	Record type: A, AAAA, MX, TXT, CNAME, NS (default: A)

Example Request

curl -H "X-API-Key: YOUR_KEY" "https://baas.dapita.net/dns/lookup/google.com?type=MX"

Response

{"domain":"google.com","query_type":"MX","records":[{"host":"smtp.google.com","priority":10}],"count":1}

Try It

Domain

Type

This Month

of 0 limit

Errors

Success Rate

Avg Response

📈 Requests Over Time

🎯 Requests by Endpoint

⚠️ Errors by Endpoint

Endpoint	Requests	Errors	Error Rate	Last Error
No errors

📋 Detailed Stats

Date	Endpoint	Requests	Errors	Avg Response
Select a project

CURRENT PLAN

Free ForeverFree

1,000 requests/month • 5 requests/hour

Free Forever

£0/forever

✓ 1,000 requests/month
✓ 5 requests/hour
✓ All 30+ APIs
✓ 1 organization
✓ 1 project
✓ 1 API key
✗ IP Whitelist
✗ Support

Pay-as-you-go

£5/month

✓ 5,000 requests/month
✓ 20 requests/hour
✓ All 30+ APIs
✓ 3 organizations
✓ 3 projects each
✓ 3 API keys per project
✓ Email support
+£5 per 5,000 extra

Growth

£15/month

✓ 50,000 requests/month
✓ 100 requests/hour
✓ All 30+ APIs
✓ 10 organizations
✓ 10 projects each
✓ 10 API keys per project
✓ IP Whitelist
✓ Priority support

Scale

£30/month

✓ 500,000 requests/month
✓ 700 requests/hour
✓ All 30+ APIs
✓ Unlimited organizations
✓ Unlimited projects
✓ Unlimited API keys
✓ IP Whitelist
✓ SLA 99.9%
✓ Dedicated support

⚡ API Rate Limits

▼

Enterprise

Custom limits, dedicated infrastructure, SLA guarantees.

Contact Sales

Top Up Extra Requests

Need more requests? Purchase extra requests that never expire.

Billing History

Date	Description	Amount	Status	Invoice
No billing history yet

🔒 Secure payment via Stripe. Cancel anytime. All prices in GBP.

Welcome to BaaS! 🎉

Dashboard

Loading... -

📈 Requests

Organizations

Projects

API Keys & Security

🔑 API Keys

🛡️ IP Whitelist

API Documentation

API Overview

Base URL

Authentication

Request Headers

Error Responses

Rate Limits

Special Rate Limits

Parameters

Example Request

Response

Field guide

How to use correctly

Try It

Parameters

Example Request

Response

Try It

Example Request

Response

Try It

Parameters

Example Request

Response

Try It

Parameters

Example Requests

Response (single)

Try It

Query Parameters

Example Requests

Response

Try It

Query Parameters

Example Request

Response

Try It

Query Parameters

Example Requests

Response

Try It

Parameters

Example Request

Response

Try It

Query Parameters

Example Request

Response

Try It

Query Parameters

Example Request

Response

Try It

Parameters

Example Requests

Response (single)

Try It

Parameters

Example Request

Response

Try It

Parameters

Example Request

Response

Try It

Parameters

Example Request

Response

Try It

Parameters

Example Request