Browse the API reference

List Credit Transactions

get/v1/graphs/{graph_id}/credits/transactions

Part of Credits.

Authentication

Authenticate in any one of these ways — not all of them:

  • API key in the X-API-Key header.
  • Bearer token in the Authorization header.

Path parameters

NameTypeDescription
graph_idrequiredstringGraph database identifier

Query parameters

NameTypeDescription
transaction_typeoptionalstringFilter by transaction type (allocation, consumption, bonus, refund)
operation_typeoptionalstringFilter by operation type (e.g., entity_lookup, cypher_query)
start_dateoptionalstringStart date for filtering (ISO format: YYYY-MM-DD)
end_dateoptionalstringEnd date for filtering (ISO format: YYYY-MM-DD)
limitoptionalintegerMaximum number of transactions to return

Default: 100

offsetoptionalintegerNumber of transactions to skip

Default: 0

Example request

curl
curl -X GET "https://api.robosystems.ai/v1/graphs/{graph_id}/credits/transactions" \
  -H "X-API-Key: $ROBOSYSTEMS_API_KEY"

Responses

200 Successful Response

FieldTypeDescription
transactionsrequiredEnhancedCreditTransactionResponse[]

Enhanced credit transaction response with more details.

EnhancedCreditTransactionResponse fields
FieldTypeDescription
idrequiredstring
typerequiredstring
amountrequirednumber
descriptionrequiredstring
metadatarequiredobject
created_atrequiredstring
operation_idoptionalstring
idempotency_keyoptionalstring
request_idoptionalstring
user_idoptionalstring
summaryrequiredobject
total_countrequiredinteger
filtered_countrequiredinteger
date_rangerequiredobject
StatusMeaning
400Invalid request
401Authentication required
403Access denied
404Resource not found
422Validation Error
429Rate limit exceeded
500Internal server error