Install an official Meridian SDK for JavaScript, Python, Go, Java, or Ruby - or call the REST API directly.
You can talk to Meridian two ways: the REST API directly over HTTPS, or through an official SDK that handles auth, retries, pagination, and types for you. SDKs are recommended for anything beyond quick experiments.
Requires Node.js 18.17 or later. Works in Node, Deno, Bun, and edge runtimes.
npm install @meridian/sdkyarn add @meridian/sdkpnpm add @meridian/sdkimport { Meridian } from "@meridian/sdk";
const client = new Meridian(process.env.MERIDIAN_API_KEY);Requires Python 3.9 or later. Ships with type hints and async support via AsyncMeridian.
pip install meridianpoetry add meridianimport os
from meridian import Meridian
client = Meridian(os.environ["MERIDIAN_API_KEY"])Requires Go 1.21 or later.
go get github.com/meridian/meridian-go/v2import (
"github.com/meridian/meridian-go/v2"
)
client := meridian.NewClient(os.Getenv("MERIDIAN_API_KEY"))Requires Java 11 or later. Available on Maven Central.
<dependency>
<groupId>dev.meridian</groupId>
<artifactId>meridian-java</artifactId>
<version>1.0.0</version>
</dependency>implementation("dev.meridian:meridian-java:1.0.0")Requires Ruby 3.0 or later.
gem install meridiangem "meridian", "~> 1.0"The REST API is plain HTTPS + JSON. Any HTTP client works:
| Detail | Value |
|---|---|
| Base URL | https://api.meridian.dev/v2 |
| Auth | Authorization: Bearer <key> header |
| Request body | application/json |
| Response | application/json, always an object |
curl https://api.meridian.dev/v2/projects \
-H "Authorization: Bearer $MERIDIAN_API_KEY"/v2). Breaking changes ship under a new path, never in place.| SDK | Minimum version | Package |
|---|---|---|
| JavaScript | Node.js 18.17 | @meridian/sdk |
| Python | 3.9 | meridian |
| Go | 1.21 | meridian-go/v2 |
| Java | 11 | dev.meridian:meridian-java |
| Ruby | 3.0 | meridian |