Get all¶
Get all user administered or owned organizations.
GET https://api.tedee.com/api/v1.30/organization?dataScope={dataScope}&page={page}&itemsPerPage={itemsPerPage}&filters.Text={textFilter}&filters.HaveLocks={haveLocksFilter}
URI Parameters
| Name | Type | Description |
|---|---|---|
| page | number (optional) | page number |
| itemsPerPage | number (optional) | number of elements to load (max 200, default 200) |
| filters.Text | string (optional) | filtering by organization name |
| filters.HaveLocks | bool (optional) | filtering by organization where at least one lock is assigned |
| dataScope | number (optional) | data scope (0: all data, 1:minimal data loaded ) |
Responses¶
| Name | Type | Description |
|---|---|---|
| 200 OK | Organizations [] | successful operation |
Scopes¶
| Name | Description |
|---|---|
| Organization.Read | Grants the ability to view organizations. |
| Organization.ReadWrite | Grants the ability to manage organizations. |
Examples¶
Sample request
curl -X GET "https://api.tedee.com/api/v1.30/organization" -H "accept: application/json" -H "Content-Type: application/json-patch+json" -H "Authorization: Bearer <<access token>>" -d "<<body>>"
Sample response
HTTP status code: 200
{
"result": {
"organizations": [
{
"id": 1,
"name": "Organization 1",
"ownerName": "Owner",
"description": "Sample organization",
"logo": "https://example.com/logo.png",
"color": "#007bff",
"initials": "O1",
"slug": "organization-1",
"bridgesCount": 5,
"locksCount": 10,
"organizationRole": 1
},
{
"id": 2,
"name": "Organization 2",
"ownerName": "Another Owner",
"description": "Another organization",
"logo": "https://example.com/logo2.png",
"color": "#dc3545",
"initials": "O2",
"slug": "organization-2",
"bridgesCount": 3,
"locksCount": 7,
"organizationRole": 1
}
]
}
"success": true,
"errorMessages": [],
"statusCode": 200
}