---
descriptions:
  list_organizations:
    domains: >-
      The domains of an Organization. Any Organization with a matching domain
      will be returned.
    data: >-
      Array of [Organizations](/reference/organization) ordered by creation
      time.
reference:
  curl:
    - key: list_organizations
      id: list_organizations
      url: /reference/organization/list
      title: /organizations
      type: GET
      parameters:
        - key: domains
          optional: true
          type: 'string[]'
          description: (list_organizations.domains)
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_organizations.data)
            - key: list_metadata
              type: object
              properties:
                - (before)
                - (after)
  js:
    - key: listOrganizations
      id: list_organizations
      url: /reference/organization/list
      title: organizations.listOrganizations()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: domains
              optional: true
              type: 'string[]'
              description: (list_organizations.domains)
            - (limit)
            - (before)
            - (after)
            - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'Organization[]'
              description: (list_organizations.data)
            - key: listMetadata
              type: object
              properties:
                - (before)
                - (after)
  go:
    - key: ListOrganizations
      id: list_organizations
      url: /reference/organization/list
      title: organizations.ListOrganizations()
      parameters:
        - (ctx)
        - key: opts
          type: organizations.ListOrganizationsOpts
          expanded: true
          properties:
            - key: Domains
              optional: true
              type: '[]string'
              description: (list_organizations.domains)
            - (Limit)
            - (Before)
            - (After)
            - (Order)
      returns:
        - key: list
          type: organizations.ListOrganizationsResponse
          expanded: true
          properties:
            - key: Data
              type: '[]organizations.Organization'
              description: (list_organizations.data)
            - key: ListMetadata
              type: common.ListMetadata
              properties:
                - (Before)
                - (After)
        - (err)
  ruby:
    - key: list_organizations
      id: list_organizations
      url: /reference/organization/list
      title: Organizations.list_organizations()
      parameters:
        - key: domains
          optional: true
          type: 'Array[String]'
          description: (list_organizations.domains)
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: Struct
          unwrap: true
          properties:
            - key: data
              type: 'Array[Organization]'
              description: (list_organizations.data)
            - key: list_metadata
              type: Struct
              properties:
                - (before)
                - (after)
  python:
    - key: list_organizations
      id: list_organizations
      url: /reference/organization/list
      title: organizations.list_organizations()
      parameters:
        - key: domains
          optional: true
          type: 'Sequence[str]'
          description: (list_organizations.domains)
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: WorkOSListResource
          unwrap: true
          properties:
            - key: data
              type: 'list[Organization]'
              description: (list_organizations.data)
            - key: list_metadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
  java:
    - key: listOrganizations
      id: list_organizations
      url: /reference/organization/list
      title: organizations.listOrganizations()
      parameters:
        - key: options
          type: ListOrganizationsOptions
          optional: true
          expanded: true
          properties:
            - key: domains
              optional: true
              type: List<String>
              description: (list_organizations.domains)
            - (after)
            - (before)
            - (limit)
            - (order)
            - key: builder()
              type: ListOrganizationsOptionsBuilder
              description: (java.builder)
      returns:
        - key: organizationList
          type: OrganizationList
          expanded: true
          properties:
            - key: data
              type: List<Organization>
              description: (list_organizations.data)
            - key: listMetadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
  php:
    - key: listOrganizations
      id: list_organizations
      url: /reference/organization/list
      title: $organizations->listOrganizations()
      parameters:
        - key: domains
          type: 'string[]'
          optional: true
          description: (list_organizations.domains)
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: array
          unwrap: true
          properties:
            - (before)
            - (after)
            - key: data
              type: 'Organization[]'
              description: (list_organizations.data)
  dotnet:
    - key: ListOrganizations
      id: list_organizations
      url: /reference/organization/list
      title: organizationsService.ListOrganizations()
      parameters:
        - key: options
          type: ListOrganizationsOptions
          optional: true
          expanded: true
          properties:
            - key: Domains
              optional: true
              type: 'string[]'
              description: (list_organizations.domains)
            - (Limit)
            - (Before)
            - (After)
            - (Order)
        - (cancellationToken)
      returns:
        - key: Task<WorkOSList<Organization>>
          expanded: true
          properties:
            - key: Data
              type: List<Organization>
              description: (list_organizations.data)
            - key: ListMetadata
              type: ListMetadata
              properties:
                - (Before)
                - (After)
originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/list.mdx
---

## List Organizations

Get a list of all of your existing organizations matching the criteria specified.

<CodeBlock referenceId="list_organizations">
  <CodeBlockTab title="Request" file="list-organizations-request" />
  <CodeBlockTab title="Response" file="list-organizations-response" />
</CodeBlock>