Skip to main content

​
Accessing the API

The TerraKit API is available at: 
https://api.terrakit.dev/v1
You can generate API keys in your Account Settings. Use projects to segment your API keys and control spend by use case.

​
Authentication

All requests to the TerraKit API must include an authorization header with your API key. If you are using the Client SDKs, you will set the API key when constructing a client, and then the SDK will send the header on your behalf with every request. If integrating directly with the API, you’ll need to send this header yourself. All requests must also include a terrakit-version header with a date in YYYY-MM-DD format. The version defines the response contract.

​
Content Types

The TerraKit API accepts JSON in request bodies and returns JSON in response bodies. You will need to include the content-type: application/json header in your requests. Client SDKs handle this automatically.

​
Response Headers

All API responses include standard headers:
  • request-id - Unique identifier for the request, useful for debugging and support

​
Examples

curl https://api.terrakit.dev/v1/addresses/resolve \
  -H "content-type: application/json" \
  -H "authorization: Bearer YOUR_API_KEY" \
  -H "terrakit-version: 2025-10-04" \
  -d '{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  }'