# List organizations [Beta]

Retrieves the information of the organizations.

Endpoint: GET /v1/orgs
Version: 1.0
Security: x-api-key

## Query parameters:

  - `org` (array)
    Identifier field of the organizations the resource is scoped to

  - `search_term` (string)
    This would be used to filter resources having attributes matching with search term.

  - `page` (integer)
    Pagination page number strategy: Specify the page number within the paginated collection related to the number of items in each page

  - `limit` (integer)
    Number of items to return per page.

  - `sort` (string)
    Parameter on the basis of which sorting is done.
    Enum: "name", "identifier", "created", "updated"

  - `order` (string)
    Order on the basis of which sorting is done.
    Enum: "ASC", "DESC"

## Header parameters:

  - `Harness-Account` (string)
    Identifier field of the account the resource is scoped to. This is required for Authorization methods other than the x-api-key header. If you are using the x-api-key header, this can be skipped.

## Response 200 fields (application/json):

  - `org` (object)
    Organization model

  - `org.identifier` (string, required)
    Organization identifier

  - `org.name` (string, required)
    Organization name

  - `org.description` (string)
    Organization description

  - `org.tags` (object)
    Organization tags

  - `created` (integer)
    Creation timestamp for organization

  - `updated` (integer)
    Updated timestamp for organization

  - `harness_managed` (boolean)
    This indicates if this organization is managed by Harness or not. If true, Harness can manage and modify this organization.


