add documentation for optional search params