Filtering Results

You can filter which results are returned by most list endpoints (such as List services). You provide filter values as query parameters separated by &, like so:

curl --request GET \
     --url 'https://api.render.com/v1/services?name=test-service&type=static_site' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer API_KEY_GOES_HERE'

If a filter value includes reserved characters (such as spaces), make sure it's URL-encoded.

For available filters, consult the reference page for each list endpoint.

Multi-value filters

You can provide multiple values for a single filter, separated by an unencoded comma (,). If you do, the endpoint returns results that match any provided value for that filter.

For example, this request fetches all services of type static_site or web_service:

curl --request GET \
     --url 'https://api.render.com/v1/services?type=static_site,web_service' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer API_KEY_GOES_HERE'