Circle APIs Documentation

Learn how to integrate with Circle APIs to accept traditional and stablecoin payments, embed digital wallets into your product or service, or power your internet marketplace.

Idempotent Requests

The Circle APIs support idempotent requests so that you can safely retry API calls when things go wrong before you receive a response.

For instance, let's say you were creating a payment but before you received a response there was a network connection issue. Did the payment get created? Is it safe to retry or are you going to charge your end user multiple times?

To allow you to retry certain requests without causing the operation to be executed multiple times, Circle APIs' POST operations have an idempotency body parameter called idempotencyKey.

To ensure a request is idempotent you have to generate and provide such parameter. Subsequent requests with the same idempotencyKey parameter value will produce the same result as the initial request.

📘

UUID Format

The idempotencyKey body parameter has to be sent in UUID format.

The following Circle API operations support idempotent requests. Check the API reference for more details.

Updated 5 months ago


Idempotent Requests


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.