mirror of
https://github.com/prowler-cloud/prowler.git
synced 2026-07-19 02:21:52 +00:00
pedrooot
53 lines
1.4 KiB
Plaintext
53 lines
1.4 KiB
Plaintext
---
|
|
title: "Get Services and Regions"
|
|
api: "GET /api/v1/findings/findings_services_regions"
|
|
description: "Fetch services and regions affected in findings."
|
|
---
|
|
|
|
<Warning>
|
|
This endpoint is deprecated. Please use alternative filtering methods for retrieving services and regions information.
|
|
</Warning>
|
|
|
|
Retrieve a list of unique services and regions that have findings matching the specified criteria. This is useful for populating dynamic filters in user interfaces.
|
|
|
|
## Query Parameters
|
|
|
|
### Field Selection
|
|
|
|
- `fields[finding-dynamic-filters]` - Specify which fields to return: `services`, `regions`
|
|
|
|
### Filtering
|
|
|
|
The endpoint supports the same filtering options as the regular findings list endpoint to scope the services and regions returned.
|
|
|
|
## Example Request
|
|
|
|
```bash
|
|
curl -X GET "https://api.prowler.com/api/v1/findings/findings_services_regions?filter[provider_type]=aws&filter[status]=FAIL" \
|
|
-H "Authorization: Bearer YOUR_API_KEY" \
|
|
-H "Content-Type: application/vnd.api+json"
|
|
```
|
|
|
|
## Response
|
|
|
|
### Success Response (200 OK)
|
|
|
|
Returns unique services and regions from findings:
|
|
|
|
```json
|
|
{
|
|
"data": {
|
|
"type": "finding-dynamic-filters",
|
|
"id": "filters",
|
|
"attributes": {
|
|
"services": ["s3", "ec2", "iam"],
|
|
"regions": ["us-east-1", "us-west-2"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
<Warning>
|
|
This endpoint is deprecated. Use `/api/v1/findings/metadata` or `/api/v1/findings/metadata/latest` instead.
|
|
</Warning>
|