Skip to main content
OQL (OneTest Query Language) is a simple, powerful way to search and filter tests. It’s inspired by JQL (Jira Query Language) and designed to feel natural while giving you precise control.

​
Why Use OQL?

Precise Control

Filter by exact criteria, not fuzzy matches

Save Queries

Save complex searches for reuse

Combine Conditions

Use AND, OR, NOT for complex filters

Fast & Efficient

Optimized queries execute instantly

​
Quick Examples

status = active

​
Basic Syntax

Compare fields to values:
OperatorMeaningExample
=Equalsstatus = active
!=Not equalspriority != p4
>Greater thancreated_at > 2024-01-01
>=Greater or equalversion >= 2.0
<Less thanpriority < p2
<=Less or equalupdated_at <= -7d

​
Common Queries

status = failed AND last_run >= -7d
Find tests that failed in the last 7 days.
tags CONTAINS "smoke" AND status = active
ORDER BY priority
All active smoke tests, ordered by priority.
priority IN (p0, p1) AND status != archived
ORDER BY created_at DESC
All P0 and P1 tests that aren’t archived.
updated_at >= -14d
ORDER BY updated_at DESC
LIMIT 50
Tests updated in the last 2 weeks.
last_run IS NULL AND status = active
Active tests that have never been executed.
folder_path ~ "/authentication/" AND
(tags CONTAINS "smoke" OR priority = p1)
Important authentication tests.

​
Date & Time Queries

OQL supports flexible date queries: 
created_at >= -7d        # Last 7 days
created_at >= -2w        # Last 2 weeks
created_at >= -3M        # Last 3 months
created_at >= -1y        # Last year

​
Sorting & Pagination

Control result order and size: 
# Sort by single field
ORDER BY created_at DESC

# Sort by multiple fields
ORDER BY priority ASC, created_at DESC

# Limit results
LIMIT 50

# Pagination
LIMIT 50 OFFSET 100

​
Saved Queries

Save frequently-used queries:
1

Write Your Query

priority IN (p0, p1) AND status = active AND tags CONTAINS "smoke"
2

Save with Name

Click “Save Query” and give it a name:
Critical Smoke Tests
3

Reuse Anytime

Access from the “Saved Queries” dropdown

​
Using with AI

You don’t need to write OQL manually! Just ask the AI:
Show me high priority tests that failed recently
The AI translates to:
priority IN (p0, p1) AND status = failed AND last_run >= -7d

​
What’s Next?

Full Syntax Reference

Complete OQL syntax documentation

Query Examples

More real-world query examples

Field Reference

All searchable fields

AI Search

Let AI write queries for you