Environments

CertiLayer currently runs on a single live environment. There's no separate test/sandbox mode yet — every API key you create is a live key, and every request hits the same production pipeline.

⚠️

A dedicated test/sandbox environment (separate key prefix, isolated data) is planned but not built yet. If your workflow needs to test against a real backend without touching production data, use a self-hosted instance (below) instead.

Live environment

REST / GraphQL base URLhttps://api.certilayer.net

Ingestion Gateway base URLhttps://ingest.certilayer.net

Public key prefixcertilayer_live_pk_

Secret key prefixcertilayer_live_sk_

Pointing an SDK at a self-hosted or local instance

Every SDK accepts a base URL override — useful for local development against your own running stack, or a self-hosted CertiLayer deployment.

Web SDK

import { init } from '@certilayer/web'

const certilayer = init({
  apiKey: 'certilayer_live_pk_xxxx',
  endpoint: 'http://localhost:3001', // your local L2 Ingestion Gateway
})

Node.js SDK

import { CertiLayerClient } from '@certilayer/node'

const certilayer = new CertiLayerClient({
  apiKey: process.env.CERTILAYER_SECRET_KEY!,
  baseUrl: 'http://localhost:4000/v1', // your local L8 API
})

Python SDK

from certilayer import CertiLayerClient

client = CertiLayerClient(
    api_key=os.environ["CERTILAYER_SECRET_KEY"],
    base_url="http://localhost:4000/v1",  # your local L8 API
)

ℹ️

The React Native SDK reads its endpoint the same way as the Web SDK — pass endpoint to CertiLayer.init().

Need an isolated test environment today?

Contact [email protected] — we can discuss options while the dedicated sandbox environment is in development.