updated to match the current API
JSON example formatting chages
noting that agama can return partial matches