API v1 • Stable

Build with the Demurly API

Integrate demurrage tracking into your systems with our REST API, webhooks, and TypeScript SDK.

99.9%Uptime SLA

<100msAvg Response

REST + Webhooks

REST API

Full access to all Demurly resources via REST endpoints.

Webhooks

Real-time event notifications for your applications.

API Keys

Secure authentication for your integrations.

SDKs

Official TypeScript SDK for faster development.

Quick Start

Get started with the Demurly API in minutes:

1
Get your API key
Go to Settings → API in your dashboard to create an API key.
2
Make your first request
Use your API key to authenticate requests.

Example: List Records

curl -X GET "https://api.demurly.com/v1/records" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Authentication

All API requests require authentication via Bearer token:

Authorization: Bearer YOUR_API_KEY

Keep your API key secure

Never expose your API key in client-side code or public repositories. Use environment variables and server-side requests.

API Key Permissions

Read: Access records, drivers, and reports
Write: Create and update resources
Admin: Full access including settings

Webhooks

Subscribe to events and receive real-time notifications when things happen in Demurly. Click an event to see the payload.

Available Events

Webhook Security

Verify webhook signatures using the X-Demurly-Signature header to ensure requests are from Demurly.

Rate Limits

API requests are rate limited based on your subscription tier:

Tier	Requests/min	Burst
Starter	60	100
Professional	300	500
Enterprise	1000	2000

Rate limit headers are included in responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

SDKs & Tools

TypeScript SDK

Official SDK with full type safety and autocomplete.

npm install @demurly/sdk

OpenAPI Spec

Generate clients in any language from our OpenAPI specification.

API Changelog

Stay up to date with API changes and new features.

Need Help?

Our developer support team is here to help with integration questions.

API Playground

Test API endpoints directly in your browser with mock responses

API Playground

Try it live

API Key

Your key is only used locally and never stored. For demo, enter any value.

Endpoint

GEThttps://api.demurly.com/v1/records

Webhook Tester

Send test webhooks to verify your integration is working

Webhook Tester

Test your endpoint

Your Webhook URL *

Event Type

When a new demurrage record is created

Payload