💳 Transactions API: How to Use It

🔍 What is the Transactions API?

The Transactions API v1 allows you to retrieve expense data generated by Clara cards within your organization. Each transaction includes metadata such as amount, currency, date, merchant, and the associated user and card.

This version is read-only, ideal for use cases like:

• Expense reconciliation
• Transaction history visualization
• Internal reporting and dashboards

🆚 Note: For enhanced filtering or expanded metadata, consider using Transactions API v2.

📌 Available Endpoints

Operation	Endpoint	Method
Find all transactions	/v1/transactions	GET
Find transaction by UUID	/v1/transactions/{uuid}	GET

1️⃣ Find all transactions

Use this endpoint to fetch a list of all transactions. The response is paginated and includes key information about each transaction such as amount, status, category, and user.

🔗 Endpoint

GET /v1/transactions

📤 cURL Request

cURL

curl -X GET \
"https://public-api.mx.clara.com/api/v1/transactions" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

📥 Sample JSON Response

JSON

[
 [
  {
    "uuid": "txn-001",
    "amount": 1250.50,
    "currency": "MXN",
    "status": "APPROVED",
    "merchant": "Amazon",
    "category": "Office Supplies",
    "userUuid": "user-001",
    "cardUuid": "card-001",
    "createdAt": "2025-06-15T12:30:00Z"
  }
]

2️⃣ Find transaction by UUID

Use this endpoint to get full details of a specific transaction by its UUID. This is useful for audit views, drill-downs in dashboards, or reconciliation workflows.

🔗 Endpoint

GET /v1/transactions/{uuid}

📤 cURL Request

cURL

curl -X GET \
"https://public-api.mx.clara.com/api/v1/transactions/txn-001" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

📥 Sample JSON Response

JSON

{
  "uuid": "txn-001",
  "amount": 1250.50,
  "currency": "MXN",
  "status": "APPROVED",
  "merchant": "Amazon",
  "category": "Office Supplies",
  "description": "Purchase of printer toner",
  "userUuid": "user-001",
  "cardUuid": "card-001",
  "createdAt": "2025-06-15T12:30:00Z"
}

💡 Tip: Use the userUuid and cardUuid fields to join transaction data with user and card profiles for enriched analysis.

⚠️ Note: This API is paginated. Make sure to handle pagination parameters when retrieving large datasets.