Filtering

When requesting resources from list endpoints, such as List services, it can be helpful to filter the results. This can be done by supplying filters through 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 {{render_api_token}}'

If your filters contain reserved characters, such as spaces, they should be URL encoded.

OR Filtering

Let's say you want to filter for several things at once- for example, if you wanted to return services that have either type web_service or type static_site. To do this, simply separate your filter input by an unencoded comma, and results will be returned that match either of the supplied values.

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