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

# List account journal entries

> Retrieve an array of journal entries on a credit account.

GET/credit/accounts/\{account\_token}/journalentries

Retrieve an array of journal entries on a credit account.

This endpoint supports [sorting and pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md) and [object expansion](https://www.marqeta.com/docs/core-api/object-expansion.md).

## URL path parameters

| Fields | Description |
| - | - |
| account\_token string  Required | The unique identifier of the credit account for which you want to retrieve journal entries. Send a `GET` request to `/credit/accounts` to retrieve existing credit account tokens. **Allowable Values:**  Existing account token |

## URL query parameters

| Fields | Description |
| - | - |
| count integer  Optional | The number of resources to retrieve. **Allowable Values:**  1–100 |
| start\_index integer  Optional | Sort order index of the first resource in the returned array. **Allowable Values:**  0 min |
| start\_date string  Optional | The starting date of the date range from which to return journal entries. **Allowable Values:**  Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| end\_date string  Optional | The ending date of the date range from which to return journal entries. **Allowable Values:**  Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ssZ |
| statuses array of strings  Optional | An array of statuses by which to filter journal entries. **Allowable Values:**  `POSTED`, `PENDING` |
| groups array of strings  Optional | An array of groups by which to filter journal entries. To return all journal entry groups, do not include this query parameter. **Allowable Values:**  `PURCHASE`, `ORIGINAL_CREDIT`, `FEE`, `BALANCE_REFUND`, `PAYMENT`, `INTEREST`, `DISPUTE`, `REFUND`, `ADJUSTMENT`, `REWARD` |
| expand string  Optional | Embeds the specified object into the response. **Allowable Values:**  `detailObject` |
| sort\_by string  Optional | Field on which to sort. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. **NOTE:** You must sort using system field names such as `createdTime`, and not by the field names appearing in response bodies such as `created_time`. **Allowable Values:**  `createdTime`, `-createdTime`, `impactTime`, `-impactTime` |
| card\_tokens array of strings  Optional | An array of card tokens by which to filter journal entries. Returns journal entries associated with the specified card tokens. Send a `GET` request to `/credit/accounts/{account_token}/cards/` to retrieve existing card tokens. **Allowable Values:**  Existing card token |
| user\_tokens array of strings  Optional | An array of user tokens by which to filter journal entries. Returns journal entries associated with the specified user tokens. Send a `GET` request to `/users` to retrieve existing user tokens. **Allowable Values:**  Existing user token |
| types array of strings  Optional | An array of [event types](https://www.marqeta.com/docs/core-api/event-types.md#_credit_journal_entry_events) by which to filter journal entries. To return all event types, do not include this query parameter. **Allowable Values:**  `authorization`, `authorization.advice`, `authorization.incremental`, `authorization.reversal`, `authorization.reversal.issuerexpiration`, `authorization.clearing`, `refund`, `refund.authorization`, `refund.authorization.advice`, `refund.authorization.reversal`, `refund.authorization.clearing`, `refund.authorization.reversal.issuerexpiration`, `originalcredit.authorization`, `originalcredit.authorization.clearing`, `originalcredit.authorization.reversal`, `originalcredit.authpluscapture`, `originalcredit.authpluscapture.reversal`, `originalcredit.authorization.reversal.issuerexpiration`, `account.balancerefund`, `account.reward.cashback`, `account.reward.auto.cashback`, `account.reward.auto.cashback.reversal`, `account.payment`, `account.payment.completed`, `account.payment.returned`, `account.payment.canceled`, `account.payment.refunded`, `account.payment.completed.hold.released`, `account.payment.completed.hold`, `account.interest`, `account.fee.payment.late`, `account.fee.payment.returned`, `account.fee.interest.minimum`, `account.dispute`, `account.dispute.reversal`, `account.dispute.won`, `account.dispute.lost`, `account.dispute.lost.graceperiod`, `account.adjustment`, `account.adjustment.purchase`, `account.adjustment.fee`, `account.adjustment.interest`, `account.adjustment.reward`, `pindebit`, `pindebit.authorization.clearing`, `pindebit.refund` |

## Response body

| Fields | Description |
| - | - |
| count integer  Returned | Number of resources returned. **Allowable Values:**  1-10 |
| start\_index integer  Returned | Sort order index of the first resource in the returned array. **Allowable Values:**  Any integer |
| end\_index integer  Returned | Sort order index of the last resource in the returned array. **Allowable Values:**  Any integer |
| is\_more boolean  Returned | A value of `true` indicates that more unreturned resources exist. **Allowable Values:**  `true`, `false` |
| data array of objects  Returned | Contains one or more journal entries on a credit account. **Allowable Values:**  One or more journal entry objects |
| data\[].**token** string  Returned | Unique identifier of the journal entry. **Allowable Values:**  36 char max |
| data\[].**related\_token** string  Conditionally returned | Unique identifier of the original journal entry. If the current journal entry is the original, this field is returned empty. **Allowable Values:**  Existing journal entry token |
| data\[].**root\_token** string  Conditionally returned | Unique identifier of the root journal entry. If the current journal entry is the root, this field is returned empty. **Allowable Values:**  Existing journal entry token |
| data\[].**account\_token** string  Returned | Unique identifier of the credit account associated with the credit card used to make the journal entry. **Allowable Values:**  Existing account token |
| data\[].**card\_token** string  Returned | Unique identifier of the credit card used to make the journal entry. **Allowable Values:**  8–36 chars  Existing credit card token |
| data\[].**user\_token** string  Returned | Unique identifier of the credit user. **Allowable Values:**  Existing user token |
| data\[].**status** string  Returned | Status of the journal entry when it was initially recorded and had an impact on the balance, either `PENDING` or `POSTED`. This field is immutable and may not represent the current status. To view the current status of purchases, refunds, OCTs, and payments, see the `detail_object.state` field. These journal entries start in `PENDING` and can transition to `CLEARED`, `DECLINED`, or `ERROR`. This transition of status is only sent through webhook event notifications. Journal entries that are final transactions, such as clearings, start and remain in a `POSTED` state. **NOTE**: `CLEARED`, `DECLINED`, and `ERROR` are special statuses that do not have an impact on the account balance, and are not recorded in the journal. For these special statuses, `impact_time`, `request_time`, `created_time`, `token`, and `id` are returned blank. **Allowable Values:**  `PENDING`, `POSTED`, `DECLINED`, `ERROR`, `CLEARED` |
| data\[].**group** string  Returned | Group to which the journal entry belongs. **Allowable Values:**  `PURCHASE`, `REFUND`, `DISPUTE`, `ORIGINAL_CREDIT`, `FEE`, `REWARD`, `INTEREST`, `PAYMENT`, `ADJUSTMENT`, `BALANCE_TRANSFER`, `CASH_ADVANCE`, `BALANCE_REFUND` |
| data\[].**type** string  Returned | The journal entry event type. **Allowable Values:**  Example: `authorization.clearing`  A valid [journal entry event type](https://www.marqeta.com/docs/core-api/event-types.md#_credit_journal_entry_events) |
| data\[].**id** string  Returned | Eight-digit numeric identifier of the journal entry, an alternate identifier to the UUID that is useful for remembering and referencing. **Allowable Values:**  8 chars |
| data\[].**amount** decimal  Returned | Amount of the journal entry. **Allowable Values:**  Format: 0.00 |
| data\[].**currency\_code** string  Returned | A valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) **Allowable Values:**  `USD` |
| data\[].**memo** string  Returned | Merchant name or description for the journal entry. **Allowable Values:**  Example: Whole Foods Market |
| data\[].**request\_time** datetime  Returned | For purchases, the date and time of the authorization, which is when the user initiates the journal entry. For other journal entry groups, equivalent to `impact_time`. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**impact\_time** datetime  Returned | Date and time when the journal entry impacts the account balance. For purchases, this is the time of the authorization. For purchase authorization clearings, this is the time when the transaction is settled. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**created\_time** datetime  Returned | Date and time when the journal entry was created on Marqeta's credit platform, in UTC. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].**dispute\_token** string  Conditionally returned | Unique identifier of the dispute, if the journal entry is disputed. **Allowable Values:**  Existing dispute token |
| data\[].**detail\_token** string  Returned | Unique identifier of the journal entry's full details. **Allowable Values:**  36 char max |
| data\[].**detail\_object** object  Conditionally returned | Contains the journal entry's full details. The fields returned in this object vary based on the journal entry group. The following lists each journal entry group and the specific fields returned for each group. - Purchases and refunds: see the [transactions](https://www.marqeta.com/docs/core-api/transactions/list-transactions.md) response fields. - Disputes: see the [account disputes response fields.](https://www.marqeta.com/docs/core-api/credit-account-disputes/retrieve-account-dispute.md) - Original credit transaction (OCT): see the [transfer type](https://www.marqeta.com/docs/core-api/digital-banking-transfers) fields. - Rewards: see the [account reward](https://www.marqeta.com/docs/core-api/credit-account-rewards/create-account-reward.md) response fields. - Payments: see the [account payment](https://www.marqeta.com/docs/core-api/credit-account-payments/retrieve-account-payment.md) response fields. - Balance refunds: see the [balance refund](https://www.marqeta.com/docs/core-api/credit-account-balance-refunds/create-balance-refund.md) response fields. - Adjustments: see the [account adjustment](https://www.marqeta.com/docs/core-api/credit-account-adjustments/retrieve-account-adjustment.md) response fields. - Interest and fees: see fields below. **Allowable Values:**  Existing detail object |
| data\[].detail\_object.**token** string  Conditionally returned | Unique identifier of the interest charge or fee. If in the `detail_object`, unique identifier of the detail object. Returned for interest or fees. **Allowable Values:**  36 char max |
| data\[].detail\_object.**account\_token** string  Conditionally returned | Unique identifier of the credit account on which the interest or fee was charged. Returned for interest or fees. **Allowable Values:**  36 char max  Existing account token |
| data\[].detail\_object.**type** string  Conditionally returned | Type of fee. Returned for fees. **Allowable Values:**  `FOREIGN_TRANSACTION_FEE`, `OVER_LIMIT_FEE`, `LATE_PAYMENT_FEE`, `RETURNED_PAYMENT_FEE`, `CARD_REPLACEMENT_FEE`, `MINIMUM_INTEREST_FEE`, `MINIMUM_INTEREST_FEE_REVERSAL`, `ANNUAL_FEE`, `MONTHLY_FEE` |
| data\[].detail\_object.**method** string  Conditionally returned | Method used to calculate the fee value. Returned for fees. **Allowable Values:**  `PERCENTAGE`, `FLAT` |
| data\[].detail\_object.**value** decimal  Conditionally returned | Value of the fee configured on the account. Equivalent to `config.fees.schedule.value` on the credit account. Send a `GET` request to `/credit/accounts/{account_token}` to retrieve an existing credit account. Returned for fees. **Allowable Values:**  Format: 0.00 |
| data\[].detail\_object.**currency\_code** string  Conditionally returned | A valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) **Allowable Values:**  `USD` |
| data\[].detail\_object.**amount** decimal  Conditionally returned | Amount of the fee. Returned for fees. **Allowable Values:**  Format: 0.00 |
| data\[].detail\_object.**applied\_to\_amount** decimal  Conditionally returned | The total amount to which a percentage fee method is applied (for example, if a 3% fee is applied to 100, then `100` is the `applied_to_amount` value). This field is not applicable for a flat fee method. Returned for fees. **NOTE:** This field is currently not supported and returns `null`. **Allowable Values:**  Format: 0.00 |
| data\[].detail\_object.**description** string  Conditionally returned | Description of the fee. Returned for fees. **Allowable Values:**  255 char max |
| data\[].detail\_object.**created** datetime  Conditionally returned | Date and time when the fee was created. Returned for fees. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].detail\_object.**statement\_token** string  Conditionally returned | Unique identifier of the statement summary from which you want to retrieve interest details. Returned for interest. **Allowable Values:**  Existing statement summary token |
| data\[].detail\_object.**statement\_opening\_date** datetime  Conditionally returned | Opening date of the statement summary from which you want to retrieve interest details. Returned for interest. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].detail\_object.**statement\_closing\_date** datetime  Conditionally returned | Closing date of the statement summary from which you want to retrieve interest details. Returned for interest. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].detail\_object.**statement\_balance** decimal  Conditionally returned | Balance on the statement summary from which you want to retrieve interest details. Returned for interest. **Allowable Values:**  Format: 0.00 |
| data\[].detail\_object.**average\_daily\_balance** decimal  Conditionally returned | Average daily balance used to calculate interest. Returned for interest. **Allowable Values:**  Format: 0.00 |
| data\[].detail\_object.**goto\_apr** decimal  Conditionally returned | Annual percentage rate. Returned for interest. **Allowable Values:**  0–100 |
| data\[].detail\_object.**daily\_periodic\_rate** decimal  Conditionally returned | Daily rate used to calculate interest. Returned for interest. **Allowable Values:**  0–100 |
| data\[].detail\_object.**days\_in\_billing\_cycle** integer  Conditionally returned | Number of days in the billing cycle. Returned for interest. **Allowable Values:**  1–31 |
| data\[].detail\_object.**interest\_amount** decimal  Conditionally returned | Amount of interest calculated for the billing period. Returned for interest. **Allowable Values:**  Format: 0.00 |
| data\[].detail\_object.**created\_date** datetime  Conditionally returned | Date and time when the interest was created. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |
| data\[].detail\_object.**updated\_date** datetime  Conditionally returned | Date and time when the interest was last updated. **Allowable Values:**  Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "count": 2,
  "start_index": 0,
  "end_index": 4,
  "is_more": true,
  "data": [
    {
      "token": "interest_journal_entry_token1111",
      "user_token": "user_token4632",
      "account_token": "my_account_token_12",
      "card_token": "my_credit_card_token7794",
      "status": "POSTED",
      "group": "INTEREST",
      "type": "account.interest",
      "id": "11112222",
      "amount": 2.31,
      "currency_code": "USD",
      "memo": "Interest charge on purchases",
      "request_time": "2021-08-01T03:59:59Z",
      "impact_time": "2021-08-01T03:59:59Z",
      "created_time": "2021-08-01T07:00:19Z",
      "detail_token": "detail_token_96749",
      "detail_object": {
        "token": "detail_token_96749",
        "account_token": "my_account_token_12",
        "statement_token": "statement_token_75b",
        "statement_opening_date": "2021-07-01T04:00:00Z",
        "statement_closing_date": "2021-08-01T03:59:59Z",
        "statement_balance": 208.93,
        "average_daily_balance": 181.67,
        "goto_apr": 14.99,
        "daily_periodic_rate": 0.00041068,
        "days_in_billing_cycle": 31,
        "interest_amount": 2.31,
        "currency_code": "USD",
        "created_date": "2021-08-01T07:00:19Z",
        "updated_date": "2021-08-01T07:00:19Z"
      }
    },
    {
      "token": "fee_journal_entry_token2121",
      "user_token": "user_token4632",
      "account_token": "my_account_token_12",
      "card_token": "my_credit_card_token7794",
      "status": "POSTED",
      "group": "FEE",
      "type": "account.fee.payment.late",
      "id": "44445678",
      "amount": 15,
      "currency_code": "USD",
      "memo": "Late payment fee",
      "request_time": "2021-07-01T03:59:59Z",
      "impact_time": "2021-07-01T03:59:59Z",
      "created_time": "2021-07-01T07:00:24Z",
      "detail_token": "detail_token_11221",
      "detail_object": {
        "token": "detail_token_11221",
        "account_token": "my_account_token_12",
        "type": "LATE_PAYMENT_FEE",
        "method": "FLAT",
        "value": 25,
        "currency_code": "USD",
        "amount": 15,
        "description": "Late Payment Fee",
        "created": "2021-07-01T07:00:24Z"
      }
    },
    {
      "token": "purchase_journal_entry_token6789",
      "user_token": "user_token4632",
      "related_token": "journal_entry_token2460",
      "root_token": "journal_entry_token2460",
      "account_token": "my_account_token_12",
      "card_token": "my_credit_card_token7794",
      "status": "POSTED",
      "group": "PURCHASE",
      "type": "authorization.clearing",
      "id": "12345678",
      "amount": 9.11,
      "currency_code": "USD",
      "memo": "SWEET TREATS 0484",
      "request_time": "2021-09-25T20:59:43Z",
      "impact_time": "2021-09-26T11:53:48Z",
      "created_time": "2021-09-26T11:53:48Z",
      "detail_token": "detail_token_645736",
      "detail_object": {
        "type": "authorization.clearing",
        "state": "COMPLETION",
        "identifier": 6457,
        "token": "detail_token_645736",
        "user_token": "user_token4632",
        "acting_user_token": "user_token4632",
        "card_token": "my_credit_card_token7794",
        "preceding_related_transaction_token": "journal_entry_token2460",
        "gpa": {
          "currency_code": "USD",
          "ledger_balance": 61.7,
          "available_balance": 0,
          "credit_balance": 0,
          "pending_credits": 0,
          "impacted_amount": -9.11,
          "balances": {
            "USD": {
              "currency_code": "USD",
              "ledger_balance": 61.7,
              "available_balance": 0,
              "credit_balance": 0,
              "pending_credits": 0,
              "impacted_amount": -9.11
            }
          }
        },
        "gpa_order": {
          "token": "gpa_order_token2c2c5",
          "amount": 9.11,
          "created_time": "2021-09-25T20:59:43Z",
          "last_modified_time": "2021-09-26T11:53:47Z",
          "transaction_token": "transaction_token42352a",
          "state": "COMPLETION",
          "response": {
            "code": 0,
            "memo": "Approved or completed successfully"
          },
          "funding": {
            "amount": 9.11,
            "source": {
              "type": "programgateway",
              "token": "funding_source_token6789",
              "active": true,
              "name": "My Funding Source",
              "is_default_account": false,
              "created_time": "2021-06-22T18:41:14Z",
              "last_modified_time": "2021-06-22T18:41:14Z"
            }
          },
          "funding_source_token": "funding_source_token6789",
          "jit_funding": {
            "token": "jit_funding_token43a3",
            "method": "pgfs.authorization.capture",
            "user_token": "user_token4632",
            "acting_user_token": "user_token4632",
            "amount": 9.11,
            "original_jit_funding_token": "jit_funding_token4be7"
          },
          "user_token": "user_token4632",
          "currency_code": "USD"
        },
        "duration": 378,
        "created_time": "2021-09-26T11:53:46Z",
        "user_transaction_time": "2021-09-25T20:59:43Z",
        "settlement_date": "2021-09-26T00:00:00Z",
        "request_amount": 9.11,
        "amount": 9.11,
        "currency_conversion": {
          "network": {
            "original_amount": 9.11,
            "conversion_rate": 1,
            "original_currency_code": 840
          }
        },
        "issuer_interchange_amount": 0.19131,
        "currency_code": "USD",
        "approval_code": 946791,
        "response": {
          "code": 0,
          "memo": "Approved or completed successfully"
        },
        "network": "VISA",
        "subnetwork": "VISANET",
        "acquirer_fee_amount": 0,
        "acquirer": {
          "system_trace_audit_number": 0
        },
        "fees": {
          "type": "INTERCHANGE_FEE",
          "amount": 0.19131,
          "credit_debit": "C"
        },
        "user": {
          "metadata": {
            "notification_email": "hello@myemail.com"
          }
        },
        "card": {
          "last_four": 4489,
          "metadata": {}
        },
        "issuer_received_time": "2021-09-26T11:53:46Z",
        "issuer_payment_node": "042f97a3458b59e3cce0269f66e864d8",
        "network_reference_id": "000218552461989029",
        "clearing_record_sequence_number": 0,
        "batch_number": 2021048291031352,
        "acquirer_reference_data": 4.355106395860054e+22,
        "card_acceptor": {
          "mid": "000555600244811",
          "mcc": 5814,
          "name": "SWEET TREATS 0484",
          "city": "OAKLAND",
          "state": "CA",
          "postal_code": 94612,
          "country_code": "US"
        },
        "pos": {
          "terminal_id": 65,
          "pin_present": false,
          "partial_approval_capable": false,
          "purchase_amount_only": false,
          "is_recurring": false,
          "is_installment": false
        },
        "transaction_metadata": {
          "payment_channel": "OTHER"
        },
        "network_metadata": {
          "product_id": "VISA_TRADITIONAL",
          "program_id": ""
        }
      }
    }
  ]
}
```


## Related topics

- [Journal Entries Overview](https://www.marqeta.com/docs/core-api/credit-account-journal-entries.md)
- [2022 Release Notes](https://www.marqeta.com/docs/developer-guides/release-notes-2022.md)
- [List account statement journal entries](https://www.marqeta.com/docs/core-api/credit-account-statements/list-journal-entries.md)
- [List account statement ledger entries](https://www.marqeta.com/docs/core-api/credit-account-statements/list-ledger-entries.md)
- [Retrieve account journal entry](https://www.marqeta.com/docs/core-api/credit-account-journal-entries/retrieve-account-journal-entry.md)
