make api handle various parameter options