curl --request GET \
--url https://app.aegister.com/api/v1/organizations \
--header 'X-Aegister-Token: <api-key>'import requests
url = "https://app.aegister.com/api/v1/organizations"
headers = {"X-Aegister-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Aegister-Token': '<api-key>'}};
fetch('https://app.aegister.com/api/v1/organizations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.aegister.com/api/v1/organizations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Aegister-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.aegister.com/api/v1/organizations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Aegister-Token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.aegister.com/api/v1/organizations")
.header("X-Aegister-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.aegister.com/api/v1/organizations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Aegister-Token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"error": 0,
"messages": [],
"total": 20,
"data": [
{
"id": 5,
"name": "Sample Organization",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer et posuere erat. Phasellus iaculis metus mauris, quis accumsan felis fermentum at.",
"ips": [
"11.22.33.44"
],
"logo": "https://sample.com/logo.svg",
"domains": [
"sample.com"
],
"website": "https://sample.com",
"sectors": [
"Agriculture"
],
"industries": [
"Accounting"
],
"nis2_sector": "",
"compliance_frameworks": [
{
"value": "ISO 27001:2023",
"fields": {
"extensions": [
"ISO 27017:2021"
]
}
},
{
"value": "NIS2",
"fields": {
"entity_type": "important"
}
}
],
"infrastructure": "cloud",
"number_employees": 10,
"contacts": [
{
"name": "John Doe",
"role": "Supervisor",
"email": "jdoe@mail.com",
"phone": "3333333333",
"email_report": true
}
]
}
]
}List organizations
Retrieve Organization list. The list contains only Organizations the current authenticated user is part of.
curl --request GET \
--url https://app.aegister.com/api/v1/organizations \
--header 'X-Aegister-Token: <api-key>'import requests
url = "https://app.aegister.com/api/v1/organizations"
headers = {"X-Aegister-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Aegister-Token': '<api-key>'}};
fetch('https://app.aegister.com/api/v1/organizations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.aegister.com/api/v1/organizations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Aegister-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.aegister.com/api/v1/organizations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Aegister-Token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.aegister.com/api/v1/organizations")
.header("X-Aegister-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.aegister.com/api/v1/organizations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Aegister-Token"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"error": 0,
"messages": [],
"total": 20,
"data": [
{
"id": 5,
"name": "Sample Organization",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer et posuere erat. Phasellus iaculis metus mauris, quis accumsan felis fermentum at.",
"ips": [
"11.22.33.44"
],
"logo": "https://sample.com/logo.svg",
"domains": [
"sample.com"
],
"website": "https://sample.com",
"sectors": [
"Agriculture"
],
"industries": [
"Accounting"
],
"nis2_sector": "",
"compliance_frameworks": [
{
"value": "ISO 27001:2023",
"fields": {
"extensions": [
"ISO 27017:2021"
]
}
},
{
"value": "NIS2",
"fields": {
"entity_type": "important"
}
}
],
"infrastructure": "cloud",
"number_employees": 10,
"contacts": [
{
"name": "John Doe",
"role": "Supervisor",
"email": "jdoe@mail.com",
"phone": "3333333333",
"email_report": true
}
]
}
]
}Authorizations
Query Parameters
Filter organizations that authenticated user can edit.
Filter organizations by industry.
Max number of reponse items.
Filter by organization name.
Checks if Organization's name contains this value.
This filter is case insensitive.
Filter organizations by NIS 2 sector slug.
Offset response items.
Order results by item field.
Filter organizations that authenticated user owns.
Filter organizations by sector.
Response
Any value different from 0 indicates an error.
More details can be found in messages.
0 <= x <= 00
If error is 1, contains zero or more details on the error.
[]
Total number of items that meet the list filter.
This doesn't represent the number of items inside the data array.
x >= 020
30
40
Show child attributes
Show child attributes

