IaC Explorer

Search IaC Stacks

Search IaC stacks

post

Query IaC stacks with filtering, sorting, and pagination

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Body

application/json

Responses

200

Successful response

application/json

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

500

Internal Server Error

application/json

post

/api/iacStacks

HTTPcURLJavaScriptPython

POST /v2/api/iacStacks HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 396

{
  "page": 1,
  "pageSize": 50,
  "screenFilters": {
    "stateType": [
      "terraform"
    ],
    "providerIntegrationId": [
      "text"
    ],
    "providerType": [
      "text"
    ],
    "providerAccountId": [
      "text"
    ],
    "stackAssetTypes": [
      "text"
    ],
    "status": [
      "text"
    ],
    "iacState": [
      "synced"
    ],
    "vcsRepo": [
      "text"
    ],
    "backendLocation": [
      "text"
    ],
    "hasIntegratedProviders": true,
    "hasNotIntegratedProviders": true
  },
  "freeTextSearch": "text",
  "sorting": {
    "field": "text",
    "order": "desc"
  }
}

{
  "hits": [
    {
      "id": "text",
      "name": "text",
      "stateType": "terraform",
      "status": "text",
      "version": "text",
      "backend": "text",
      "lastApplied": "2026-01-20T23:15:33.166Z",
      "assetCount": 1,
      "stackProviders": [
        {
          "providerType": "text",
          "providerAccountId": "text",
          "providerIntegrationId": "text",
          "isIntegrated": true
        }
      ],
      "metadata": {
        "vcsRepo": "text",
        "vcsPath": "text",
        "branch": "text"
      }
    }
  ],
  "total": 1
}

Query Backends

Query backends

post

Query backend/crawler data with filtering and pagination

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Body

application/json

Responses

200

Successful response

application/json

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

500

Internal Server Error

application/json

post

/api/iacStacks/backends

HTTPcURLJavaScriptPython

POST /v2/api/iacStacks/backends HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 354

{
  "page": 1,
  "pageSize": 50,
  "screenFilters": {
    "stateType": [
      "terraform"
    ],
    "providerIntegrationId": [
      "text"
    ],
    "providerType": [
      "text"
    ],
    "providerAccountId": [
      "text"
    ],
    "stackAssetTypes": [
      "text"
    ],
    "status": [
      "text"
    ],
    "iacState": [
      "synced"
    ],
    "vcsRepo": [
      "text"
    ],
    "backendLocation": [
      "text"
    ],
    "hasIntegratedProviders": true,
    "hasNotIntegratedProviders": true
  },
  "freeTextSearch": "text"
}

{
  "hits": [
    {
      "id": "text",
      "type": "s3",
      "mainLocation": "text",
      "lastScan": "2026-01-20T23:15:33.166Z",
      "isDeleted": true,
      "remoteIntegrationId": "text"
    }
  ],
  "aggs": [
    {
      "key": "text",
      "doc_count": 1
    }
  ],
  "total": 1
}

Query Repositories

Query repositories

post

Query VCS repositories containing IaC code

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Body

application/json

freeTextSearchstringOptional

Free text search query

Responses

200

Successful response

application/json

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

500

Internal Server Error

application/json

post

/api/iacStacks/repositories

HTTPcURLJavaScriptPython

POST /v2/api/iacStacks/repositories HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 331

{
  "screenFilters": {
    "stateType": [
      "terraform"
    ],
    "providerIntegrationId": [
      "text"
    ],
    "providerType": [
      "text"
    ],
    "providerAccountId": [
      "text"
    ],
    "stackAssetTypes": [
      "text"
    ],
    "status": [
      "text"
    ],
    "iacState": [
      "synced"
    ],
    "vcsRepo": [
      "text"
    ],
    "backendLocation": [
      "text"
    ],
    "hasIntegratedProviders": true,
    "hasNotIntegratedProviders": true
  },
  "freeTextSearch": "text"
}

[
  {
    "repoFullName": "text",
    "maxTimestamp": 1,
    "topHit": {
      "vcsId": "text",
      "vcsType": "github",
      "modulesCount": 1,
      "resourcesCount": 1
    }
  }
]

Query Modules

Query modules

post

Query Terraform/Pulumi modules with filtering and pagination

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Body

application/json

Responses

200

Successful response

application/json

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

500

Internal Server Error

application/json

post

/api/iacStacks/modules

HTTPcURLJavaScriptPython

POST /v2/api/iacStacks/modules HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 188

{
  "page": 1,
  "pageSize": 50,
  "screenFilters": {
    "repoFullName": [
      "text"
    ],
    "moduleOriginType": [
      "text"
    ],
    "misconfigurations": [
      "text"
    ]
  },
  "freeTextSearch": "text",
  "sort": [
    {
      "field": "text",
      "order": "desc"
    }
  ]
}

{
  "modules": [
    {
      "id": "text",
      "moduleFolderPath": "text",
      "repoFullName": "text",
      "moduleVcsPath": "text",
      "vcsType": "github",
      "updateAt": "2026-01-20T23:15:33.166Z",
      "lastContributor": "text",
      "firstContributor": "text",
      "usageCount": 1,
      "version": "text",
      "moduleOrigin": "text",
      "moduleOriginType": "local"
    }
  ],
  "total": 1
}

Query Providers

Query providers

post

Query stack providers aggregations

Authorizations

JWTAuth

AuthorizationstringRequired

JWT authentication token

Body

application/json

Responses

200

Successful response

application/json

400

Bad Request Error

application/json

401

Unauthorized Error

application/json

500

Internal Server Error

application/json

post

/api/iacStacks/providers

HTTPcURLJavaScriptPython

POST /v2/api/iacStacks/providers HTTP/1.1
Host: api.firefly.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 307

{
  "screenFilters": {
    "stateType": [
      "terraform"
    ],
    "providerIntegrationId": [
      "text"
    ],
    "providerType": [
      "text"
    ],
    "providerAccountId": [
      "text"
    ],
    "stackAssetTypes": [
      "text"
    ],
    "status": [
      "text"
    ],
    "iacState": [
      "synced"
    ],
    "vcsRepo": [
      "text"
    ],
    "backendLocation": [
      "text"
    ],
    "hasIntegratedProviders": true,
    "hasNotIntegratedProviders": true
  }
}

{
  "types": {
    "ANY_ADDITIONAL_PROPERTY": {
      "ANY_ADDITIONAL_PROPERTY": {
        "count": 1,
        "isIntegrated": true
      }
    }
  },
  "urls": {
    "buckets": [
      {
        "key": "text",
        "doc_count": 1
      }
    ]
  }
}