Docker Hub
Interact with Docker Hub.
About Docker Hub
Docker Hub is a hosted service from Docker for finding and sharing container images, providing a UI, an experimental CLI tool, and an HTTP API for interacting with the registry programmatically. The API documented here covers authentication (via username/password, personal access tokens, or organization access tokens), token creation and management, two-factor authentication, and rate limiting behavior including request-per-minute limits separate from image pull rate limits.
Access to certain API endpoints and their responses varies by account subscription tier (Personal, Pro, or Team) and by account permissions. Personal access tokens are scoped to specific resources and actions and are presented as the more secure authentication method compared to passwords, while organization access tokens are intended for automation and are managed by organization owners. This documentation is aimed at developers building tools or automation that interact with Docker Hub, such as managing repositories, images, or access tokens outside of the standard UI or CLI.
Key features
- REST API for browsing and managing container images on Docker Hub
- Authentication via username/password, personal access tokens (PAT), or organization access tokens (OAT)
- Two-factor authentication (2FA) login flow with time-based one-time passwords
- Scoped personal access token creation and management
- Per-minute rate limiting with X-RateLimit response headers
Frequently asked questions
What is Docker Hub?
Docker Hub is Docker's service for finding and sharing container images, described as the world's largest library and community for container images.
How do I authenticate with the Docker Hub API?
You authenticate using Docker credentials via password, a personal access token (PAT), or an organization access token (OAT), obtaining a bearer token through the Create access token route.
Does Docker Hub API access differ by subscription plan?
Yes, API endpoint responses may vary depending on your subscription tier (Personal, Pro, or Team) and your account's permissions.
Is there a rate limit on the API?
Yes, the API limits requests per minute and returns X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers, with a 429 status and Retry-After header once the limit is hit.
Is username/password authentication recommended?
No, using a personal access token is recommended instead since it is more secure and scoped to specific resources, and password authentication isn't available if an organization has SSO enforced.
Show your product to thousands of developers
· 100k monthly pageviews
· 7k newsletter subscribers
You might also like
Databricks
DevelopmentService to manage your databricks account,clusters, notebooks, jobs and workspaces.
DATPAQ
DevelopmentDeveloper-first APIs. Enterprise-ready infrastructure. Sampla data, avatars, image processing and a lot more.
DigitalOcean Status
DevelopmentStatus of all DigitalOcean services.
DomainDb Info
DevelopmentDomain name search to find all domains containing particular words/phrases/etc.
ExtendsClass JSON Storage
DevelopmentA simple JSON store API.
Form Creation API
DevelopmentCreate and manage customizable forms within your applications.
