# Filtering bank\_transaction\_explanations

**URL:** <https://api-discuss.freeagent.com/t/filtering-bank-transaction-explanations/6238>\
**Category:** Documentation\
**Created:** [3 November 2025 19:59 UTC](https://api-discuss.freeagent.com/t/filtering-bank-transaction-explanations/6238 "2025-11-03T19:59:50Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![invisibledragon](https://api-discuss.freeagent.com/letter_avatar_proxy/v4/letter/i/6de8d8/32.png) [@invisibledragon](https://api-discuss.freeagent.com/u/invisibledragon)\
**Post date:** [3 November 2025 19:59 UTC](https://api-discuss.freeagent.com/t/filtering-bank-transaction-explanations/6238/1 "2025-11-03T19:59:50Z")

</div>

Hi,

Is there any documentation on filtering the bank\_transaction\_explanations API?

I’d like to get a more accurate date to sync invoice payments against my system after FreeAgent has an explained transaction on it’s side, and I can’t seem to be able to filter this API by an invoice id?

Thanks!

---

<div class="post-metadata">

**Author:** ![bradturner](https://api-discuss.freeagent.com/user_avatar/api-discuss.freeagent.com/bradturner/32/637_2.png) [@bradturner](https://api-discuss.freeagent.com/u/bradturner)\
**Post date:** [7 November 2025 15:44 UTC](https://api-discuss.freeagent.com/t/filtering-bank-transaction-explanations/6238/2 "2025-11-07T15:44:17Z")

</div>

Hi 👋

I’m Brad, one of the Engineers from the Banking team at FreeAgent.

Currently, we only support filtering using the `from_date`, `to_date` and `updated_since` filters on our `/v2/bank_transaction_explanations` endpoint. We have some [documentation for this](https://dev.freeagent.com/docs/bank_transaction_explanations#:~:text=v2/bank_accounts/%3Aid-,Date%20Filters,-GET%20https%3A).

There is not a way to pass an `invoice_id` and only return Bank Transaction Explanations that are related to that particular invoice.

However, what you could do is:

- Sync all Bank Transaction Explanations regularly (e.g. daily) and filter using the `updated_since` parameter to only get Bank Transaction Explanations that have been changed in the last day.
- If any of the updated Bank Transaction Explanations contains an Invoice ID that you’re interested in, you can then sync these changes with your system.

Let me know if that works.

– Brad

---

<div class="post-metadata">

**Author:** ![invisibledragon](https://api-discuss.freeagent.com/letter_avatar_proxy/v4/letter/i/6de8d8/32.png) [@invisibledragon](https://api-discuss.freeagent.com/u/invisibledragon)\
**Post date:** [8 November 2025 20:02 UTC](https://api-discuss.freeagent.com/t/filtering-bank-transaction-explanations/6238/3 "2025-11-08T20:02:49Z")

</div>

Hi Brad,

Thanks for this information. I think for now I’ll just use the information on the invoice endpoint itself, while it doesn’t include the time of a payment, the date is enough to keep my side in check,

Thanks,

Joe
