AWS CloudFormation

AWS CloudFormation Registry API

Operations for managing extension types in the CloudFormation Registry.

GitHub OpenAPI

Operations 2

POST /?Action=ListTypes List Available Extension Types in the Registry #
POST /?Action=DescribeType Describe an Extension Type in the Registry #

Documentation

📖
Documentation
https://docs.aws.amazon.com/cloudformation/
📖
APIReference
https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html
📖
GettingStarted
https://aws.amazon.com/cloudformation/getting-started/
📖
Documentation
https://docs.aws.amazon.com/cloudcontrolapi/latest/userguide/what-is-cloudcontrolapi.html
📖
APIReference
https://docs.aws.amazon.com/cloudcontrolapi/index.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cloudformation/refs/heads/main/openapi/cloudformation-registry-api-openapi.yml

Other Resources

🔗
Pricing
https://aws.amazon.com/cloudformation/pricing/
🔗
ChangeLog
https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/document-history.html
🔗
SDKs
https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/cloudformation.html

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cloudformation-registry-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cloudformation-registry-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: AWS CloudFormation Registry API
  description: AWS CloudFormation gives you an easy way to model a collection of related AWS and third-party resources, provision them quickly and consistently, and manage them throughout their lifecycles. It uses templates to define stacks of resources and provides API operations for creating, updating, and deleting stacks. The API uses a query-style interface where all operations are submitted as POST requests with an Action parameter.
  version: '2010-05-15'
  contact:
    name: AWS Support
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  x-logo:
    url: https://aws.amazon.com/cloudformation/logo.png
servers:
- url: https://cloudformation.{region}.amazonaws.com
  description: AWS CloudFormation Regional Endpoint
  variables:
    region:
      default: us-east-1
      description: AWS region
      enum:
      - us-east-1
      - us-east-2
      - us-west-1
      - us-west-2
      - eu-west-1
      - eu-west-2
      - eu-central-1
      - ap-southeast-1
      - ap-southeast-2
      - ap-northeast-1
security:
- AWS_Signature_V4: []
tags:
- name: Registry
  description: Operations for managing extension types in the CloudFormation Registry.
paths:
  /?Action=ListTypes:
    post:
      operationId: listTypes
      summary: List Available Extension Types in the Registry
      description: Returns summary information about extension types registered in the CloudFormation Registry.
      tags:
      - Registry
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                Visibility:
                  type: string
                  enum:
                  - PUBLIC
                  - PRIVATE
                ProvisioningType:
                  type: string
                  enum:
                  - NON_PROVISIONABLE
                  - IMMUTABLE
                  - FULLY_MUTABLE
                Type:
                  type: string
                  enum:
                  - RESOURCE
                  - MODULE
                  - HOOK
                Filters:
                  type: object
                  properties:
                    Category:
                      type: string
                      enum:
                      - REGISTERED
                      - ACTIVATED
                      - THIRD_PARTY
                      - AWS_TYPES
                    PublisherId:
                      type: string
                    TypeNamePrefix:
                      type: string
                NextToken:
                  type: string
                  maxLength: 1024
                MaxResults:
                  type: integer
                  minimum: 1
                  maximum: 100
            examples:
              ListtypesRequestExample:
                summary: Default listTypes request
                x-microcks-default: true
                value:
                  Visibility: PUBLIC
                  ProvisioningType: NON_PROVISIONABLE
                  Type: RESOURCE
                  Filters:
                    Category: REGISTERED
                    PublisherId: '500123'
                    TypeNamePrefix: example_value
                  NextToken: example_value
                  MaxResults: 10
      responses:
        '200':
          description: Type summaries returned.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  ListTypesResult:
                    type: object
                    properties:
                      TypeSummaries:
                        type: array
                        items:
                          $ref: '#/components/schemas/TypeSummary'
                      NextToken:
                        type: string
              examples:
                Listtypes200Example:
                  summary: Default listTypes 200 response
                  x-microcks-default: true
                  value:
                    ListTypesResult:
                      TypeSummaries:
                      - Type: RESOURCE
                        TypeName: example_value
                        TypeArn: example_value
                        DefaultVersionId: '500123'
                        Description: A sample description.
                        LastUpdated: '2026-01-15T10:30:00Z'
                        PublisherId: '500123'
                        PublisherName: example_value
                        IsActivated: true
                        OriginalTypeName: example_value
                        PublicVersionNumber: example_value
                        LatestPublicVersion: example_value
                      NextToken: example_value
        '400':
          $ref: '#/components/responses/ValidationError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /?Action=DescribeType:
    post:
      operationId: describeType
      summary: Describe an Extension Type in the Registry
      description: Returns detailed information about an extension type registered in the CloudFormation Registry.
      tags:
      - Registry
      parameters:
      - $ref: '#/components/parameters/VersionParam'
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                Type:
                  type: string
                  enum:
                  - RESOURCE
                  - MODULE
                  - HOOK
                TypeName:
                  type: string
                Arn:
                  type: string
                VersionId:
                  type: string
                PublisherId:
                  type: string
                PublicVersionNumber:
                  type: string
            examples:
              DescribetypeRequestExample:
                summary: Default describeType request
                x-microcks-default: true
                value:
                  Type: RESOURCE
                  TypeName: example_value
                  Arn: example_value
                  VersionId: '500123'
                  PublisherId: '500123'
                  PublicVersionNumber: example_value
      responses:
        '200':
          description: Type details returned.
          content:
            application/xml:
              schema:
                type: object
                properties:
                  DescribeTypeResult:
                    type: object
                    properties:
                      Arn:
                        type: string
                      Type:
                        type: string
                      TypeName:
                        type: string
                      Description:
                        type: string
                      Schema:
                        type: string
                      ProvisioningType:
                        type: string
                      Visibility:
                        type: string
                      DefaultVersionId:
                        type: string
                      IsDefaultVersion:
                        type: boolean
                      TimeCreated:
                        type: string
                        format: date-time
                      LastUpdated:
                        type: string
                        format: date-time
              examples:
                Describetype200Example:
                  summary: Default describeType 200 response
                  x-microcks-default: true
                  value:
                    DescribeTypeResult:
                      Arn: example_value
                      Type: example_value
                      TypeName: example_value
                      Description: A sample description.
                      Schema: example_value
                      ProvisioningType: example_value
                      Visibility: example_value
                      DefaultVersionId: '500123'
                      IsDefaultVersion: true
                      TimeCreated: '2026-01-15T10:30:00Z'
                      LastUpdated: '2026-01-15T10:30:00Z'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalError'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        Error:
          type: object
          properties:
            Type:
              type: string
            Code:
              type: string
            Message:
              type: string
          example: example_value
        RequestId:
          type: string
          example: '500123'
    TypeSummary:
      type: object
      properties:
        Type:
          type: string
          enum:
          - RESOURCE
          - MODULE
          - HOOK
          example: RESOURCE
        TypeName:
          type: string
          example: example_value
        TypeArn:
          type: string
          example: example_value
        DefaultVersionId:
          type: string
          example: '500123'
        Description:
          type: string
          example: A sample description.
        LastUpdated:
          type: string
          format: date-time
          example: '2026-01-15T10:30:00Z'
        PublisherId:
          type: string
          example: '500123'
        PublisherName:
          type: string
          example: example_value
        IsActivated:
          type: boolean
          example: true
        OriginalTypeName:
          type: string
          example: example_value
        PublicVersionNumber:
          type: string
          example: example_value
        LatestPublicVersion:
          type: string
          example: example_value
  parameters:
    VersionParam:
      name: Version
      in: query
      required: true
      schema:
        type: string
        default: '2010-05-15'
      description: The API version. Fixed to 2010-05-15.
  responses:
    InternalError:
      description: An internal service error occurred.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    ValidationError:
      description: The input fails to satisfy the constraints specified by the service.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFoundError:
      description: The specified resource was not found.
      content:
        application/xml:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    AWS_Signature_V4:
      type: apiKey
      name: Authorization
      in: header
      description: AWS Signature Version 4 authentication.