---
title: "Query providers"
method: POST
path: "/api/iacStacks/providers"
tags: ["IaC Stacks"]
---

# Query providers

`POST /api/iacStacks/providers`

Query stack providers aggregations

## Request body

- QueryProvidersRequest
  - `screenFilters` ScreenFilters — Filters for querying stacks. Filter values are matched against stack properties. Some filters are mapped to nested fields internally: - providerIntegrationId → stackProviders.providerIntegrationId - providerType → stackProviders.providerType - providerAccountId → stackProviders.providerAccountId - vcsRepo → metadata.vcsRepo
    - `stateType` string[] — IAC type filter (terraform, cloudformation, pulumi, helm, k8s, opentofu, etc.)
    - `providerIntegrationId` string[] — Integration ID filter (maps to stackProviders.providerIntegrationId)
    - `providerType` string[] — Provider type filter - aws, gcp, azure, etc. (maps to stackProviders.providerType)
    - `providerAccountId` string[] — Provider account ID filter (maps to stackProviders.providerAccountId)
    - `stackAssetTypes` string[] — Asset type filter
    - `status` string[] — Stack status filter
    - `iacState` string[] — Stack sync state filter - synced, unsynced, drifted (handled via meta-index)
    - `vcsRepo` string[] — VCS repository filter (maps to metadata.vcsRepo)
    - `backendLocation` string[] — Backend location filter
    - `hasIntegratedProviders` boolean — Filter stacks with integrated providers
    - `hasNotIntegratedProviders` boolean — Filter stacks without integrated providers

## Response `200`

Successful response

- QueryProvidersResponse — Response containing provider types and URLs aggregations
  - `types` ProviderAggregation
  - `urls` object — Provider URLs aggregation
    - `buckets` object[]
      - `key` string
      - `doc_count` integer

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)