Skip to main content
If you run into any issues, report them to support@blink.store and we’ll fix them right away.
Welcome to the Blink API! Our suite of APIs provides everything you need to build, manage, and scale your storefront programmatically.

Core API

The main server-to-server API for merchants to manage checkouts, products, deliverables, and store settings.

Financials API

Manage the money side of your business, including invoices, taxes, refunds, disputes, and payouts.

Growth & Marketing API

Powerful endpoints for cart recovery, discounts, affiliates, splits, and geo-pricing.

Webhooks & Events

Event tracking and webhook management to keep your external systems perfectly in sync.

​
Base URLs

The Blink API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Production Base URL

https://api.blink.store/v1
Test Mode: Blink does not use a separate Sandbox URL. Instead, we offer a unified Test Mode. All API requests made using a test-mode secret key are completely isolated from your production data. Learn more in our Test Mode guide.

​
Authentication

Blink uses Merchant Secret Keys to authenticate your requests.

​
Merchant Secret Keys

For server-to-server interactions, authenticate requests using your Store Secret Key. You can view and manage your API keys in the Blink Dashboard. Do not share your secret API keys in publicly accessible areas such as GitHub, or client-side code. Authentication to the API is performed via HTTP Bearer Auth. In addition to the Bearer token, all requests must include the x-store-id header to specify which store you are interacting with.
All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

​
Pagination

All top-level API resources have support for bulk fetches via “list” API methods. These list API methods share a common pagination structure. Blink uses offset-based pagination via the page and limit query parameters.

​
Query Parameters

​
Response Format

A paginated response will always wrap the results in a data array and include a meta object containing pagination details.
Paginated Response

​
Rate Limits

To prevent abuse, Blink limits the number of API requests you can make in a given timeframe.
  • Rate Limit: 100 requests per second
If you exceed these limits, the API will return a 429 Too Many Requests status code.