Puerto Rico Business Entity API: Vollständiger Entwicklerleitfaden
Puerto Rico nimmt als US-amerikanisches Territorium eine besondere Stellung ein: Es unterliegt dem US-Bundesrecht, verfügt aber über ein eigenes Handelsregister und bietet Unternehmen steuerliche Vorteile durch Programme wie Act 60. Für deutsche und europäische Compliance-Teams, die Geschäftsbeziehungen mit puertoricanischen Gesellschaften prüfen müssen, stellt die automatisierte Registerabfrage einen unverzichtbaren Baustein dar. Dieser Leitfaden zeigt, wie Sie mit der Puerto Rico Business Entity API von OpenSOSData schnell und regelkonform auf offizielle Registerdaten zugreifen.
Warum Puerto Rico für EU-Compliance-Teams relevant ist
Obwohl Puerto Rico kein US-Bundesstaat ist, werden dort Unternehmen nach eigenem Territorialrecht eingetragen. Viele Holdinggesellschaften, Fintechs und Pharmaunternehmen wählen Puerto Rico gezielt wegen der Steuerprivilegien. Für deutsche Unternehmen, die solche Gegenparteien onboarden, gelten dennoch die gleichen KYB-Pflichten wie bei jeder anderen US-amerikanischen Gesellschaft.
Folgende regulatorische Anforderungen machen eine API-basierte Verifikation unerlässlich:
- EU AMLD6 (6. Geldwäscherichtlinie): Erweiterte Definition von Vortätern, strengere Sorgfaltspflichten bei Drittlandsbezug und direkte strafrechtliche Verantwortlichkeit juristischer Personen.
- Deutsches GwG (§§ 10–17 GwG): Pflicht zur Identifizierung und Verifikation von Vertragspartnern sowie wirtschaftlich Berechtigten. Bei US-Gesellschaften ohne deutschen Handelsregistereintrag sind ausländische Registerauszüge das primäre Nachweismittel.
- BaFin-Rundschreiben zu US-Gegenparteien: BaFin erwartet, dass Institute die Existenz und den Status einer US-Gesellschaft durch offizielle Quellen nachweisen – ein API-Pull direkt aus dem Secretary-of-State-Register erfüllt diese Anforderung.
- DSGVO / GDPR: Bei der Verarbeitung von Unternehmensdaten aus den USA sind Art. 44 ff. DSGVO zu beachten. Da es sich bei Registerdaten um öffentlich zugängliche Informationen handelt, ist das Verarbeitungsrisiko gering; dennoch sollte ein Data Processing Agreement mit dem API-Anbieter vorliegen.
Was die OpenSOSData API für Puerto Rico liefert
Die OpenSOSData-Plattform deckt alle 50 US-Bundesstaaten sowie Washington D.C., Puerto Rico und die U.S. Virgin Islands ab – insgesamt über 34 Millionen Entitäten. Für jede Gesellschaft liefert die API folgende strukturierte Daten:
- Offizieller Firmenname und Namenshistorie
- Gesellschaftsform (LLC, Corporation, Partnership etc.)
- Einmalige Register-ID des Territoriums
- Aktueller Status (Active, Inactive, Dissolved usw.)
- Gründungsdatum
- Name und Adresse des Registered Agent
Diese Felder decken die Kernanforderungen einer GwG-konformen KYB-Prüfung ab und lassen sich direkt in bestehende Onboarding-Workflows integrieren.
Entitäten ab $0,10 pro Abfrage verifizieren
Live-Abfragen ab $0,10, mit Volumen bis zu $0,0314. Nutzungsbasierte Abrechnung.
Kostenloses Konto erstellenAPI-Endpunkt und Authentifizierung
Alle Abfragen laufen über einen einzigen POST-Endpunkt:
POST https://api.opensosdata.com/v1/lookup
Die Authentifizierung erfolgt per API-Key im HTTP-Header. Den Key erhalten Sie nach der Registrierung unter app.opensosdata.com. Detaillierte Dokumentation finden Sie unter opensosdata.com/docs/.
Der wichtigste Request-Parameter ist cache_preference mit den Werten:
live_only– direkte Abfrage beim Territorialregister (aktuellste Daten)cache_first– gecachte Daten bevorzugt, bei Bedarf Live-Abfragecache_only– ausschließlich aus dem Cache (günstigste Option)
Praxisbeispiel: Puerto Rico LLC per Python verifizieren
Das folgende Beispiel zeigt eine vollständige Abfrage inklusive Fehlerbehandlung. Für GwG-Zwecke empfehlen wir live_only, um stets den aktuellen Registerstatus zu erhalten.
import requests
import json
# --- Konfiguration ---
API_KEY = "ihr_api_key_hier" # API-Key aus app.opensosdata.com
API_URL = "https://api.opensosdata.com/v1/lookup"
# --- Anfrageparameter für eine Puerto-Rico-Gesellschaft ---
payload = {
"state": "PR", # Kürzel für Puerto Rico
"company_name": "Tropical Ventures LLC",
"cache_preference": "live_only" # Direktabfrage für GwG-Compliance
}
headers = {
"x-api-key": API_KEY,
"Content-Type": "application/json"
}
# --- API-Anfrage senden ---
try:
response = requests.post(API_URL, headers=headers, json=payload, timeout=15)
response.raise_for_status()
daten = response.json()
# --- Ergebnis auswerten ---
if daten.get("results"):
treffer = daten["results"][0]
print("=== KYB-Verifikationsergebnis ===")
print(f"Firmenname: {treffer.get('entity_name')}")
print(f"Gesellschaftsform:{treffer.get('entity_type')}")
print(f"Register-ID: {treffer.get('entity_id')}")
print(f"Status: {treffer.get('status')}")
print(f"Gründungsdatum: {treffer.get('formation_date')}")
print(f"Registered Agent: {treffer.get('registered_agent')}")
print(f"Agent-Adresse: {treffer.get('registered_agent_address')}")
else:
print("Keine Treffer – Gesellschaft nicht gefunden.")
except requests.exceptions.HTTPError as http_err:
print(f"HTTP-Fehler: {http_err}")
except requests.exceptions.Timeout:
print("Zeitüberschreitung – bitte erneut versuchen.")
except Exception as err:
print(f"Unerwarteter Fehler: {err}")
Das gleiche Ergebnis lässt sich auch mit einem einfachen cURL-Befehl erzielen:
# cURL-Beispiel – Puerto Rico Unternehmenssuche
curl -X POST https://api.opensosdata.com/v1/lookup \
-H "x-api-key: ihr_api_key_hier" \
-H "Content-Type: application/json" \
-d '{
"state": "PR",
"company_name": "Tropical Ventures LLC",
"cache_preference": "live_only"
}'
Preismodell im Überblick
OpenSOSData nutzt ein nutzungsbasiertes Preismodell ohne Grundgebühr. Die folgende Tabelle gibt eine Übersicht (Preise in USD, EUR-Äquivalent ca.*):
| Abfragetyp | Standardpreis | Volumenpreis (ab) |
|---|---|---|
Live-Abfrage (live_only) |
$0,10 (~€0,09) | ab $0,0314 (~€0,03) |
Cache-Abfrage (cache_only) |
$0,01 (~€0,009) | ab $0,00314 (~€0,003) |
* Wechselkurs ca. 1 USD = 0,92 EUR; aktueller Kurs zum Zeitpunkt der Nutzung maßgeblich.
Für typische KYB-Workflows, bei denen Live-Daten erforderlich sind, liegen die Kosten pro Onboarding-Vorgang damit unter $0,10 – deutlich günstiger als manuelle Registerauszüge oder kommerzielle Datenanbieter.
Puerto Rico vs. US-Bundesstaaten: Was Compliance-Teams wissen müssen
Das Register von Puerto Rico (Departamento de Estado de Puerto Rico) ist technisch unabhängig von den Secretary-of-State-Registern der 50 Bundesstaaten, wird jedoch durch die OpenSOSData-Plattform einheitlich abgefragt. Für Compliance-Zwecke gilt:
- Gesellschaften aus Puerto Rico sind keine ausländischen Unternehmen im US-Sinne, aber auch keine inländischen US-Bundesstaatsgesellschaften.
- Im EU-Sanktionskontext gelten sie als US-Unternehmen; EU-Sanktionsverordnungen und OFAC-Listen sind parallel zu prüfen.
- Der Registered Agent muss physisch in Puerto Rico ansässig sein – ein wichtiges Indiz für die operative Präsenz.
Integration in bestehende Compliance-Systeme
Die REST-API lässt sich ohne großen Aufwand in gängige Compliance-Plattformen einbinden. Typische Integrationspunkte sind:
- Onboarding-Workflow: Automatische KYB-Prüfung bei Anlage eines neuen Geschäftspartners in ERP oder CRM.
- Periodische Überprüfung: Geplante Batch-Abfragen (z. B. monatlich) zur Statusüberwachung bestehender Gegenparteien – wichtig für §10 Abs. 1 Nr. 5 GwG.
- Sanktions-Screening-Integration: Kombination des Firmennamens und der Register-ID mit Screening-Diensten gegen EU-Konsolidierte Liste und OFAC SDN-Liste.
- Audit-Trail: Speicherung der API-Antwort (inkl. Zeitstempel) als unveränderliches Compliance-Dokument gemäß §8 GwG (5 Jahre Aufbewahrungspflicht).
FAQ: Puerto Rico Business Entity API
Welche Gesellschaftsformen in Puerto Rico lassen sich über die API abfragen?
Die API deckt alle im Departamento de Estado de Puerto Rico eingetragenen Entitäten ab, darunter LLCs (Limited Liability Companies), Corporations, Partnerships, Non-Profit-Organisationen und ausländische (Foreign) Gesellschaften, die in Puerto Rico registriert sind. Der Rückgabewert im Feld entity_type spiegelt die offizielle Bezeichnung aus dem Register wider.
Wie aktuell sind die Daten bei einer Live-Abfrage?
Bei cache_preference: live_only ruft OpenSOSData die Daten direkt vom offiziellen Register ab. Die Antwortzeit liegt typischerweise zwischen 2 und 8 Sekunden. Statusänderungen (z. B. Dissolution) sind damit nahezu in Echtzeit verfügbar – ein wesentlicher Vorteil gegenüber statischen Datenbankprodukten.
Ist die API DSGVO-konform nutzbar?
Registerdaten sind öffentlich zugängliche Informationen und enthalten keine personenbezogenen Daten im Sinne der DSGVO (Art. 4 Nr. 1), soweit es sich um Gesellschaftsdaten handelt. Dennoch empfehlen wir, mit OpenSOSData einen Data Processing Agreement abzuschließen und die Datenspeicherung auf EU-Servern sicherzustellen. Für Details wenden Sie sich an den Support über opensosdata.com.
Kann ich Puerto Rico zusammen mit anderen US-Staaten in einer einzigen Integration abdecken?
Ja. Der API-Endpunkt ist für alle unterstützten Jurisdiktionen identisch. Sie ändern lediglich den Parameter state – z. B. "state": "PR" für Puerto Rico oder "state": "DE" für Delaware. Alle 50 Bundesstaaten, Washington D.C., Puerto Rico und die U.S. Virgin Islands sind über denselben Endpunkt erreichbar.
Welche Mindestinformationen benötige ich für eine erfolgreiche Abfrage?
In der Regel genügen Jurisdiktion (state: "PR") und Firmenname. Optional können Sie die Register-ID übergeben, falls bekannt – das erhöht die Treffsicherheit erheblich. Bei häufigen Firmennamen empfiehlt sich die Kombination mit dem Gründungsjahr. Details zur Parameterstruktur finden Sie in der offiziellen Dokumentation.
Wie funktioniert die Abrechnung – gibt es Mindestvolumen oder Grundgebühren?
OpenSOSData arbeitet nach dem Pay-as-you-go-Prinzip ohne Mindestvolumen oder monatliche Grundgebühr. Live-Abfragen kosten $0,10 pro Abfrage im Standard, mit Volumenrabatten bis hinunter zu $0,0314. Cache-Abfragen beginnen bei $0,01. Sie zahlen ausschließlich für tatsächlich durchgeführte Abfragen. Die Registrierung ist kostenlos unter app.opensosdata.com.
Genügt ein API-Auszug als Nachweisdokument gegenüber BaFin oder anderen Aufsichtsbehörden?
Ein strukturierter API-Response mit Zeitstempel und direktem Datenbankbezug zum offiziellen Register ist als Nachweismittel grundsätzlich geeignet. Wir empfehlen jedoch, die Antwort als JSON-Datei zu archivieren und in der Compliance-Akte zu vermerken, dass die Quelle das offizielle Territorialregister von Puerto Rico ist. Bei besonders risikoreichen Gegenparteien (High-Risk-Jurisdiktionen, PEP-Bezug) kann ergänzend ein notariell beglaubigter Auszug sinnvoll sein.
Fazit und nächste Schritte
Die automatisierte Abfrage des puertoricanischen Handelsregisters via API ist kein Nice-to-have, sondern ein praktischer Compliance-Baustein für jedes deutsche oder europäische Unternehmen mit Geschäftskontakten in die USA. Mit OpenSOSData erhalten Sie Zugang zu 34 Millionen US-Entitäten – inklusive Puerto Rico – über eine einzige, einfach zu integrierende REST-Schnittstelle. Die Kosten sind transparent und nutzungsbasiert, die Daten sind direkt aus offiziellen Registern bezogen und damit revisionssicher dokumentierbar.
Starten Sie jetzt kostenlos: Legen Sie Ihren API-Key unter app.opensosdata.com an und konsultieren Sie die vollständige technische Dokumentation unter opensosdata.com/docs/. Für Fragen zu Enterprise-Volumenpreisen und Compliance-Integrationen besuchen Sie opensosdata.com.