Skip to main content
Our SDK provides a type-safe way to use our conversion services directly through an installable package from npm.
In essence, it’s a lightweight wrapper around our REST API — but with type safety, auto-completion, and an enhanced developer experience (DX).

​
Why Use the SDK Instead of the REST API?

  • Type Safety: Get full TypeScript support to catch issues at compile time and reduce runtime errors.
  • Simplified Integration: Includes pre-built functions for requests, authentication, and response handling — no need to manually set up fetch calls.
  • Faster Development: Focus on your app’s logic while the SDK handles the boilerplate.
  • Better Documentation: Clear examples and typings make it easy to discover and use available methods.
  • Automatic Updates: The SDK stays in sync with the API, giving you access to the latest endpoints and improvements.
The only reason not to use the SDK is if your environment doesn’t support npm (e.g., a non-JavaScript runtime) or if your use case requires direct REST API calls.

​
Installation

The SDK works with all major JavaScript runtimes that support npm, including Node.js, Deno, and Bun. To install it, run one of the following commands in your project directory: 
npm install @ip2geo/sdk@latest