---
updatedAt: 2026-05-28T12:50:37.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/artifactory/llms.txt
---

# Get Batch of Repositories by Name

Returns a batch of repositories defined by name. The default batch size is 100 items (configurable).

**Since:** 7.84.3

**Security:** Requires an admin user for complete repository configuration. Non-admin users receive only partial configuration data.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "JFrog Artifactory Repositories API",
    "description": "REST API for managing repositories in JFrog Artifactory, including local, remote, virtual, and federated repositories.\n\nAdditional repository settings may exist in future product releases; clients should accept unknown JSON properties and tolerate fields not listed in this specification.\n\nAdditional examples of repository configuration are available at:\nhttps://docs.jfrog.com/integrations/docs/configuration-json-files#repository-configuration-json\n",
    "version": "1.0.0",
    "contact": {
      "name": "JFrog Support"
    }
  },
  "servers": [
    {
      "url": "https://{jfrog_url}/artifactory/api",
      "description": "JFrog Platform",
      "variables": {
        "jfrog_url": {
          "default": "myserver.jfrog.io",
          "description": "Your JFrog Platform hostname (e.g., mycompany.jfrog.io)"
        }
      }
    }
  ],
  "tags": [
    {
      "name": "Repositories",
      "description": "Repository management operations"
    }
  ],
  "paths": {
    "/v2/repositories/batch": {
      "get": {
        "tags": [
          "Repositories"
        ],
        "summary": "Get Batch of Repositories by Name",
        "description": "Returns a batch of repositories defined by name. The default batch size is 100 items (configurable).\n\n**Since:** 7.84.3\n\n**Security:** Requires an admin user for complete repository configuration. Non-admin users receive only partial configuration data.\n",
        "operationId": "getBatchOfRepositoriesByName",
        "parameters": [
          {
            "name": "names",
            "in": "query",
            "required": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "The repository names to return"
          }
        ],
        "responses": {
          "200": {
            "description": "Map of repository key to full repository configuration object (one object per requested name). Configurations match the repository class of each entry (local, remote, virtual, federated, and so on).\n",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "$ref": "#/components/schemas/RepositoryConfiguration"
                  }
                },
                "examples": {
                  "batchByName": {
                    "summary": "Two local Docker repositories (from handbook sample)",
                    "value": {
                      "wproj-dev-docker-local-1": {
                        "key": "wproj-dev-docker-local-1",
                        "packageType": "docker",
                        "description": "",
                        "notes": "",
                        "includesPattern": "**/*",
                        "excludesPattern": "",
                        "rclass": "local"
                      },
                      "wproj-dev-docker-local-2": {
                        "key": "wproj-dev-docker-local-2",
                        "packageType": "docker",
                        "description": "",
                        "notes": "",
                        "includesPattern": "**/*",
                        "excludesPattern": "",
                        "rclass": "local"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request — repository keys are missing or repository item limit exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Bad Credentials — the provided authentication is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "Permission Denied — the user does not have the necessary permissions to perform this action.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "BasicAuth": []
    },
    {
      "ApiKeyAuth": []
    },
    {
      "BearerAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "BasicAuth": {
        "type": "http",
        "scheme": "basic"
      },
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-JFrog-Art-Api"
      },
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "schemas": {
      "ErrorResponse": {
        "description": "Standard Artifactory error JSON: HTTP status and message per error entry.\n",
        "type": "object",
        "required": [
          "errors"
        ],
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "status",
                "message"
              ],
              "properties": {
                "status": {
                  "type": "integer"
                },
                "message": {
                  "type": "string"
                }
              }
            }
          }
        },
        "example": {
          "errors": [
            {
              "status": 404,
              "message": "File not found."
            }
          ]
        }
      },
      "RepositoryConfiguration": {
        "description": "Union of local, remote, virtual, or federated repository configuration (`rclass`). Choose the schema that matches `rclass`; each defines its own `packageType` enumeration and field set.\n",
        "oneOf": [
          {
            "$ref": "#/components/schemas/LocalRepositoryConfiguration"
          },
          {
            "$ref": "#/components/schemas/RemoteRepositoryConfiguration"
          },
          {
            "$ref": "#/components/schemas/VirtualRepositoryConfiguration"
          },
          {
            "$ref": "#/components/schemas/FederatedRepositoryConfiguration"
          }
        ],
        "discriminator": {
          "propertyName": "rclass",
          "mapping": {
            "local": "#/components/schemas/LocalRepositoryConfiguration",
            "remote": "#/components/schemas/RemoteRepositoryConfiguration",
            "virtual": "#/components/schemas/VirtualRepositoryConfiguration",
            "federated": "#/components/schemas/FederatedRepositoryConfiguration"
          }
        }
      },
      "PackageTypeLocal": {
        "description": "Allowed `packageType` values for **local** repositories.",
        "type": "string",
        "enum": [
          "alpine",
          "cargo",
          "composer",
          "bower",
          "chef",
          "cocoapods",
          "conan",
          "conda",
          "cran",
          "debian",
          "docker",
          "helm",
          "helmoci",
          "huggingfaceml",
          "gems",
          "gitlfs",
          "go",
          "gradle",
          "ivy",
          "maven",
          "npm",
          "nuget",
          "oci",
          "opkg",
          "pub",
          "puppet",
          "pypi",
          "rpm",
          "sbt",
          "swift",
          "terraform",
          "terraformbackend",
          "vagrant",
          "ansible",
          "generic"
        ]
      },
      "PackageTypeRemote": {
        "description": "Allowed `packageType` values for **remote** repositories (not identical to the local list).",
        "type": "string",
        "enum": [
          "alpine",
          "cargo",
          "composer",
          "bower",
          "chef",
          "cocoapods",
          "conan",
          "conda",
          "cran",
          "debian",
          "docker",
          "helm",
          "helmoci",
          "huggingfaceml",
          "gems",
          "gitlfs",
          "go",
          "gradle",
          "ivy",
          "maven",
          "npm",
          "nuget",
          "oci",
          "opkg",
          "pub",
          "puppet",
          "pypi",
          "rpm",
          "sbt",
          "swift",
          "terraform",
          "ansible",
          "generic"
        ]
      },
      "PackageTypeVirtual": {
        "description": "Allowed `packageType` values for **virtual** repositories.",
        "type": "string",
        "enum": [
          "alpine",
          "composer",
          "bower",
          "chef",
          "conan",
          "conda",
          "cran",
          "debian",
          "docker",
          "helm",
          "helmoci",
          "huggingfaceml",
          "gems",
          "gitlfs",
          "go",
          "gradle",
          "ivy",
          "maven",
          "npm",
          "nuget",
          "oci",
          "pub",
          "puppet",
          "pypi",
          "rpm",
          "sbt",
          "swift",
          "terraform",
          "ansible",
          "generic"
        ]
      },
      "PackageTypeFederated": {
        "description": "Allowed `packageType` values for **federated** repositories.",
        "type": "string",
        "enum": [
          "alpine",
          "maven",
          "gradle",
          "ivy",
          "sbt",
          "helm",
          "helmoci",
          "huggingfaceml",
          "cargo",
          "cocoapods",
          "opkg",
          "rpm",
          "nuget",
          "cran",
          "gems",
          "npm",
          "bower",
          "debian",
          "composer",
          "oci",
          "pypi",
          "docker",
          "vagrant",
          "gitlfs",
          "go",
          "ansible",
          "conan",
          "conda",
          "chef",
          "puppet",
          "generic"
        ]
      },
      "ChecksumPolicyType": {
        "description": "Checksum policy (local and federated repository configuration).",
        "type": "string",
        "enum": [
          "client-checksums",
          "server-generated-checksums"
        ]
      },
      "RemoteRepoChecksumPolicyType": {
        "description": "Remote repository checksum policy (Remote Repository configuration).",
        "type": "string",
        "enum": [
          "generate-if-absent",
          "fail",
          "ignore-and-generate",
          "pass-thru"
        ]
      },
      "PomRepositoryReferencesCleanupPolicy": {
        "description": "POM repository references cleanup (Virtual Repository configuration).",
        "type": "string",
        "enum": [
          "discard_active_reference",
          "discard_any_reference",
          "nothing"
        ]
      },
      "LocalRepositoryConfiguration": {
        "description": "**Local** repository configuration JSON. Vendor media type `application/vnd.org.jfrog.artifactory.repositories.LocalRepositoryConfiguration+json`. Required vs optional fields and defaults are described on each property below.\n",
        "type": "object",
        "required": [
          "key",
          "rclass"
        ],
        "properties": {
          "key": {
            "type": "string",
            "description": "Repository key (mandatory on create)."
          },
          "rclass": {
            "type": "string",
            "enum": [
              "local"
            ],
            "description": "Must be `local`."
          },
          "projectKey": {
            "type": "string",
            "description": "Project key; when assigning the repo to a project, `environments` is mandatory."
          },
          "environments": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mandatory when assigning repository to a project."
          },
          "packageType": {
            "$ref": "#/components/schemas/PackageTypeLocal"
          },
          "description": {
            "type": "string",
            "description": "Public description of the repository."
          },
          "notes": {
            "type": "string",
            "description": "Internal notes."
          },
          "includesPattern": {
            "type": "string",
            "description": "Default `**/*`; empty string also includes everything."
          },
          "excludesPattern": {
            "type": "string"
          },
          "repoLayoutRef": {
            "type": "string",
            "description": "Default `maven-2-default` where applicable."
          },
          "debianTrivialLayout": {
            "type": "boolean"
          },
          "checksumPolicyType": {
            "$ref": "#/components/schemas/ChecksumPolicyType"
          },
          "handleReleases": {
            "type": "boolean",
            "description": "Default true."
          },
          "handleSnapshots": {
            "type": "boolean",
            "description": "Default true."
          },
          "maxUniqueSnapshots": {
            "type": "integer"
          },
          "maxUniqueTags": {
            "type": "integer"
          },
          "snapshotVersionBehavior": {
            "type": "string",
            "enum": [
              "unique",
              "non-unique",
              "deployer"
            ],
            "description": "Maven SNAPSHOT naming; default `unique` from 7.41 (affects local and federated)."
          },
          "suppressPomConsistencyChecks": {
            "type": "boolean"
          },
          "blackedOut": {
            "type": "boolean"
          },
          "xrayIndex": {
            "type": "boolean"
          },
          "propertySets": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "archiveBrowsingEnabled": {
            "type": "boolean"
          },
          "calculateYumMetadata": {
            "type": "boolean"
          },
          "yumRootDepth": {
            "type": "integer"
          },
          "dockerApiVersion": {
            "type": "string",
            "enum": [
              "V2"
            ],
            "description": "Default V2 (Docker API version)."
          },
          "terraformType": {
            "type": "string",
            "enum": [
              "MODULE",
              "PROVIDER"
            ]
          },
          "enableFileListsIndexing": {
            "type": "string"
          },
          "optionalIndexCompressionFormats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "downloadRedirect": {
            "type": "string"
          },
          "cdnRedirect": {
            "type": "string",
            "description": "Artifactory Cloud; Enterprise or Enterprise+ license when enabled."
          },
          "blockPushingSchema1": {
            "type": "string"
          },
          "primaryKeyPairRef": {
            "type": "string"
          },
          "secondaryKeyPairRef": {
            "type": "string"
          },
          "forceNugetAuthentication": {
            "type": "boolean"
          },
          "forceP2Authentication": {
            "type": "boolean"
          },
          "forceConanAuthentication": {
            "type": "boolean"
          },
          "encryptStates": {
            "type": "boolean"
          },
          "priorityResolution": {
            "type": "string",
            "description": "Default false; applies to all repository types excluding CocoaPods, Git LFS, NuGet V2, Opkg, Rust, Vagrant, VCS."
          },
          "contentSynchronisation": {
            "type": "object",
            "description": "Smart Remote Repository; set `enabled` under this object.",
            "additionalProperties": true
          }
        }
      },
      "RemoteRepositoryConfiguration": {
        "description": "**Remote** repository configuration JSON. Vendor media type `application/vnd.org.jfrog.artifactory.repositories.RemoteRepositoryConfiguration+json`. `url` is mandatory; `packageType` uses the **remote** enumeration (not the same as local).\n",
        "type": "object",
        "required": [
          "key",
          "rclass",
          "url"
        ],
        "properties": {
          "key": {
            "type": "string",
            "description": "Repository key (mandatory on create)."
          },
          "rclass": {
            "type": "string",
            "enum": [
              "remote"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Upstream repository URL (mandatory)."
          },
          "projectKey": {
            "type": "string"
          },
          "environments": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mandatory when assigning repository to a project."
          },
          "packageType": {
            "$ref": "#/components/schemas/PackageTypeRemote"
          },
          "username": {
            "type": "string"
          },
          "password": {
            "type": "string"
          },
          "proxy": {
            "type": "string"
          },
          "disableProxy": {
            "type": "boolean",
            "description": "Default false."
          },
          "description": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "includesPattern": {
            "type": "string"
          },
          "excludesPattern": {
            "type": "string"
          },
          "repoLayoutRef": {
            "type": "string"
          },
          "remoteRepoLayoutRef": {
            "type": "string"
          },
          "remoteRepoChecksumPolicyType": {
            "$ref": "#/components/schemas/RemoteRepoChecksumPolicyType"
          },
          "handleReleases": {
            "type": "boolean"
          },
          "handleSnapshots": {
            "type": "boolean"
          },
          "maxUniqueSnapshots": {
            "type": "integer"
          },
          "suppressPomConsistencyChecks": {
            "type": "boolean"
          },
          "hardFail": {
            "type": "boolean"
          },
          "offline": {
            "type": "boolean"
          },
          "blackedOut": {
            "type": "boolean"
          },
          "storeArtifactsLocally": {
            "type": "boolean"
          },
          "socketTimeoutMillis": {
            "type": "integer"
          },
          "localAddress": {
            "type": "string"
          },
          "retrievalCachePeriodSecs": {
            "type": "integer"
          },
          "missedRetrievalCachePeriodSecs": {
            "type": "integer"
          },
          "unusedArtifactsCleanupPeriodHours": {
            "type": "integer"
          },
          "assumedOfflinePeriodSecs": {
            "type": "integer"
          },
          "fetchJarsEagerly": {
            "type": "boolean"
          },
          "fetchSourcesEagerly": {
            "type": "boolean"
          },
          "shareConfiguration": {
            "type": "boolean"
          },
          "synchronizeProperties": {
            "type": "boolean"
          },
          "blockMismatchingMimeTypes": {
            "type": "boolean"
          },
          "xrayIndex": {
            "type": "boolean"
          },
          "propertySets": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "allowAnyHostAuth": {
            "type": "boolean"
          },
          "enableCookieManagement": {
            "type": "boolean"
          },
          "enableTokenAuthentication": {
            "type": "boolean"
          },
          "contentSynchronisation": {
            "type": "object",
            "description": "Smart Remote Repository; `enabled` flag under this object.",
            "additionalProperties": true
          }
        }
      },
      "VirtualRepositoryConfiguration": {
        "description": "**Virtual** repository configuration JSON. Vendor media type `application/vnd.org.jfrog.artifactory.repositories.VirtualRepositoryConfiguration+json`. `repositories` lists underlying repo keys; `packageType` uses the **virtual** enumeration.\n",
        "type": "object",
        "required": [
          "key",
          "rclass",
          "repositories"
        ],
        "properties": {
          "key": {
            "type": "string",
            "description": "Repository key (mandatory on create)."
          },
          "rclass": {
            "type": "string",
            "enum": [
              "virtual"
            ]
          },
          "projectKey": {
            "type": "string"
          },
          "environments": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mandatory when assigning repository to a project."
          },
          "packageType": {
            "$ref": "#/components/schemas/PackageTypeVirtual"
          },
          "repositories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Keys of local, remote, and/or virtual repositories aggregated by this virtual repo."
          },
          "description": {
            "type": "string"
          },
          "notes": {
            "type": "string"
          },
          "includesPattern": {
            "type": "string"
          },
          "excludesPattern": {
            "type": "string"
          },
          "repoLayoutRef": {
            "type": "string"
          },
          "debianTrivialLayout": {
            "type": "boolean"
          },
          "debianDefaultArchitectures": {
            "type": "string",
            "description": "Debian-only; e.g. `arm64,amd64`."
          },
          "artifactoryRequestsCanRetrieveRemoteArtifacts": {
            "type": "boolean"
          },
          "keyPair": {
            "type": "string"
          },
          "pomRepositoryReferencesCleanupPolicy": {
            "$ref": "#/components/schemas/PomRepositoryReferencesCleanupPolicy"
          },
          "defaultDeploymentRepo": {
            "type": "string"
          },
          "optionalIndexCompressionFormats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "forceMavenAuthentication": {
            "type": "boolean"
          },
          "externalDependenciesEnabled": {
            "type": "boolean"
          },
          "externalDependenciesPatterns": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "externalDependenciesRemoteRepo": {
            "type": "string"
          },
          "primaryKeyPairRef": {
            "type": "string"
          },
          "secondaryKeyPairRef": {
            "type": "string"
          }
        }
      },
      "FederatedRepositoryConfiguration": {
        "description": "**Federated** repository configuration JSON. Vendor media type `application/vnd.org.jfrog.artifactory.repositories.FederatedRepositoryConfiguration+json`. `packageType` uses the **federated** enumeration (distinct from local/remote/virtual). Each federated member needs a `url` and `enabled` state.\n",
        "type": "object",
        "required": [
          "key",
          "rclass"
        ],
        "properties": {
          "key": {
            "type": "string",
            "description": "Repository key (mandatory on create)."
          },
          "rclass": {
            "type": "string",
            "enum": [
              "federated"
            ]
          },
          "projectKey": {
            "type": "string"
          },
          "environments": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Mandatory when assigning repository to a project."
          },
          "packageType": {
            "$ref": "#/components/schemas/PackageTypeFederated"
          },
          "members": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "Full URL to the federation member repository; may be auto-added from base URL and `key` if omitted."
                },
                "enabled": {
                  "type": "string",
                  "description": "Member active state; defaults to `\"true\"`; supported to change own member’s enabled status."
                }
              }
            }
          },
          "description": {
            "type": "string"
          },
          "proxy": {
            "type": "string"
          },
          "disableProxy": {
            "type": "boolean"
          },
          "notes": {
            "type": "string"
          },
          "includesPattern": {
            "type": "string"
          },
          "excludesPattern": {
            "type": "string"
          },
          "repoLayoutRef": {
            "type": "string"
          },
          "debianTrivialLayout": {
            "type": "boolean"
          },
          "checksumPolicyType": {
            "$ref": "#/components/schemas/ChecksumPolicyType"
          },
          "handleReleases": {
            "type": "boolean"
          },
          "handleSnapshots": {
            "type": "boolean"
          },
          "maxUniqueSnapshots": {
            "type": "integer"
          },
          "maxUniqueTags": {
            "type": "integer"
          },
          "snapshotVersionBehavior": {
            "type": "string",
            "enum": [
              "unique",
              "non-unique",
              "deployer"
            ]
          },
          "suppressPomConsistencyChecks": {
            "type": "boolean"
          },
          "blackedOut": {
            "type": "boolean"
          },
          "xrayIndex": {
            "type": "boolean"
          },
          "propertySets": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "archiveBrowsingEnabled": {
            "type": "boolean"
          },
          "calculateYumMetadata": {
            "type": "boolean"
          },
          "yumRootDepth": {
            "type": "integer"
          },
          "dockerApiVersion": {
            "type": "string",
            "enum": [
              "V2"
            ]
          },
          "enableFileListsIndexing": {
            "type": "string"
          },
          "optionalIndexCompressionFormats": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "downloadRedirect": {
            "type": "string"
          },
          "cdnRedirect": {
            "type": "string"
          },
          "blockPushingSchema1": {
            "type": "string"
          },
          "primaryKeyPairRef": {
            "type": "string"
          },
          "secondaryKeyPairRef": {
            "type": "string"
          },
          "priorityResolution": {
            "type": "boolean",
            "description": "Default false (federated repository configuration)."
          }
        }
      }
    }
  }
}
```