Of course adding this info in API docs should be doable and useful.
Changing the API is more difficult: it would require all API clients to change the queries, then anyway values format in queries is just a convention.