CreddotDocsCreddot Docs
API referenceTransactions

List transactions

Lists transactions in the API key environment with currency, status, type, channel, date, amount, search, sorting, and pagination filters.

GET
/api/v1/transactions

Lists transactions in the API key environment with currency, status, type, channel, date, amount, search, sorting, and pagination filters.

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

page?number
Range1 <= value
Default1
pageSize?number
Range1 <= value <= 100
Default20
currency?string

Account currency. Results never mix currencies.

Default"NGN"
direction?string

MONEY_IN selects collections. MONEY_OUT selects payouts, refunds, reversals, and bill payments.

Value in"MONEY_IN""MONEY_OUT"
status?array<>

Repeat the query parameter or send a comma-separated list.

type?array<>

Repeat the query parameter or send a comma-separated list.

channel?array<>

Repeat the query parameter or send a comma-separated list.

dateFrom?string

Inclusive lower ISO 8601 UTC date/time. A YYYY-MM-DD value starts at 00:00:00 UTC.

dateTo?string

Inclusive upper ISO 8601 UTC date/time. A YYYY-MM-DD value includes the entire UTC day.

minAmountMinor?string

Inclusive minimum in integer minor units.

Match^\d{1,19}$
maxAmountMinor?string

Inclusive maximum in integer minor units.

Match^\d{1,19}$
search?string

Case-insensitive partial match across reference, provider reference, customer name, and customer email.

Lengthlength <= 120
sortBy?string
Default"createdAt"
Value in"createdAt""amountMinor"
sortDirection?string
Default"desc"
Value in"asc""desc"

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).

Response Body

Invalid API key/secret, signed request, timestamp, or IP whitelist.

Example Request
curl -X GET 'https://api.creddot.com/api/v1/transactions'
Example Response
Empty

Find a transaction by merchant reference GET

Requires transactions:read. Scoped to the API key merchant and environment. Use after uncertain responses; never resend with a new key.

Read current transaction status GET

Requires transactions:read. Creation retries replay the original response; this endpoint returns current status.