# List registries

Lists all the registries.

Endpoint: GET /har/api/v1/spaces/{space_ref}/registries
Version: 1.0
Security: x-api-key

## Path parameters:

  - `space_ref` (string, required)
    Reference to the scope in which the registry exists.

Format depends on the scope:

- : 
- : 
- : 

The  suffix is used internally to route scoped requests.
It must be included  in the URL.

## Query parameters:

  - `package_type` (array)
    Registry Package Type

  - `type` (string)
    Registry Type
    Enum: "VIRTUAL", "UPSTREAM"

  - `page` (integer)
    Current page number

  - `size` (integer)
    Number of items per page

  - `sort_order` (string)
    sortOrder

  - `sort_field` (string)
    sortField

  - `search_term` (string)
    search Term.

  - `recursive` (boolean)
    Whether to list registries recursively.

 Use the new  parameter.

*   → 
*  →

  - `scope` (string)
    – current space  all parent spaces   *  – current space  all child spaces  
If omitted,  is assumed.
    Enum: "ancestors", "descendants", "none"

## Response 200 fields (application/json):

  - `data` (object, required)
    A list of Harness Artifact Registries

  - `data.itemCount` (integer)
    The total number of items
    Example: 1

  - `data.pageCount` (integer)
    The total number of pages
    Example: 100

  - `data.pageIndex` (integer)
    The current page

  - `data.pageSize` (integer)
    The number of items per page
    Example: 1

  - `data.registries` (array, required)
    A list of Harness Artifact Registries

  - `data.registries.artifactsCount` (integer)

  - `data.registries.description` (string)

  - `data.registries.downloadsCount` (integer)

  - `data.registries.identifier` (string, required)

  - `data.registries.labels` (array)

  - `data.registries.lastModified` (string)

  - `data.registries.packageType` (string, required)
    refers to package
    Enum: "DOCKER", "MAVEN", "PYTHON", "GENERIC", "HELM", "NUGET", "NPM", "RPM", "CARGO", "GO", "HUGGINGFACE"

  - `data.registries.path` (string)

  - `data.registries.registrySize` (string)

  - `data.registries.type` (string, required)
    refers to type of registry i.e virtual or upstream
    Enum: "VIRTUAL", "UPSTREAM"

  - `data.registries.url` (string, required)

  - `status` (string, required)
    Indicates if the request was successful or not
    Enum: "SUCCESS", "FAILURE", "ERROR"

## Response 400 fields (application/json):

  - `code` (string, required)
    The http error code
    Example: "404"

  - `details` (object)
    Additional details about the error

  - `message` (string, required)
    The reason the request failed

## Response 401 fields (application/json):

  - `code` (string, required)
    The http error code
    Example: "404"

  - `details` (object)
    Additional details about the error

  - `message` (string, required)
    The reason the request failed

## Response 403 fields (application/json):

  - `code` (string, required)
    The http error code
    Example: "404"

  - `details` (object)
    Additional details about the error

  - `message` (string, required)
    The reason the request failed

## Response 404 fields (application/json):

  - `code` (string, required)
    The http error code
    Example: "404"

  - `details` (object)
    Additional details about the error

  - `message` (string, required)
    The reason the request failed

## Response 500 fields (application/json):

  - `code` (string, required)
    The http error code
    Example: "404"

  - `details` (object)
    Additional details about the error

  - `message` (string, required)
    The reason the request failed