Your first API call

Prerequisites

• An active Meridian license key
• Your API endpoint: https://api.getnimbus.net/v1

cURL

The fastest way to test connectivity. Replace YOUR_KEY with your actual license key.

curl -X GET \
  "https://api.getnimbus.net/v1/hello" \
  -H "Authorization: Bearer YOUR_KEY"

Expected response: {"status":"ok","message":"Hello from Meridian"}

Python

Using the requests library. Install it first if needed.

import requests

API_URL = "https://api.getnimbus.net/v1"
LICENSE_KEY = "YOUR_KEY"

headers = {"Authorization": f"Bearer {LICENSE_KEY}"}
resp = requests.get(f"{API_URL}/hello", headers=headers)

print(resp.status_code, resp.json())

TypeScript / Node.js

Works in any Node.js 18+ runtime. No extra dependencies required.

const API_URL = "https://api.getnimbus.net/v1";
const LICENSE_KEY = "YOUR_KEY";

const resp = await fetch(`${API_URL}/hello`, {
  headers: { Authorization: `Bearer ${LICENSE_KEY}` },
});

const data = await resp.json();
console.log(resp.status, data);

Next steps

You are now authenticated. Head over to the API reference for the full endpoint catalog, or explore error codes to understand every response shape.