cURL
curl "https://acme.orgo.space/api/v1/contacts?isNewsletterSubscribed=true&itemsPerPage=100" \
-H "Api-Token: $ORGO_API_TOKEN"const res = await fetch(
"https://acme.orgo.space/api/v1/contacts?isNewsletterSubscribed=true&itemsPerPage=100",
{ headers: { "Api-Token": process.env.ORGO_API_TOKEN } },
);
$response = $client->get('/api/v1/contacts', [
'headers' => ['Api-Token' => getenv('ORGO_API_TOKEN')],
'query' => [
'isNewsletterSubscribed' => 'true',
'itemsPerPage' => 100,
],
]);
import requests
url = "https://app.orgo.space/api/v1/contacts"
headers = {"Api-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Api-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.orgo.space/api/v1/contacts")
.header("Api-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Api-Token"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 42,
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"country": {
"id": 42,
"name": "Boston Chapter"
},
"isNewsletterSubscribed": true,
"stripeCustomerId": "cus_NhpBuxIyR4Qbpd",
"town": {
"id": 42,
"name": "Boston Chapter",
"country": {
"id": 42,
"name": "Boston Chapter"
}
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"localCenter": {
"id": 42,
"name": "Boston Chapter"
},
"status": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A"
},
"tags": [
{
"id": 42,
"tag": "/api/v1/tags/1"
}
],
"source": "string"
}
]Contact
List contacts
Returns a paginated list of contacts for the current tenant. Requires HR_LOCAL or FINANCIAL_LOCAL permission. Contacts are non-member records used for CRM and outreach purposes. Response is intentionally lean — call GET /contacts/{id} for full contact details.
GET
/
api
/
v1
/
contacts
cURL
curl "https://acme.orgo.space/api/v1/contacts?isNewsletterSubscribed=true&itemsPerPage=100" \
-H "Api-Token: $ORGO_API_TOKEN"const res = await fetch(
"https://acme.orgo.space/api/v1/contacts?isNewsletterSubscribed=true&itemsPerPage=100",
{ headers: { "Api-Token": process.env.ORGO_API_TOKEN } },
);
$response = $client->get('/api/v1/contacts', [
'headers' => ['Api-Token' => getenv('ORGO_API_TOKEN')],
'query' => [
'isNewsletterSubscribed' => 'true',
'itemsPerPage' => 100,
],
]);
import requests
url = "https://app.orgo.space/api/v1/contacts"
headers = {"Api-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/contacts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Api-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.orgo.space/api/v1/contacts")
.header("Api-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Api-Token"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": 42,
"name": "Boston Chapter",
"middleName": "L.",
"email": "james.patterson@example.com",
"phone": "+1 415 555 0142",
"country": {
"id": 42,
"name": "Boston Chapter"
},
"isNewsletterSubscribed": true,
"stripeCustomerId": "cus_NhpBuxIyR4Qbpd",
"town": {
"id": 42,
"name": "Boston Chapter",
"country": {
"id": 42,
"name": "Boston Chapter"
}
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"localCenter": {
"id": 42,
"name": "Boston Chapter"
},
"status": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A"
},
"tags": [
{
"id": 42,
"tag": "/api/v1/tags/1"
}
],
"source": "string"
}
]Authorizations
ApiTokenJWT
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Query Parameters
The collection page number
The number of items per page
Required range:
0 <= x <= 100Available options:
asc, desc Available options:
asc, desc Available options:
asc, desc Available options:
asc, desc Available options:
asc, desc Response
Contact collection
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

