API Documentation

View as markdown

Make your first request

Start with authentication, then send a single lookup using the examples in the IP API reference. HTTP endpoints use the versioned base URL https://api.synthient.com/api/v4. Supply your API key in the x-api-key header and keep it on your server, outside browser bundles and public repositories.

Inspect the response before building a decision around it. Network ownership, location, observed providers, and risk signals describe different aspects of an address. Use service tags to identify providers and risk scoring to understand how to combine observations with your own application data.

Prepare for production

Check the account endpoint for granted scopes and remaining lookup credits. Review rate limits before choosing batch sizes or concurrency. Handle the documented error responses explicitly so an authentication failure or exhausted quota cannot be mistaken for a successful lookup with no observations.

Choose the interface that fits your application: HTTP for direct requests, the Go SDK for a Go integration, or gRPC for typed messages and reflection. For scheduled warehouse imports or continuous events, compare the enterprise data products.