improved
Exposing Category Data
about 2 years ago by Oliver Fawcett
Hey everyone! 👋
We are happy to announce some changes (improvements) to how we expose categorisation on our enriched transactions, and how we expose categories overall.
Of course an example is worth a thousand words, so head over to the docs to see the latest examples, but in short:
transaction.category.components
has been deprecated. It's still there until the 1st of March 2023, but please consider moving to...transaction.category.groups
has been added. This uses a map structure instead of an array, and exposes stable IDs for each group.- The old
nzfcc:pfm
(found in thecomponents
array) has been renamed topersonal_finance
in thegroups
map - much clearer! - We are exposing the new
/categories
and/categories/{id}
API endpoints, which offer a programmatic way to get information about the categories available. - We have published NZFCC.org, which offers a easy way to explore and download the categories that we use in our enrichment. We hope to see others pick up these category codes - we've worked hard to make sure that they're a really good fit for New Zealanders.
We hope these changes make it simpler and easier to use our enriched data - if you have any issues with migrating, don't hesitate to get in touch with us!