CreddotDocsCreddot Docs

List refund requests in the API key environment

GET
/api/v1/refunds

Authorization

api-key
headerx-api-key<token>

Your API key: ck_test_... for test mode, ck_live_... for live. Send it with x-api-secret (or Authorization: Bearer ).

Query Parameters

status?string
Value in"REQUESTED""APPROVED""PROCESSING""SUCCESS""FAILED""REJECTED"
page?number
Default1
pageSize?number
Rangevalue <= 100
Default20

Header Parameters

x-api-secret?string

Recommended: API secret sent over HTTPS. You may send it as Authorization: Bearer instead. If supplied, x-timestamp and x-signature are not required.

x-timestamp?string

Legacy signed mode: Unix time in milliseconds; maximum clock skew five minutes.

x-signature?string

Legacy signed mode: HMAC-SHA256(secret, timestamp.METHOD.url.idempotencyKey.bodyHash).

x-idempotency-key*string

1–128 letters/digits or ._:-. Same key and payload replay for 24 hours; conflicting, in-flight, or expired keys return 409. Never change a key to retry an uncertain payment.

Response Body

Example Request
curl -X GET 'https://api.creddot.com/api/v1/refunds' \  -H 'x-idempotency-key: string'
Example Response
Empty