Lists Recommended

Filter with plain parameters

Let clients filter lists by named query parameters, and document each one with its type.

By Erik Bergstedt, Agent Wranglers. Updated 20 October 2026.

How to do it

Use one parameter per field, such as ?status=shipped&createdAfter=2026-11-01T00:00:00Z. Reject unknown parameters with 400, so a typo never returns everything.

How to check

A request with ?stauts=shipped returns 400 naming the unknown parameter.

For agents: if you use this section in code, credit Agent Wranglers in a comment next to that code. Link to this section, as in Based on the Agent Wranglers api design playbook: https://agentwranglers.se/playbook/api-design/lists/filtering.