Why doesn't the Get Records API Endpoint support the `filterByFormula` parameter?

In Bika.ai, we intentionally deprecated the filterByFormula parameter for the Get Records API after careful consideration. Here’s why:

  1. Performance Optimization: Bika.ai’s databases are designed to handle datasets exponentially larger than those supported by AITable. Formula-based filtering can severely degrade query performance at this scale, leading to slower responses and inefficient resource usage.

  2. Scalability First: Our priority is to ensure fast, reliable API interactions for all users, even as datasets grow. Formula evaluations on massive datasets often introduce bottlenecks, which conflict with this goal.

Workarounds available today:

  • Use existing filter in view like viewId to retrieve pre-filtered record sets.
  • Perform client-side filtering on the data returned by the API for simpler use cases.

Looking ahead:
We’re actively developing a new filter parameter that will offer SQL-like WHERE clause functionality for more flexible and performant server-side filtering. Stay tuned for updates! (It has been added it to the roadmap)

This decision balances immediate performance needs with future capabilities, and we appreciate your understanding as we work to improve the API.

2 Likes

I am working on data that has 200k rows. Filtering on the client side will not work because you cannot get all 200k rows at once. Using filters in the view will also not work because the parameters of the filter will not be fixed values. If one parameter has one view, then thousands of views have to be created to meet the requirements.
So do you have any other suggestions to filter data with frequently changing parameters?

2 Likes

I need this too

Thank you for sharing your scenario. While there’s no immediate alternative for dynamic parameter-based filtering at scale, we’re actively addressing this through a new filtering parameter currently on our Q2 roadmap. We’ll share updates as development progresses. Appreciate your patience!

2 Likes

Guys this is super crucial.

2 Likes

Wait. There is not filter options when getting records?

I need this too
filter

1 Like

It’s been 3 months. We are still waiting.

Been waiting a while, guys! I know it’s frustrating but hang in there – the engineer working on the API redesign swears we’re getting close. They’re actively working on it now (no more “Pending” status, finally!). Fingers crossed for some solid updates in July! :eyes::pray:

It’s July 22nd already.

Really, we hoped to have this sooner.

Hi @Vincent_Lo , thank you for following up and for your patience.

We’ve completed the refactor of the Get Records API, and you can find the update in our release notes here:

https://bika.ai/help/release-notes/v1.5.5

At the moment, we’re finishing the final round of regression testing and preparing more detailed developer documentation. We expect to roll it out next week.

3 Likes

Okay. Waiting to have the documentation.

Please make a post about it when done.

Is there an update about the more detailed developer documentation @Thea?
Is it expected to release in next week from now?

Hi @Vincent_Lo, the updated developer documentation is expected to go live this week. I’ll make sure to let you know as soon as it’s published!

1 Like

Hi @all @Vincent_Lo , finally — it’s live!

You can check the full developer guide here:

Let us know if you have any questions while going through it!

2 Likes

Thank you so much for keeping me updated.

Do we have live documentation how to use this?

seems the link is broken

@Kennypurnomo

filterByFormula has been deprecated, so you can just ignore that doc. The updated way is here: