Amazon ECR website screenshot

Amazon ECR

Amazon Elastic Container Registry (ECR) is a fully managed container registry that makes it easy to store, manage, share, and deploy container images and artifacts. ECR eliminates the need to operate your own container repositories or worry about scaling the underlying infrastructure, and integrates with Amazon ECS and Amazon EKS for simplified development to production workflows.

Amazon ECR publishes 6 APIs on the APIs.io network, including Amazon ECR Amazon Elastic Container Registry (ECR) API API, #BatchGetImage API, #DeleteRepository API, and 3 more. Tagged areas include Amazon Web Services, Container Images, Container Registry, Containers, and Docker.

The Amazon ECR catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Amazon ECR’s developer surface includes authentication, developer portal, documentation, support, engineering blog, developer console, signup flow, and 25 more developer resources.

68.7/100 exemplar ▬ flat Agent 37/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
6 APIs 7 Features 5 Use Cases
Amazon Web ServicesContainer ImagesContainer RegistryContainersDockerECROCI

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 68.7/100 · exemplar
Contract Quality 18.5 / 25
Developer Ergonomics 9.1 / 20
Commercial Clarity 17.9 / 20
Operational Transparency 8.2 / 13
Governance 8.3 / 12
Discoverability 6.7 / 10
Agent readiness — 37/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/amazon-ecr: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 6

Individual APIs this provider publishes, each with its own machine-readable definition.

Amazon ECR Amazon ECR Amazon Elastic Container Registry (ECR) API API

The Amazon ECR Amazon Elastic Container Registry (ECR) API API from Amazon ECR — 1 operation(s) for amazon ecr amazon elastic container registry (ecr) api.

Amazon ECR #BatchGetImage API

The #BatchGetImage API from Amazon ECR — 1 operation(s) for #batchgetimage.

Amazon ECR #DeleteRepository API

The #DeleteRepository API from Amazon ECR — 1 operation(s) for #deleterepository.

Amazon ECR #DescribeRepositories API

The #DescribeRepositories API from Amazon ECR — 1 operation(s) for #describerepositories.

Amazon ECR #ListImages API

The #ListImages API from Amazon ECR — 1 operation(s) for #listimages.

Amazon ECR #PutImage API

The #PutImage API from Amazon ECR — 1 operation(s) for #putimage.

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Arazzo Workflows 6

Multi-step API workflows described with the Arazzo specification.

Amazon ECR Decommission Repository

Inventory a repository's images, then delete it with a force branch when images remain.

ARAZZO

Amazon ECR Ensure Repository and Seed Image

Describe a repository, create it only when missing, then seed it with an image manifest.

ARAZZO

Amazon ECR Image Inventory

Describe a repository, list its image IDs with pagination, and fetch image detail.

ARAZZO

Amazon ECR Provision Repository

Create a container repository, confirm it exists, and inspect its current images.

ARAZZO

Amazon ECR Publish Image

Confirm a repository exists, put an image manifest, then read the image back.

ARAZZO

Amazon ECR Registry Audit

Page through every repository in a registry following the DescribeRepositories token loop.

ARAZZO

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Amazon Ecr Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 7

Notable capabilities this provider offers.

Fully Managed Registry

Eliminate the need to operate your own container repositories or worry about scaling infrastructure.

Image Vulnerability Scanning

Automated vulnerability assessment via Amazon Inspector integration for continuous image security.

Lifecycle Policies

Automatically expire and delete images based on rules to reduce storage costs.

Cross-Account Replication

Replicate images to registries in other AWS accounts and regions for availability.

OCI Artifact Support

Store and manage OCI-compliant artifacts including Helm charts and SBOMs.

Image Signing

Sign and verify container images automatically without additional infrastructure.

Pull Through Cache

Cache upstream public registry images in ECR for reduced egress costs and improved availability.

Scroll for all 7

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Amazon Ecr Context

4 classes · 22 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Amazon ECR API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Amazon ECR API Rules

33 rules · 11 errors 17 warnings 5 info

SPECTRAL

JSON Schema 4

Standalone JSON Schema definitions for this provider's data models.

Amazon ECR Repository

12 properties

JSON SCHEMA

CreateRepositoryResponse

1 properties

JSON SCHEMA

DescribeRepositoriesResponse

2 properties

JSON SCHEMA

Repository

8 properties

JSON SCHEMA

JSON Structure 4

JSON Structure definitions describing this provider's data shapes.

Amazon Ecr Repository Structure

12 properties

JSON STRUCTURE

Ecr Openapi Repository Structure

8 properties

JSON STRUCTURE

Examples 4

Example request and response payloads for these APIs.

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Amazon Ecr Authentication

apiKey · 1 scheme

SECURITY

Amazon Ecr Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Amazon Ecr Vulnerability Disclosure

security.txt · contact published

SECURITY

Amazon Ecr Trust Center

PCI DSS, HIPAA, FedRAMP, GDPR, FIPS 140

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Amazon Ecr Agentic Access

6 operations · 6 acting

6 operations · 6 acting

AGENTIC

Use Cases 5

What developers build with this provider.

CI/CD Pipeline Integration

Store container images in ECR and deploy to ECS or EKS as part of automated pipelines.

Security and Compliance

Automated vulnerability scanning and image signing for security-compliant container deployments.

Multi-Region Deployments

Replicate images across regions for low-latency pulls and improved resilience.

Helm Chart Repository

Store Helm charts as OCI artifacts for Kubernetes application deployment management.

Image Lifecycle Management

Manage image retention policies to keep registries clean and reduce storage costs.

Resources

Get Started 5

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 8

Pagination, idempotency, versioning, errors, and events

Scroll for all 8

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 6

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 4

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
name: Amazon ECR
description: Amazon Elastic Container Registry (ECR) is a fully managed container registry that makes it easy to store, manage,
  share, and deploy container images and artifacts. ECR eliminates the need to operate your own container repositories or
  worry about scaling the underlying infrastructure, and integrates with Amazon ECS and Amazon EKS for simplified development
  to production workflows.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://a0.awsstatic.com/libra-css/images/logos/aws_logo_smile_1200x630.png
url: https://aws.amazon.com/ecr/
created: '2024-01-15'
modified: '2026-05-19'
tags:
- Amazon Web Services
- AWS
- Container Images
- Container Registry
- Containers
- Docker
- ECR
- OCI
apis:
- aid: amazon-ecr:amazon-ecr-amazon-ecr-amazon-elastic-container-registry-ecr-api-api
  name: Amazon ECR Amazon ECR Amazon Elastic Container Registry (ECR) API API
  description: The Amazon ECR Amazon Elastic Container Registry (ECR) API API from Amazon ECR — 1 operation(s) for amazon
    ecr amazon elastic container registry (ecr) api.
  baseURL: https://api.ecr.amazonaws.com
  tags:
  - Amazon ECR Amazon Elastic Container Registry (ECR) API
  properties:
  - type: OpenAPI
    url: openapi/amazon-ecr-amazon-ecr-amazon-elastic-container-registry-ecr-api-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/
  - type: JSONSchema
    url: json-schema/amazon-ecr-repository-schema.json
  - type: JSONLD
    url: json-ld/amazon-ecr-context.jsonld
  - type: Pricing
    url: https://aws.amazon.com/ecr/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/ecr/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/ecr/faqs/
  - type: APIReference
    url: https://docs.aws.amazon.com/AmazonECR/latest/APIReference/
  - type: Documentation
    url: https://docs.aws.amazon.com/cli/latest/reference/ecr/
  - type: Security
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/security.html
  - type: JSONStructure
    url: json-structure/amazon-ecr-repository-structure.json
  - type: Examples
    url: examples/amazon-ecr-repository-example.json
- aid: amazon-ecr:amazon-ecr-batchgetimage-api
  name: 'Amazon ECR #BatchGetImage API'
  description: 'The #BatchGetImage API from Amazon ECR — 1 operation(s) for #batchgetimage.'
  baseURL: https://api.ecr.amazonaws.com
  tags:
  - '#BatchGetImage'
  properties:
  - type: OpenAPI
    url: openapi/amazon-ecr-batchgetimage-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/
  - type: JSONSchema
    url: json-schema/amazon-ecr-repository-schema.json
  - type: JSONLD
    url: json-ld/amazon-ecr-context.jsonld
  - type: Pricing
    url: https://aws.amazon.com/ecr/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/ecr/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/ecr/faqs/
  - type: APIReference
    url: https://docs.aws.amazon.com/AmazonECR/latest/APIReference/
  - type: Documentation
    url: https://docs.aws.amazon.com/cli/latest/reference/ecr/
  - type: Security
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/security.html
  - type: JSONStructure
    url: json-structure/amazon-ecr-repository-structure.json
  - type: Examples
    url: examples/amazon-ecr-repository-example.json
- aid: amazon-ecr:amazon-ecr-deleterepository-api
  name: 'Amazon ECR #DeleteRepository API'
  description: 'The #DeleteRepository API from Amazon ECR — 1 operation(s) for #deleterepository.'
  baseURL: https://api.ecr.amazonaws.com
  tags:
  - '#DeleteRepository'
  properties:
  - type: OpenAPI
    url: openapi/amazon-ecr-deleterepository-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/
  - type: JSONSchema
    url: json-schema/amazon-ecr-repository-schema.json
  - type: JSONLD
    url: json-ld/amazon-ecr-context.jsonld
  - type: Pricing
    url: https://aws.amazon.com/ecr/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/ecr/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/ecr/faqs/
  - type: APIReference
    url: https://docs.aws.amazon.com/AmazonECR/latest/APIReference/
  - type: Documentation
    url: https://docs.aws.amazon.com/cli/latest/reference/ecr/
  - type: Security
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/security.html
  - type: JSONStructure
    url: json-structure/amazon-ecr-repository-structure.json
  - type: Examples
    url: examples/amazon-ecr-repository-example.json
- aid: amazon-ecr:amazon-ecr-describerepositories-api
  name: 'Amazon ECR #DescribeRepositories API'
  description: 'The #DescribeRepositories API from Amazon ECR — 1 operation(s) for #describerepositories.'
  baseURL: https://api.ecr.amazonaws.com
  tags:
  - '#DescribeRepositories'
  properties:
  - type: OpenAPI
    url: openapi/amazon-ecr-describerepositories-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/
  - type: JSONSchema
    url: json-schema/amazon-ecr-repository-schema.json
  - type: JSONLD
    url: json-ld/amazon-ecr-context.jsonld
  - type: Pricing
    url: https://aws.amazon.com/ecr/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/ecr/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/ecr/faqs/
  - type: APIReference
    url: https://docs.aws.amazon.com/AmazonECR/latest/APIReference/
  - type: Documentation
    url: https://docs.aws.amazon.com/cli/latest/reference/ecr/
  - type: Security
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/security.html
  - type: JSONStructure
    url: json-structure/amazon-ecr-repository-structure.json
  - type: Examples
    url: examples/amazon-ecr-repository-example.json
- aid: amazon-ecr:amazon-ecr-listimages-api
  name: 'Amazon ECR #ListImages API'
  description: 'The #ListImages API from Amazon ECR — 1 operation(s) for #listimages.'
  baseURL: https://api.ecr.amazonaws.com
  tags:
  - '#ListImages'
  properties:
  - type: OpenAPI
    url: openapi/amazon-ecr-listimages-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/
  - type: JSONSchema
    url: json-schema/amazon-ecr-repository-schema.json
  - type: JSONLD
    url: json-ld/amazon-ecr-context.jsonld
  - type: Pricing
    url: https://aws.amazon.com/ecr/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/ecr/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/ecr/faqs/
  - type: APIReference
    url: https://docs.aws.amazon.com/AmazonECR/latest/APIReference/
  - type: Documentation
    url: https://docs.aws.amazon.com/cli/latest/reference/ecr/
  - type: Security
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/security.html
  - type: JSONStructure
    url: json-structure/amazon-ecr-repository-structure.json
  - type: Examples
    url: examples/amazon-ecr-repository-example.json
- aid: amazon-ecr:amazon-ecr-putimage-api
  name: 'Amazon ECR #PutImage API'
  description: 'The #PutImage API from Amazon ECR — 1 operation(s) for #putimage.'
  baseURL: https://api.ecr.amazonaws.com
  tags:
  - '#PutImage'
  properties:
  - type: OpenAPI
    url: openapi/amazon-ecr-putimage-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/
  - type: JSONSchema
    url: json-schema/amazon-ecr-repository-schema.json
  - type: JSONLD
    url: json-ld/amazon-ecr-context.jsonld
  - type: Pricing
    url: https://aws.amazon.com/ecr/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/ecr/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/ecr/faqs/
  - type: APIReference
    url: https://docs.aws.amazon.com/AmazonECR/latest/APIReference/
  - type: Documentation
    url: https://docs.aws.amazon.com/cli/latest/reference/ecr/
  - type: Security
    url: https://docs.aws.amazon.com/AmazonECR/latest/userguide/security.html
  - type: JSONStructure
    url: json-structure/amazon-ecr-repository-structure.json
  - type: Examples
    url: examples/amazon-ecr-repository-example.json
common:
- type: AgenticAccess
  url: agentic-access/amazon-ecr-agentic-access.yml
- type: TrustCenter
  url: security/amazon-ecr-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/amazon-ecr-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/amazon-ecr-domain-security.yml
- type: Authentication
  url: authentication/amazon-ecr-authentication.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/amazon-ecr/overview
- type: Arazzo
  url: arazzo/amazon-ecr-decommission-repository-workflow.yml
  name: Amazon ECR Decommission Repository
- type: Arazzo
  url: arazzo/amazon-ecr-ensure-repository-and-seed-image-workflow.yml
  name: Amazon ECR Ensure Repository and Seed Image
- type: Arazzo
  url: arazzo/amazon-ecr-image-inventory-workflow.yml
  name: Amazon ECR Image Inventory
- type: Arazzo
  url: arazzo/amazon-ecr-provision-repository-workflow.yml
  name: Amazon ECR Provision Repository
- type: Arazzo
  url: arazzo/amazon-ecr-publish-image-workflow.yml
  name: Amazon ECR Publish Image
- type: Arazzo
  url: arazzo/amazon-ecr-registry-audit-workflow.yml
  name: Amazon ECR Registry Audit
- type: Portal
  url: https://aws.amazon.com/
- type: DeveloperPortal
  url: https://aws.amazon.com/
- type: Documentation
  url: https://docs.aws.amazon.com/
- type: TermsOfService
  url: https://aws.amazon.com/service-terms/
- type: PrivacyPolicy
  url: https://aws.amazon.com/privacy/
- type: Support
  url: https://aws.amazon.com/support/
- type: Blog
  url: https://aws.amazon.com/blogs/
- type: GitHubOrganization
  url: https://github.com/aws
- type: Console
  url: https://console.aws.amazon.com/
- type: Signup
  url: https://portal.aws.amazon.com/billing/signup
- type: Login
  url: https://signin.aws.amazon.com/
- type: StatusPage
  url: https://status.aws.amazon.com/
- type: KnowledgeCenter
  url: https://repost.aws/knowledge-center
- type: YouTube
  url: https://www.youtube.com/user/AmazonWebServices
- type: StackOverflow
  url: https://stackoverflow.com/questions/tagged/amazon-web-services
- type: Contact
  url: https://aws.amazon.com/contact-us/
- type: Security
  url: https://aws.amazon.com/security/
- type: Compliance
  url: https://aws.amazon.com/compliance/
- type: Features
  data:
  - name: Fully Managed Registry
    description: Eliminate the need to operate your own container repositories or worry about scaling infrastructure.
  - name: Image Vulnerability Scanning
    description: Automated vulnerability assessment via Amazon Inspector integration for continuous image security.
  - name: Lifecycle Policies
    description: Automatically expire and delete images based on rules to reduce storage costs.
  - name: Cross-Account Replication
    description: Replicate images to registries in other AWS accounts and regions for availability.
  - name: OCI Artifact Support
    description: Store and manage OCI-compliant artifacts including Helm charts and SBOMs.
  - name: Image Signing
    description: Sign and verify container images automatically without additional infrastructure.
  - name: Pull Through Cache
    description: Cache upstream public registry images in ECR for reduced egress costs and improved availability.
- type: UseCases
  data:
  - name: CI/CD Pipeline Integration
    description: Store container images in ECR and deploy to ECS or EKS as part of automated pipelines.
  - name: Security and Compliance
    description: Automated vulnerability scanning and image signing for security-compliant container deployments.
  - name: Multi-Region Deployments
    description: Replicate images across regions for low-latency pulls and improved resilience.
  - name: Helm Chart Repository
    description: Store Helm charts as OCI artifacts for Kubernetes application deployment management.
  - name: Image Lifecycle Management
    description: Manage image retention policies to keep registries clean and reduce storage costs.
- type: Integrations
  data:
  - name: Amazon ECS
    description: Natively integrated with ECS for pulling container images to run tasks and services.
  - name: Amazon EKS
    description: Authenticate and pull container images from ECR for Kubernetes workloads.
  - name: Amazon Inspector
    description: Continuous vulnerability scanning of images stored in ECR for security compliance.
  - name: AWS CodeBuild
    description: Build and push container images to ECR as part of CI/CD build processes.
  - name: AWS IAM
    description: Resource-based policies control who can push, pull, and manage images in ECR.
- type: SpectralRules
  url: rules/amazon-ecr-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/amazon-ecr-vocabulary.yaml
- type: Integrations
  url: https://aws.amazon.com/marketplace
maintainer:
  name: Kin Lane
  email: kin@apievangelist.com
integrations:
- name: Sign in
- name: Agent Mode
- name: Why AWS Marketplace?
- name: Get started in AWS Marketplace
- name: Industry
- name: Resources
- name: Become a Channel Partner
- name: Sell in AWS Marketplace
- name: Manage Your Account