Skip to main content
GET
/
api
/
v1
/
credit_systems
/
v2
/
wallets
/
transactions
cURL
curl -X GET "https://api.metrifox.com/api/v1/credit_systems/v2/wallets/transactions?customer_key=cust-mljp3ra6ffjm&feature_key=image_generation&per_page=20" \
  -H "x-api-key: your_api_key"
{
  "statusCode": 200,
  "message": "Credit transactions fetched successfully",
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 3,
    "limit_value": 10,
    "next_page": null,
    "prev_page": null,
    "first_page": true,
    "last_page": true,
    "out_of_range": false
  },
  "data": [
    {
      "id": "9af2e7b1-8c3d-4d52-9b1a-23c7e4f60d21",
      "amount": 25,
      "quantity": 5,
      "event_name": "image_generated",
      "usage_event_id": "ue_01HXYZ456DEF",
      "created_at": "2026-03-18T14:08:47.802Z"
    },
    {
      "id": "2e8c1a4f-9b73-4f1a-bd64-58a9d7c83ef0",
      "amount": 10,
      "quantity": 2,
      "event_name": "image_generated",
      "usage_event_id": "ue_01HXYZ123ABC",
      "created_at": "2026-03-15T09:22:03.114Z"
    },
    {
      "id": "5c0b9d72-1a44-4e83-9f2c-6e3a8b1d04f7",
      "amount": 8,
      "quantity": null,
      "event_name": "overage payoff",
      "usage_event_id": null,
      "created_at": "2026-03-12T17:02:11.500Z"
    }
  ],
  "errors": {}
}

Authorizations

x-api-key
string
header
required

Query Parameters

customer_key
string
required

The unique identifier of the customer on your platform, saved as customer_key on Metrifox

subscription_id
string<uuid>

Only return transactions for allocations granted by this subscription

feature_key
string

Only return transactions produced by this feature

start_date
string<date-time>

Only return transactions recorded at or after this timestamp (ISO 8601)

end_date
string<date-time>

Only return transactions recorded at or before this timestamp (ISO 8601)

page
integer
default:1

The page of results to return

per_page
integer
default:10

Number of records per page

Response

Credit transactions fetched successfully

statusCode
integer
Example:

200

message
string
Example:

"Credit transactions fetched successfully"

meta
object

Pagination metadata

data
object[]
errors
object