Get a badge assignment
curl --request GET \
--url https://app.orgo.space/api/v1/badge_users/{id} \
--header 'Api-Token: <api-key>'import requests
url = "https://app.orgo.space/api/v1/badge_users/{id}"
headers = {"Api-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'Api-Token': '<api-key>'}};
fetch('https://app.orgo.space/api/v1/badge_users/{id}', 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.orgo.space/api/v1/badge_users/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Api-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.orgo.space/api/v1/badge_users/{id}"
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/badge_users/{id}")
.header("Api-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/badge_users/{id}")
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,
"badge": {
"id": 42,
"name": "Boston Chapter",
"type": {
"id": 42,
"name": "Boston Chapter"
},
"translation": "string",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png",
"referrals": 42,
"kind": "STANDARD",
"userType": {
"id": 42,
"name": "Boston Chapter"
},
"steps": [
{
"id": 42,
"position": 42,
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"translation": "string",
"isOptional": true,
"isArchived": false
}
]
},
"user": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"localCenter": {
"alias": "string",
"id": 42,
"name": "Boston Chapter"
},
"localCenterParent": "/api/v1/units/1",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"commentUser": "Confirmed by phone — will arrive at 10am.",
"commentMaster": "Confirmed by phone — will arrive at 10am.",
"status": 42,
"owner": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"localCenter": {
"alias": "string",
"id": 42,
"name": "Boston Chapter"
},
"localCenterParent": "/api/v1/units/1",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"pointsAtAward": 42,
"badgeUserSteps": [
{
"id": 42,
"step": {
"id": 42,
"position": 42,
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"translation": "string",
"isOptional": true,
"isArchived": false
},
"status": 42,
"note": "Joined via Boston outreach drive.",
"updatedBy": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"localCenter": "/api/v1/local_centers/1",
"localCenterParent": "/api/v1/units/1",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00"
}
],
"stepsProgress": [
"string"
]
}BadgeUser
Get a badge assignment
Retrieves a single badge assignment record by ID, showing which user holds which badge and when it was awarded.
GET
/
api
/
v1
/
badge_users
/
{id}
Get a badge assignment
curl --request GET \
--url https://app.orgo.space/api/v1/badge_users/{id} \
--header 'Api-Token: <api-key>'import requests
url = "https://app.orgo.space/api/v1/badge_users/{id}"
headers = {"Api-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'Api-Token': '<api-key>'}};
fetch('https://app.orgo.space/api/v1/badge_users/{id}', 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.orgo.space/api/v1/badge_users/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Api-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.orgo.space/api/v1/badge_users/{id}"
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/badge_users/{id}")
.header("Api-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/badge_users/{id}")
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,
"badge": {
"id": 42,
"name": "Boston Chapter",
"type": {
"id": 42,
"name": "Boston Chapter"
},
"translation": "string",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png",
"referrals": 42,
"kind": "STANDARD",
"userType": {
"id": 42,
"name": "Boston Chapter"
},
"steps": [
{
"id": 42,
"position": 42,
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"translation": "string",
"isOptional": true,
"isArchived": false
}
]
},
"user": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"localCenter": {
"alias": "string",
"id": 42,
"name": "Boston Chapter"
},
"localCenterParent": "/api/v1/units/1",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"commentUser": "Confirmed by phone — will arrive at 10am.",
"commentMaster": "Confirmed by phone — will arrive at 10am.",
"status": 42,
"owner": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"localCenter": {
"alias": "string",
"id": 42,
"name": "Boston Chapter"
},
"localCenterParent": "/api/v1/units/1",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"pointsAtAward": 42,
"badgeUserSteps": [
{
"id": 42,
"step": {
"id": 42,
"position": 42,
"title": "Volunteer Coordinator",
"description": "Quarterly chapter meeting open to all members.",
"translation": "string",
"isOptional": true,
"isArchived": false
},
"status": 42,
"note": "Joined via Boston outreach drive.",
"updatedBy": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"localCenter": "/api/v1/local_centers/1",
"localCenterParent": "/api/v1/units/1",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"dateCreated": "2026-01-15T10:30:00+00:00",
"dateUpdated": "2026-01-15T10:30:00+00:00"
}
],
"stepsProgress": [
"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.
Path Parameters
BadgeUser identifier
Response
BadgeUser resource
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

