# List managed organisations

**GET /organisations**

**Partner organisations only.** A Payroll organisation calling this
endpoint receives `405 Method Not Allowed`. An employer-scoped access
token receives `403 Forbidden`.

Returns the managed organisations your Partner organisation has created,
newest first.



## Servers
- https://payroll-api.getpenfold.dev/v4: https://payroll-api.getpenfold.dev/v4 ()


## Authentication methods
- O auth2 client credentials


## Parameters


### Query parameters

- **page_size** (integer)
  The maximum number of managed organisations to return per page.

- **page_number** (integer)
  The page number to return in the list of managed organisations.



## Responses
### 200
List of managed organisations retrieved successfully.

#### Body: application/json (object)
- **page_number** (integer)
  The current page number.

- **page_size** (integer)
  The number of managed organisations per page.

- **total_items** (integer)
  The total number of managed organisations available.

- **items** (array[object])
  An array of managed organisation objects on the current page.


### 400
Bad request, `page_size` or `page_number` is out of range.

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.


### 401
Unauthorized

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.


### 403
Forbidden, the access token is scoped to an employer.

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.


### 405
Method not allowed

#### Body: application/json (object)
- **error** (string)
  A descriptive error message.



[Powered by Bump.sh](https://bump.sh)