> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transaction Fields

> Transaction fields for the MDX On Demand API.

## Transaction Fields

> For compatibility, the MDX Real Time API accepts ISO 8601 dates with timestamps, but timestamp information is ignored.\
> The MDX On Demand API does not accept timestamps on ISO 8601 dates.

| Field Name               | Data Type | Description                                                                               |
| ------------------------ | --------- | ----------------------------------------------------------------------------------------- |
| `account_guid`           | `String`  | Unique identifier for the account this transaction belongs to. Defined by MX.             |
| `account_id`             | `String`  | Partner-defined unique identifier for the account.                                        |
| `amount`                 | `Decimal` | Unsigned transaction amount. Type determines effect on account. Max Length 10,2.          |
| `category_guid`          | `String`  | Unique identifier for transaction category. Defined by MX. Matches Nexus API.             |
| `category_name`          | `String`  | Human-readable category name. May be null.                                                |
| `category`               | `String`  | Enumerated category value. If invalid or missing, MX auto-categorizes.                    |
| `check_image`            | `String`  | Base64 data URI for check image (png/jpg/jpeg).                                           |
| `check_number`           | `String`  | Check number.                                                                             |
| `currency_code`          | `String`  | ISO 4217 three-character currency code.                                                   |
| `description`            | `String`  | Human-readable transaction description. Max length 1024.                                  |
| `guid`                   | `String`  | Unique identifier for the transaction. Defined by MX.                                     |
| `id`                     | `String`  | Partner-defined unique transaction identifier. Cannot start with `TRN-`. Max Length 1024. |
| `is_international`       | `Boolean` | Indicates whether transaction is international.                                           |
| `latitude`               | `Decimal` | Latitude of transaction location (signed decimal).                                        |
| `localized_description`  | `String`  | Local-language transaction description.                                                   |
| `localized_memo`         | `String`  | Local-language memo.                                                                      |
| `longitude`              | `Decimal` | Longitude of transaction location (signed decimal).                                       |
| `member_guid`            | `String`  | Unique identifier for member. Defined by MX.                                              |
| `member_id`              | `String`  | Partner-defined member identifier.                                                        |
| `memo`                   | `String`  | Additional transaction notes. Max length 1024.                                            |
| `merchant_category_code` | `String`  | Merchant category code.                                                                   |
| `merchant_guid`          | `String`  | Unique merchant identifier. Defined by MX.                                                |
| `merchant_location_guid` | `String`  | Unique merchant location identifier. Defined by MX.                                       |
| `metadata`               | `String`  | Partner-defined metadata for the transaction.                                             |
| `posted_at`              | `Integer` | Date/time transaction was posted (Unix epoch UTC). Required if POSTED.                    |
| `posted_on`              | `String`  | Posted date. Required if POSTED when `posted_at` not used.                                |
| `running_balance`        | `Decimal` | Account balance after transaction (POSTED only).                                          |
| `status`                 | `String`  | Transaction status: `PENDING` or `POSTED`.                                                |
| `transacted_at`          | `Integer` | Date/time transaction occurred (Unix epoch UTC).                                          |
| `transacted_on`          | `String`  | Date transaction occurred.                                                                |
| `type`                   | `String`  | Transaction type: `DEBIT` or `CREDIT`.                                                    |
| `user_guid`              | `String`  | Unique user identifier. Defined by MX.                                                    |
| `user_id`                | `String`  | Partner-defined user identifier.                                                          |