> ## Documentation Index > Fetch the complete documentation index at: https://developers.clara.team/llms.txt > Use this file to discover all available pages before exploring further. # Transactions > Retrieve and manage card transactions with filtering, labels, and attachments. Recommended for all new integrations. In version 3 of the Transactions API, Clara offers real-time access to card transactions through a paginated RESTful service. ## When does a Transactions Appear? Most transactions appear in the API almost instantly. However, some are delayed until Mastercard confirms them through the reconciliation process. This can take up to **2 business days**. Initially, you'll see a **pre-authorization**, which becomes **authorized** after confirmation.
## Transaction Types * **PURCHASE:** A cardholder buys a product/service. * **REFUND:** A merchant reimburses the cardholder usually due to a product return or an error in processing the purchase. * **FEE:** Additional charges from services or admin costs. * **CREDIT:** Clara adds balance to the account (e.g., refund, adjustments, rewards). * **PAYMENT:** Outgoing payment, like a credit card bill, a debt, or any other financial obligation
## Transaction Lifecycle Transactions can have different statuses, which may change throughout the transaction cycle. * **NOTIFICATION (ON):** Initial transaction record. * **PRE\_AUTHORIZED (AU):** Issuer confirms funds and card validity. * **AUTHORIZED (OP):** Reconciled and finalized. * **REJECTED (RJ):** Failed or canceled transaction. * **SYSTEM\_TRANSACTION (EC):** Special status for FEE, PAYMENT, or CREDIT.
## Pagination Details Each page shows up to 100 transactions, with support for filters and sorting to tailor responses. ```curl cURL theme={null} curl -X GET "https://public-api.mx.clara.com/api/v3/transaction?size=1" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ```
```curl JSON theme={null} { "transactionUuid": "47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1", "invoices": [ { "invoiceId": "54cd6b23-5146-437f-b133-879c432e6776", "invoiceNumber": null, "taxRegime": "621", "issuer": { "rfc": "CLARA123XML", "businessName": "CLARA" }, "taxReceipts": { "cfdi": "G03", "paymentMethod": "Q4" }, "tax": { "retained": { "isr": 0.75, "iva": null, "ieps": null }, "transferred": { "iva": 0.0, "ieps": 0.0 } }, "amount": { "total": 400.00, "subTotal": 300.00, "currency": "MXN" }, "documentDate": "2024-10-01", "xmlStatus": "Vigente", "xmlCode": "S – Comprobante obtenido satisfactoriamente." } ] } ``` ## How to Retrieve Attachments As a platform, Clara provides its clients with the ability to attach files to transactions, such as receipts, invoices, or other relevant information that can assist in their reconciliation process. To facilitate this, we provide download links for these attachments. If a transaction has attachments: * The `hasAttachments` field is set to `true` * You'll receive a\*\* link to download them\*\* * URLs are valid for **12 hours** Format: `.../v3/transactions/{uuid}/documents` In the following example, we will get the URLs for the transaction with the UUID "47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1" in Mexico. ```curl cURL theme={null} curl -X GET "https://public-api.mx.clara.com/api/v3/transactions/47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1/documents" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ```
```curl JSON theme={null} { "transactionUuid": "47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1", "attachments": [ { "uuid": "18589896-d30e-4cca-a4e6-716ba323b937", "fileName": "receipt.jpg", "updateAt": "2024-12-09T01:35:26.426484Z", "format": "jpeg", "download": { "urlExpiration": "2024-12-14T07:40:15.144358891Z", "url": "https://company-9fefb4f5-491d-4028-8c4d-f7b20ff98e29.s3.amazonaws.com/user_docs/1dbf684e-4cdd-467d-b240-3e8e45d63887/51/5465258?response-content-disposition=attachment%3B%20filename%3D%22oneOoneHuixquilucan_241208193512.jpg%22&response-content-type=jpeg&X-Amz-Security-Token=FwoGZXIvYXdzEDUaDJAr429nJB6KRbni%2FiKwAbLEsGgPIsSE8kV0DdR905%2FXd4wYq9zQ2P99MHz06fykkTuaylb7xbpkANXyqQpTJw2M23Q%2FabFuakuazkVDPCQ%2BHwDM3LmJ%2BqWhng87m1q6p6JlacCyMqlQbVtpwYFcts1hMjSXASha79Cs%2FLm9onR2txbq6rTn5%2BW0vtKFk%2FyD7x%2FhGhfmMuZyUgD37dp7FSzUo0Z4ZjLhHjrc6tt%2F2f2C15sN1ps9tCtoyyCiKJ2b8roGMi0W6DxWRVjX7xCGyIT07lfVCMnw9v1MsbpscZ5%2BORVmaTq9CfU3kezypy%2B0M%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20241213T194014Z&X-Amz-SignedHeaders=host&X-Amz-Expires=43199&X-Amz-Credential=ASIASUFA8KD3C1GJLWK%2F20241213%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=3038ebf880b3cd0a0e8b24a0440f047e52ec1f4c1b88f210c637928747a688cc" } } ] } ``` ## Invoice Info (Mexico Only) Clara also provides a space to upload invoice XML files, available only in Mexico. If a transaction has invoice: * The `hasInvoice` field is set to `true` * You'll receive a **link to download them** * URLs are valid for **12 hours** Format: `.../v3/transactions/{uuid}/invoices` In the following example, we will get the invoice information for the transaction with the UUID "47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1" in Mexico. ```curl cURL theme={null} curl -X GET "https://public-api.mx.clara.com/api/v3/transactions/47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1/invoices" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ```
```curl JSON theme={null} { "transactionUuid": "47f8ed9e-4d7b-450b-ad6a-f1d83e3ce4e1", "invoices": [ { "invoiceId": "54cd6b23-5146-437f-b133-879c432e6776", "invoiceNumber": null, "taxRegime": "621", "issuer": { "rfc": "CLARA123XML", "businessName": "CLARA" }, "taxReceipts": { "cfdi": "G03", "paymentMethod": "Q4" }, "tax": { "retained": { "isr": 0.75, "iva": null, "ieps": null }, "transferred": { "iva": 0.0, "ieps": 0.0 } }, "amount": { "total": 400.00, "subTotal": 300.00, "currency": "MXN" }, "documentDate": "2024-10-01", "xmlStatus": "Vigente", "xmlCode": "S – Comprobante obtenido satisfactoriamente." } ] } ```
Note: The examples provided do not contain real data, and they do not reflect actual calculations for fees, taxes, or any other financial details. ## How to Retrieve Extracted Documents Use `GET /api/v3/transactions/{uuid}/extracted-documents` to get structured, validated documents like XML invoices or receipts. ## Authentication: * Use MTLS for secure two-way certificate validation. * Include a valid OAuth2 token, via the `/oauth/token` endpoint. * Include the Bearer token in the `Authorization` header of your request. ## Endpoint: ```curl Text theme={null} GET "/api/v3/transactions/{uuid}/extracted-documents" ``` Base URL examples: * `https://public-api.mx.clara.com` * `https://public-api.br.clara.com` * `https://public-api.co.clara.com` ## Path Parameter: | Name | | Type | Required | Description | | ---- | :- | ------ | -------- | ----------------------- | | uuid | | string | ✅ Yes | UUID of the transaction | ## Query Parameters: | Name | Type | Description | | ---------------- | ------- | -------------------------------------------------------------------------------------- | | page | integer | Page index, zero-based. Default: 0 | | size | integer | Items per page. Default: 20 | | uuid | uuid | Filter by extracted document UUID | | type | enum | Filter by document type: `MEXICAN_FISCAL_INVOICE`, `INVOICE`, `RECEIPT`, `OTHER` | | validationStatus | enum | Filter by validation status: `VALIDATED_BY_CLARA`, `VALIDATED_BY_USER`, `NOT_VERIFIED` | ## Response: Returns a paginated list of extracted documents associated with the transaction. Each document includes metadata and content such as: ```curl JSON theme={null} { "uuid": "123e4567-e89b-12d3-a456-426614174000", "type": "INVOICE", "userUuid": "cd22be0b-c074-41d3-8645-77e1507c8562", "data": { "folioFiscalUuid": "123e4567-e89b-12d3-a456-426614174000", "invoiceId": "INV-2023-001", "receiptDate": "2023-10-15", "issueDate": "2023-10-15", "billingDate": "2023-10-31", "country": "MX", "issuer": { "legalName": "ACME Corporation", "taxIdentifier": "ABC123456XYZ" }, "items": [ { "name": "Office Chair", "unitPrice": 149.99, "quantity": 2, "total": 299.98 } ], "itemsDescription": "Office supplies", "amount": { "currency": "USD", "subTotal": 100.0, "taxesAmount": 16.0, "tipAmount": 10.0, "total": 126.0, "taxPercentage": 16.0, "tipPercentage": 10.0 } }, "fileValidation": { "status": "VALIDATED_BY_CLARA", "date": "2023-10-15T14:30:00", "user": "John Doe", "userUuid": "123e4567-e89b-12d3-a456-426614174000" } } ``` ## Validation Status Details | Status | Description | | -------------------- | ------------------------------------ | | VALIDATED\_BY\_CLARA | Automatically validated successfully | | VALIDATED\_BY\_USER | Validated manually by a user | | NOT\_VERIFIED | Document could not be validated | ## Successful Response | Status | Meaning | | ------ | ----------------------------------------- | | 200 | OK - List of extracted documents returned | ## Error Responses | Status | Meaning | | ------ | ------------ | | 400 | Bad Request | | 401 | Unauthorized | | 403 | Forbidden | *** ## Example cURL Request ```bash theme={null} curl --location --request GET 'https://public-api.mx.clara.com/api/v3/transactions/{uuid}/extracted-documents' \ --header 'Authorization: Bearer {your_access_token}' \ --cert {client_cert_path} \ --key {client_key_path} ``` Replace `{uuid}`, `{your_access_token}`, `{client_cert_path}`, and `{client_key_path}` with actual values. ## Summary This endpoint enables retrieval of structured, validated financial documents (invoices, receipts, etc.) tied to a transaction. It supports robust filtering and pagination, and enforces secure access through MTLS and OAuth2. *** ## Endpoint Reference ### `GET /api/v3/transactions` List all transactions (v3) **Parameters:** | Parameter | In | Type | Required | Description | | -------------------------- | ----- | ------------- | -------- | ----------------------------------------- | | `page` | query | integer | | Page index, zero-based. Default: `0` | | `size` | query | integer | | Items per page. Default: `20`, max: `100` | | `lastUpdateDateRangeStart` | query | string (date) | | Filter by last update date start | | `lastUpdateDateRangeEnd` | query | string (date) | | Filter by last update date end | | `operationDateRangeStart` | query | string (date) | | Filter by operation date start | | `operationDateRangeEnd` | query | string (date) | | Filter by operation date end | | `accountingDateRangeStart` | query | string (date) | | Filter by accounting date start | | `accountingDateRangeEnd` | query | string (date) | | Filter by accounting date end | | `userUuid` | query | string (uuid) | | Filter by user UUID | | `cardUuid` | query | string (uuid) | | Filter by card UUID | | `cardLastDigits` | query | string | | Filter by last 4 digits of card | | `userErpId` | query | string | | Filter by user ERP ID | | `status` | query | string | | Filter by transaction status | | `operationTypeCode` | query | string | | Filter by operation type code | **Response Schema (`TransactionPageV3`):** | Field | Type | Example | | --------------- | ------------------------------ | ------- | | `content` | array of TransactionResponseV3 | | | `totalElements` | integer | `150` | | `totalPages` | integer | `8` | | `size` | integer | `20` | | `number` | integer | `0` | ### `GET /api/v3/transactions/{uuid}` Get transaction by UUID (v3) **Parameters:** | Parameter | In | Type | Required | Description | | --------- | ---- | ------------- | -------- | ----------- | | `uuid` | path | string (uuid) | ✅ | | **Response Schema (`TransactionResponseV3`):** | Field | Type | Example | | ----------------------- | --------------------------------------- | -------------------------------------- | | `uuid` | string (uuid) | `4ea5a94a-2c3c-4601-b623-c30260c21dbc` | | `type` | string | `PURCHASE` | | `transactionLabel` | string | `OPENAI SUBSCR` | | `labels` | array of TransactionLabel | | | `status` | string | `AUTHORIZED` | | `comment` | string | `Tool to improve` | | `billingStatement` | object (BillingStatementTransactionRef) | | | `accountingFields` | array of AccountingFields | | | `audit` | object (Audit) | | | `merchant` | object (Merchant) | | | `card` | object (TransactionCard) | | | `user` | object (TransactionUser) | | | `authorizationNumber` | string | `001921` | | `originalAmount` | object (CurrencyAmount) | | | `amountValue` | object (CurrencyAmount) | | | `validationStatus` | object (ValidationStatus) | | | `hasInvoice` | object (Has) | | | `hasAttachments` | object (Has) | | | `hasExtractedDocuments` | object (Has) | | | `installment` | string | `None` | | `installmentNumber` | string | `None` | | `bankConcept` | object (BankConcept) | | | `links` | array of Link | | ### `POST /api/v3/transactions/{uuid}/comment` Add a comment to a transaction. **Parameters:** | Parameter | In | Type | Required | Description | | --------- | ---- | ------------- | -------- | ----------- | | `uuid` | path | string (uuid) | ✅ | | **Request Body:** | Field | Type | Required | Description | | --------- | ------ | -------- | ------------ | | `comment` | string | ✅ | Comment text | **Response (`201`):** ```json theme={null} { "comment": "Expense approved by finance", "transactionsUuids": ["8108ed5a-3de7-479e-8431-b5824db5044d"] } ``` ### `DELETE /api/v3/transactions/{uuid}/comment` Remove the comment from a transaction. Returns `204 No Content`. **Parameters:** | Parameter | In | Type | Required | Description | | --------- | ---- | ------------- | -------- | ----------- | | `uuid` | path | string (uuid) | ✅ | | ### `GET /api/v3/transactions/{uuid}/invoices` Get transaction invoices (Mexico fiscal) **Parameters:** | Parameter | In | Type | Required | Description | | --------- | ---- | ------------- | -------- | ----------- | | `uuid` | path | string (uuid) | ✅ | | **Response Schema (`TransactionInvoiceResponse`):** | Field | Type | Example | | --------------- | ------------------ | ------- | | `content` | array of InvoiceV3 | | | `totalElements` | integer | | | `totalPages` | integer | | | `size` | integer | | | `number` | integer | | ### `POST /api/v3/transactions/comments/bulk` Bulk add comments to multiple transactions in a single request. **Request Body:** | Field | Type | Description | | -------------- | ----- | ----------------------------------------------------------------------- | | `transactions` | array | Each item must include `uuid` (transaction UUID) and `comment` (string) | **Example:** ```json theme={null} { "transactions": [ { "uuid": "4ea5a94a-2c3c-4601-b623-c30260c21dbc", "comment": "Approved" }, { "uuid": "8108ed5a-3de7-479e-8431-b5824db5044d", "comment": "Pending review" } ] } ``` ### `POST /api/v3/transactions/labels/bulk` Bulk bind labels to multiple transactions in a single request. **Request Body:** | Field | Type | Description | | -------------- | ----- | ---------------------------------------------------------------------------------------- | | `transactions` | array | Each item must include `uuid` (transaction UUID) and `labelsUuid` (array of label UUIDs) | **Example:** ```json theme={null} { "transactions": [ { "uuid": "4ea5a94a-2c3c-4601-b623-c30260c21dbc", "labelsUuid": ["0169fe8b-b5e1-46f0-895d-a79d2753fee1"] } ] } ``` ### `GET /api/v3/transactions/{uuid}/documents` Get transaction documents (v3) **Parameters:** | Parameter | In | Type | Required | Description | | --------- | ---- | ------------- | -------- | ----------- | | `uuid` | path | string (uuid) | ✅ | | **Response Schema (`AttachmentDocuments`):** | Field | Type | Example | | ------------- | ----------------------- | ------- | | `uuid` | string (uuid) | | | `attachments` | array of AttachmentItem | | ### `GET /api/v3/transactions/{uuid}/extracted-documents` Get extracted documents for transaction (v3) **Parameters:** | Parameter | In | Type | Required | Description | | ------------------ | ----- | ------------------------------------------------------------- | -------- | --------------------------- | | `uuid` | path | string (uuid) | ✅ | | | `documentUuid` | query | string (uuid) | | Filter by document UUID | | `type` | query | string | | Filter by document type | | `validationStatus` | query | enum: `VALIDATED_BY_CLARA`/`VALIDATED_BY_USER`/`NOT_VERIFIED` | | Filter by validation status | **Response Schema (`ExtractedDocumentPage`):** | Field | Type | Example | | --------------- | -------------------------- | ------- | | `content` | array of ExtractedDocument | | | `totalElements` | integer | | | `totalPages` | integer | | | `size` | integer | | | `number` | integer | | ## What is the Transactions API? The **Transactions API (v2)** allows you to programmatically access expense data made with Clara cards. This includes both **physical** and **virtual card transactions**, with detailed metadata such as amount, currency, merchant, category, and status. You can use this API to: * Build automated reporting dashboards * Analyze spend by user, team, or category * Monitor transaction activity in near real-time
## Available Endpoints | Operation | Endpoint | Method | | ------------------------- | ------------------------- | ------ | | Retrieve all transactions | `/v2/transactions` | GET | | Get transaction by UUID | `/v2/transactions/{uuid}` | GET |
## Retrieve all transactions Fetch a list of all transactions for your company. You can apply optional filters such as `status`, `userUuid`, or `date range`. ### Endpoint `GET /v2/transactions` ### cURL Request ```curl cURL theme={null} curl -X GET \ "https://public-api.mx.clara.com/api/v2/transactions" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ``` 💡 You can add filters as query parameters, for example: `/v2/transactions?status=APPROVED&userUuid=abc-123` ### Sample JSON Response ```json JSON theme={null} [ { "uuid": "txn-123", "amount": 580.00, "currency": "MXN", "status": "APPROVED", "merchant": "Amazon", "userUuid": "user-456", "category": "Office Supplies", "createdAt": "2024-06-10T15:30:00Z" }, { "uuid": "txn-124", "amount": 1200.00, "currency": "MXN", "status": "PENDING", "merchant": "Uber", "userUuid": "user-789", "category": "Transportation", "createdAt": "2024-06-11T09:00:00Z" } ] ```
## Retrieve Transaction by UUID Fetch full details for a single transaction using its unique identifier. ### Endpoint `GET /v2/transactions/{uuid}` ### cURL Request ```curl cURL theme={null} curl -X GET \ "https://public-api.mx.clara.com/api/v2/transactions/txn-123" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ``` ### Sample JSON Response ```json JSON theme={null} { "uuid": "txn-123", "amount": 580.00, "currency": "MXN", "status": "APPROVED", "merchant": "Amazon", "category": "Office Supplies", "description": "Team supplies", "user": { "uuid": "user-456", "fullName": "Ana Gómez" }, "card": { "uuid": "card-789", "lastFour": "4321", "type": "virtual" }, "createdAt": "2024-06-10T15:30:00Z" } ```
\*\*💡 Tip: \*\* Use the transaction status field to filter transactions by lifecycle stage (e.g. PENDING, APPROVED, DECLINED, etc.). **⚠️ Note:** Some fields like description, category, or user may be updated after the transaction is first created, depending on reconciliation and review processes. *** ## Endpoint Reference ### `GET /api/v2/transactions` List all transactions (v2) **Parameters:** | Parameter | In | Type | Required | Description | | -------------------------- | ----- | ------------- | -------- | -------------------------------- | | `lastUpdateDateRangeStart` | query | string (date) | | Filter by last update date start | | `lastUpdateDateRangeEnd` | query | string (date) | | Filter by last update date end | | `operationDateRangeStart` | query | string (date) | | Filter by operation date start | | `operationDateRangeEnd` | query | string (date) | | Filter by operation date end | | `accountingDateRangeStart` | query | string (date) | | Filter by accounting date start | | `accountingDateRangeEnd` | query | string (date) | | Filter by accounting date end | | `userUuid` | query | string (uuid) | | Filter by user UUID | | `cardUuid` | query | string (uuid) | | Filter by card UUID | | `cardLastDigits` | query | string | | Filter by last 4 digits of card | | `userErpId` | query | string | | Filter by user ERP ID | | `status` | query | string | | Filter by transaction status | | `operationTypeCode` | query | string | | Filter by operation type code | **Response Schema (`TransactionPageV3`):** | Field | Type | Example | | --------------- | ------------------------------ | ------- | | `content` | array of TransactionResponseV3 | | | `totalElements` | integer | `150` | | `totalPages` | integer | `8` | | `size` | integer | `20` | | `number` | integer | `0` | ### `GET /api/v2/transactions/{uuid}` Get transaction by UUID (v2) **Parameters:** | Parameter | In | Type | Required | Description | | --------- | ---- | ------------- | -------- | ----------- | | `uuid` | path | string (uuid) | ✅ | | **Response Schema (`TransactionResponseV3`):** | Field | Type | Example | | ----------------------- | --------------------------------------- | -------------------------------------- | | `uuid` | string (uuid) | `4ea5a94a-2c3c-4601-b623-c30260c21dbc` | | `type` | string | `PURCHASE` | | `transactionLabel` | string | `OPENAI SUBSCR` | | `labels` | array of TransactionLabel | | | `status` | object (TransactionStatus) | | | `comment` | string | `Tool to improve` | | `billingStatement` | object (BillingStatementTransactionRef) | | | `accountingFields` | array of AccountingFields | | | `audit` | object (Audit) | | | `merchant` | object (Merchant) | | | `card` | object (TransactionCard) | | | `user` | object (TransactionUser) | | | `authorizationNumber` | string | `001921` | | `originalAmount` | object (CurrencyAmount) | | | `amountValue` | object (CurrencyAmount) | | | `validationStatus` | object (ValidationStatus) | | | `hasInvoice` | object (Has) | | | `hasAttachments` | object (Has) | | | `hasExtractedDocuments` | object (Has) | | | `installment` | string | `None` | | `installmentNumber` | string | `None` | | `bankConcept` | object (BankConcept) | | v1 is legacy and read-only. Migrate to v3 for full transaction access. ## 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 |
## 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 theme={null} curl -X GET \ "https://public-api.mx.clara.com/api/v1/transactions" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ``` ### Sample JSON Response ```json JSON theme={null} [ [ { "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" } ] ```
## 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 theme={null} curl -X GET \ "https://public-api.mx.clara.com/api/v1/transactions/txn-001" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ``` ### Sample JSON Response ```json JSON theme={null} { "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. *** ## Endpoint Reference ### `GET /api/v1/transactions` Find all transactions **Parameters:** | Parameter | In | Type | Required | Description | | ----------------------------- | ----- | -------------------------------------------------- | -------- | --------------------------------------------------------------------------------------- | | `page` | query | integer | | Zero-based page index (0..N) | | `size` | query | integer | | The size of the page to be returned | | `operationDateRangeStart` | query | string | | Operation start date | | `operationDateRangeEnd` | query | string | | Operation max date | | `accountingDateRangeStart` | query | string | | Accounting start date | | `accountingDateRangeEnd` | query | string | | Accounting max date | | `userUuid` | query | string | | UUID of the user associated with the transactions | | `cardUuid` | query | string | | UUID of the card associated with the transactions | | `merchantCategoryDescription` | query | string | | Merchant category of the transactions | | `operationTypeCode` | query | enum: `PURCHASE`/`REFUND`/`FEE`/`CREDIT`/`PAYMENT` | | Operation status. Values include 'AU' for Pending and 'OP' for Authorized transactions. | ### `GET /api/v1/transactions/{uuid}` Find transaction by UUID **Parameters:** | Parameter | In | Type | Required | Description | | --------- | ---- | ------ | -------- | ---------------- | | `uuid` | path | string | ✅ | Transaction UUID |