Dog API

Dog API Images API

Fetch random or breed-specific dog images (with optional alt text).

GitHub OpenAPI

Operations 13

GET /breed/{breed}/images Dog API List Images by Breed #
GET /breed/{breed}/images/random Dog API Random Image by Breed #
GET /breed/{breed}/images/random/{amount} Dog API Multiple Random Images by Breed #
GET /breed/{breed}/{subBreed}/images Dog API List Images by Sub-Breed #
GET /breed/{breed}/{subBreed}/images/random Dog API Random Image by Sub-Breed #
GET /breed/{breed}/{subBreed}/images/random/{amount} Dog API Multiple Random Images by Sub-Breed #
GET /breeds/image/random Dog API Random Image From Any Breed #
GET /breeds/image/random/{amount} Dog API Multiple Random Images From Any Breed #
GET /breeds/image/random/{amount}/alt Dog API Multiple Random Images From Any Breed With Alt Text #
GET /breed/{breed}/images/alt Dog API List Images by Breed With Alt Text #
GET /breed/{breed}/images/random/{amount}/alt Dog API Multiple Random Images by Breed With Alt Text #
GET /breed/{breed}/{subBreed}/images/alt Dog API List Images by Sub-Breed With Alt Text #
GET /breed/{breed}/{subBreed}/images/random/{amount}/alt Dog API Multiple Random Images by Sub-Breed With Alt Text #

Documentation

📖
Documentation
https://dog.ceo/dog-api/documentation
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/rate-limits/dog-api-rate-limits.yml

Specifications

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

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/json-schema/dog-api-breed-list-response-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/json-structure/dog-api-breed-list-response-structure.json

Other Resources

🔗
GitHub
https://github.com/ElliottLandsborough/dog-ceo-api
🔗
SourceImages
https://github.com/jigsawpieces/dog-api-images
🔗
Rules
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/rules/dog-api-rules.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/json-ld/dog-api.jsonld
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/json-ld/dog-api-context.jsonld
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/vocabulary/dog-api.yml
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/plans/dog-api-plans-pricing.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/dog-api/refs/heads/main/finops/dog-api-finops.yml

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/dog-api-images-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

dog-api-images-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dog Breeds Images API
  description: The Dog API (dog.ceo) is the internet's largest collection of open-source dog pictures, exposing over 20,000 dog images accessible by more than 120 breeds. The API is free, requires no authentication, and returns JSON. An optional `alt` variant returns image URLs paired with descriptive alt text for accessibility. The canonical implementation is the open-source PHP Symfony project at github.com/ElliottLandsborough/dog-ceo-api, licensed MIT.
  version: 1.1.0
  contact:
    name: Dog API
    url: https://dog.ceo/dog-api/
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-generated-from: documentation+source
  x-source-url: https://github.com/ElliottLandsborough/dog-ceo-api/blob/main/src/Controller/MainController.php
  x-last-validated: '2026-05-30'
servers:
- url: https://dog.ceo/api
  description: Dog API production server
tags:
- name: Images
  description: Fetch random or breed-specific dog images (with optional alt text).
paths:
  /breed/{breed}/images:
    get:
      tags:
      - Images
      summary: Dog API List Images by Breed
      description: Returns all image URLs for a given master breed.
      operationId: listImagesByBreed
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      responses:
        '200':
          description: An array of image URLs for the breed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageListResponse'
              examples:
                ListImagesByBreed200Example:
                  summary: Default listImagesByBreed 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1023.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_10263.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/images/random:
    get:
      tags:
      - Images
      summary: Dog API Random Image by Breed
      description: Returns a single random image URL for the given master breed.
      operationId: randomImageByBreed
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      responses:
        '200':
          description: A single random image URL for the breed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageResponse'
              examples:
                RandomImageByBreed200Example:
                  summary: Default randomImageByBreed 200 response
                  x-microcks-default: true
                  value:
                    message: https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/images/random/{amount}:
    get:
      tags:
      - Images
      summary: Dog API Multiple Random Images by Breed
      description: Returns multiple random image URLs for the given master breed.
      operationId: randomImagesByBreed
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      - name: amount
        in: path
        required: true
        description: Number of random images to return.
        schema:
          type: integer
          minimum: 1
        example: 3
      responses:
        '200':
          description: An array of random image URLs for the breed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageListResponse'
              examples:
                RandomImagesByBreed200Example:
                  summary: Default randomImagesByBreed 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1023.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_10263.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/{subBreed}/images:
    get:
      tags:
      - Images
      summary: Dog API List Images by Sub-Breed
      description: Returns all image URLs for a given sub-breed.
      operationId: listImagesBySubBreed
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      - name: subBreed
        in: path
        required: true
        description: Sub-breed name.
        schema:
          type: string
        example: afghan
      responses:
        '200':
          description: An array of image URLs for the sub-breed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageListResponse'
              examples:
                ListImagesBySubBreed200Example:
                  summary: Default listImagesBySubBreed 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1023.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_10263.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/{subBreed}/images/random:
    get:
      tags:
      - Images
      summary: Dog API Random Image by Sub-Breed
      description: Returns a single random image URL for the given sub-breed.
      operationId: randomImageBySubBreed
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      - name: subBreed
        in: path
        required: true
        description: Sub-breed name.
        schema:
          type: string
        example: afghan
      responses:
        '200':
          description: A single random image URL for the sub-breed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageResponse'
              examples:
                RandomImageBySubBreed200Example:
                  summary: Default randomImageBySubBreed 200 response
                  x-microcks-default: true
                  value:
                    message: https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/{subBreed}/images/random/{amount}:
    get:
      tags:
      - Images
      summary: Dog API Multiple Random Images by Sub-Breed
      description: Returns multiple random image URLs for the given sub-breed.
      operationId: randomImagesBySubBreed
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      - name: subBreed
        in: path
        required: true
        description: Sub-breed name.
        schema:
          type: string
        example: afghan
      - name: amount
        in: path
        required: true
        description: Number of random images to return.
        schema:
          type: integer
          minimum: 1
        example: 3
      responses:
        '200':
          description: An array of random image URLs for the sub-breed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageListResponse'
              examples:
                RandomImagesBySubBreed200Example:
                  summary: Default randomImagesBySubBreed 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1023.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_10263.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breeds/image/random:
    get:
      tags:
      - Images
      summary: Dog API Random Image From Any Breed
      description: Returns a random dog image URL from any breed.
      operationId: randomImage
      responses:
        '200':
          description: A single random image URL.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageResponse'
              examples:
                RandomImage200Example:
                  summary: Default randomImage 200 response
                  x-microcks-default: true
                  value:
                    message: https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breeds/image/random/{amount}:
    get:
      tags:
      - Images
      summary: Dog API Multiple Random Images From Any Breed
      description: Returns multiple random dog image URLs from any breed.
      operationId: randomImages
      parameters:
      - name: amount
        in: path
        required: true
        description: Number of random images to return.
        schema:
          type: integer
          minimum: 1
        example: 3
      responses:
        '200':
          description: An array of random image URLs.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageListResponse'
              examples:
                RandomImages200Example:
                  summary: Default randomImages 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_1023.jpg
                    - https://images.dog.ceo/breeds/hound-afghan/n02088094_10263.jpg
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breeds/image/random/{amount}/alt:
    get:
      tags:
      - Images
      summary: Dog API Multiple Random Images From Any Breed With Alt Text
      description: Returns multiple random images from any breed paired with descriptive alt text.
      operationId: randomImagesWithAlt
      parameters:
      - name: amount
        in: path
        required: true
        description: Number of random images to return.
        schema:
          type: integer
          minimum: 1
        example: 3
      responses:
        '200':
          description: An array of image objects each containing a URL and alt text.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AltImageListResponse'
              examples:
                RandomImagesWithAlt200Example:
                  summary: Default randomImagesWithAlt 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - url: https://images.dog.ceo/breeds/hound-basset/n02088238_2217.jpg
                      altText: Basset hound dog
                    - url: https://images.dog.ceo/breeds/hound-blood/n02088466_6712.jpg
                      altText: Blood hound dog
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/images/alt:
    get:
      tags:
      - Images
      summary: Dog API List Images by Breed With Alt Text
      description: Returns all images for the given master breed paired with descriptive alt text.
      operationId: listImagesByBreedWithAlt
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      responses:
        '200':
          description: An array of image objects each containing a URL and alt text.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AltImageListResponse'
              examples:
                ListImagesByBreedWithAlt200Example:
                  summary: Default listImagesByBreedWithAlt 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - url: https://images.dog.ceo/breeds/hound-basset/n02088238_2217.jpg
                      altText: Basset hound dog
                    - url: https://images.dog.ceo/breeds/hound-blood/n02088466_6712.jpg
                      altText: Blood hound dog
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/images/random/{amount}/alt:
    get:
      tags:
      - Images
      summary: Dog API Multiple Random Images by Breed With Alt Text
      description: Returns multiple random images for the given master breed paired with descriptive alt text.
      operationId: randomImagesByBreedWithAlt
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      - name: amount
        in: path
        required: true
        description: Number of random images to return.
        schema:
          type: integer
          minimum: 1
        example: 3
      responses:
        '200':
          description: An array of image objects each containing a URL and alt text.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AltImageListResponse'
              examples:
                RandomImagesByBreedWithAlt200Example:
                  summary: Default randomImagesByBreedWithAlt 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - url: https://images.dog.ceo/breeds/hound-basset/n02088238_2217.jpg
                      altText: Basset hound dog
                    - url: https://images.dog.ceo/breeds/hound-blood/n02088466_6712.jpg
                      altText: Blood hound dog
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/{subBreed}/images/alt:
    get:
      tags:
      - Images
      summary: Dog API List Images by Sub-Breed With Alt Text
      description: Returns all images for the given sub-breed paired with descriptive alt text.
      operationId: listImagesBySubBreedWithAlt
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      - name: subBreed
        in: path
        required: true
        description: Sub-breed name.
        schema:
          type: string
        example: afghan
      responses:
        '200':
          description: An array of image objects each containing a URL and alt text.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AltImageListResponse'
              examples:
                ListImagesBySubBreedWithAlt200Example:
                  summary: Default listImagesBySubBreedWithAlt 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - url: https://images.dog.ceo/breeds/hound-basset/n02088238_2217.jpg
                      altText: Basset hound dog
                    - url: https://images.dog.ceo/breeds/hound-blood/n02088466_6712.jpg
                      altText: Blood hound dog
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /breed/{breed}/{subBreed}/images/random/{amount}/alt:
    get:
      tags:
      - Images
      summary: Dog API Multiple Random Images by Sub-Breed With Alt Text
      description: Returns multiple random images for the given sub-breed paired with descriptive alt text.
      operationId: randomImagesBySubBreedWithAlt
      parameters:
      - name: breed
        in: path
        required: true
        description: Master breed name.
        schema:
          type: string
        example: hound
      - name: subBreed
        in: path
        required: true
        description: Sub-breed name.
        schema:
          type: string
        example: afghan
      - name: amount
        in: path
        required: true
        description: Number of random images to return.
        schema:
          type: integer
          minimum: 1
        example: 3
      responses:
        '200':
          description: An array of image objects each containing a URL and alt text.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AltImageListResponse'
              examples:
                RandomImagesBySubBreedWithAlt200Example:
                  summary: Default randomImagesBySubBreedWithAlt 200 response
                  x-microcks-default: true
                  value:
                    message:
                    - url: https://images.dog.ceo/breeds/hound-basset/n02088238_2217.jpg
                      altText: Basset hound dog
                    - url: https://images.dog.ceo/breeds/hound-blood/n02088466_6712.jpg
                      altText: Blood hound dog
                    status: success
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    AltImageListResponse:
      type: object
      description: Response envelope returning a list of image objects each containing a URL and alt text.
      required:
      - message
      - status
      properties:
        message:
          type: array
          description: List of image objects with URL and alt text.
          items:
            $ref: '#/components/schemas/AltImage'
        status:
          type: string
          description: Outcome marker; "success" when the request succeeded.
          enum:
          - success
          - error
          example: success
    ImageListResponse:
      type: object
      description: Response envelope returning a list of dog image URLs.
      required:
      - message
      - status
      properties:
        message:
          type: array
          description: List of dog image URLs.
          items:
            type: string
            format: uri
            example: https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
        status:
          type: string
          description: Outcome marker; "success" when the request succeeded.
          enum:
          - success
          - error
          example: success
    AltImage:
      type: object
      description: A dog image URL paired with descriptive alt text suitable for accessibility.
      required:
      - url
      - altText
      properties:
        url:
          type: string
          format: uri
          description: URL of the dog image.
          example: https://images.dog.ceo/breeds/hound-basset/n02088238_2217.jpg
        altText:
          type: string
          description: Human-readable alt text describing the image (typically "{Sub-breed} {breed} dog").
          example: Basset hound dog
    ImageResponse:
      type: object
      description: Response envelope returning a single dog image URL.
      required:
      - message
      - status
      properties:
        message:
          type: string
          format: uri
          description: URL of the dog image.
          example: https://images.dog.ceo/breeds/hound-afghan/n02088094_1003.jpg
        status:
          type: string
          description: Outcome marker; "success" when the request succeeded.
          enum:
          - success
          - error
          example: success