Filtering & Search

curl -X GET \
  "https://awx.example.com/api/v2/job_templates/?name=Deploy" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Exact match (default)
?name=Deploy
?name__exact=Deploy

# Case-sensitive contains
?name__contains=deploy

# Case-insensitive contains
?name__icontains=deploy

# Starts with
?name__startswith=Deploy
?name__istartswith=deploy  # case-insensitive

# Ends with
?name__endswith=Production
?name__iendswith=production  # case-insensitive

# Greater than
?id__gt=10

# Greater than or equal
?id__gte=10

# Less than
?id__lt=100

# Less than or equal
?id__lte=100

# Match any value in list (comma-separated)
?id__in=1,2,3,4,5
?status__in=successful,failed

# Is null
?description__isnull=true

# Is not null
?description__isnull=false

# Boolean values
?enabled=true
?enabled=false

# Exact date
?created=2024-01-15

# Date range
?created__gte=2024-01-01
?created__lte=2024-12-31

# Year, month, day
?created__year=2024
?created__month=1
?created__day=15

# Time components
?created__hour=10
?created__minute=30

curl -X GET \
  "https://awx.example.com/api/v2/job_templates/?search=deploy" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X GET \
  "https://awx.example.com/api/v2/jobs/?status=successful&job_type=run&created__gte=2024-01-01" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Ascending order
?order_by=name

# Descending order (prefix with -)
?order_by=-created

# Multiple fields
?order_by=status,-created

# By name
?order_by=name

# By creation date (newest first)
?order_by=-created

# By modification date
?order_by=-modified

# By ID
?order_by=id

# Multiple: status ascending, then created descending
?order_by=status,-created

# Filter by organization name
?organization__name=Default

# Filter by inventory ID
?inventory__id=5

# Filter by project SCM type
?project__scm_type=git

# Filter by organization and created date
?organization__name=Engineering&created__gte=2024-01-01

# Filter inventory by host_filter field
?host_filter=ansible_facts__ansible_distribution__icontains=ubuntu

# Note: ansible_facts does not support all lookups
?ansible_facts__ansible_os_family=Debian

# Filter unified jobs by type
?type=job
?type=project_update
?type=inventory_update

curl -X GET \
  "https://awx.example.com/api/v2/jobs/?status=failed&created__gte=2024-01-08&order_by=-created" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X GET \
  "https://awx.example.com/api/v2/job_templates/?name__icontains=deploy&order_by=name" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X GET \
  "https://awx.example.com/api/v2/organizations/?summary_fields__related_field_counts__projects__gt=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X GET \
  "https://awx.example.com/api/v2/jobs/?status__in=pending,waiting,running" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X GET \
  "https://awx.example.com/api/v2/inventories/?organization__in=1,2,3" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X GET \
  "https://awx.example.com/api/v2/inventories/?description__isnull=true" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X GET \
  "https://awx.example.com/api/v2/jobs/?status=successful&page_size=50&page=1&order_by=-created" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X OPTIONS \
  "https://awx.example.com/api/v2/job_templates/" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Jobs from last 24 hours
?created__gte=$(date -u -d '24 hours ago' +%Y-%m-%dT%H:%M:%S)

# Currently running jobs
?status__in=pending,waiting,running

# Resources created by specific user
?created_by__id=5

# Modified by specific user
?modified_by__username=admin

# All resources in organization
?organization=1

# By organization name
?organization__name=Engineering

{
  "detail": "Invalid filter field: invalid_field"
}

{
  "detail": "Unsupported lookup 'invalid' for field 'name'"
}