Filtering

When requesting an endpoint that returns a collection, there may be required and/or optional filter arguments. These arguments are provided as part of the query string, for example listing profiles within your application would use the URL https://api.opentransact.com/v1/profiles?filter[application-id]=APPLICATION_ID where APPLICATION_ID is the UUID of your application.

Filtering by Metadata

For endpoints that support filtering metadata, you can currently find exact matches for top-level metadata values currently.

This means that if you set a metadata value like:

{"order-id": "1234"}

You can currently search for exact matching items with filter[metadata][order-id]=1234

It is not yet possible to search for items where you have sent nested JSON values like:

{
    "order": {
        "id: "1234"
    }
}

Please let us know if you have interest in support for searching nested and/or non-exact matches in metadata.