Genealogy

Read recorded relationship for company access

Company admin tier and members.view (or users.view) permission are required. Droplet tokens are not supported. Returns only recorded relationships; historical rank, volume and profile values are not inferred. Reads use the primary database. The example uses illustrative fixture IDs. Substitute records visible to your authenticated company or member. Omitting as_of also returns children_count, downline_count, and counts_as_of in the same database observation. Counts include retained structural seats belonging to discarded members, so they can exceed the visible page lists. Current subjects must have a kept member; missing or discarded subjects return 404. Explicit as_of reads omit counts; historical counts are not inferred. A current read can return 422 lookup_too_large on timeout or counter_inconsistent for a negative complete balance.

GET

api

company

v2026-10

genealogy

nodes

{id}

Read recorded relationship for company access

curl -X GET 'https://api.fluid.app/api/company/v2026-10/genealogy/nodes/01a08944-f0a6-7977-9ea8-6a9d8245340f?as_of=2026-09-10T03%3A03%3A11.782708Z' \
  -H 'Authorization: Bearer <company-token>'

import requests

url = "https://api.fluid.app/api/company/v2026-10/genealogy/nodes/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fluid.app/api/company/v2026-10/genealogy/nodes/{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://api.fluid.app/api/company/v2026-10/genealogy/nodes/{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 => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.fluid.app/api/company/v2026-10/genealogy/nodes/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/company/v2026-10/genealogy/nodes/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "node": {
    "id": "01a08944-f0a6-7977-9ea8-6a9d8245340f",
    "effective_at": "2026-09-10T03:03:11.782708Z",
    "ended_at": "2026-09-10T03:03:12.000000Z",
    "leg": null,
    "member_id": "d96dec6b-07b3-5c76-bf43-5d9fedf54914",
    "parent_node_id": "01a08944-f09e-75ca-a913-0bfab6c7bd9d",
    "tree_id": "7096ad49-7117-53f6-8f7f-4805473d14c5"
  },
  "status": 200,
  "meta": {
    "request_uuid": null,
    "timestamp": "2026-09-10T03:03:12Z"
  }
}

Authorizations

Authorization

string

header

required

Company admin or company service token, subject to developer permissions.

Path Parameters

string<uuid>

required

Node identifier in the authenticated company.

Query Parameters

as_of

string<date-time>

Read the placement containing this instant; omit for the current placement. Intervals include their start and exclude their end.

Response

Recorded relationship.

Option 1
Option 2

Current requests include structural counts; explicit as_of requests retain the historical shape without counts.

status

integer

required

node

object

required

Show child attributes

meta

object

required

Show child attributes

Read recorded relationship for company access

curl -X GET 'https://api.fluid.app/api/company/v2026-10/genealogy/nodes/01a08944-f0a6-7977-9ea8-6a9d8245340f?as_of=2026-09-10T03%3A03%3A11.782708Z' \
  -H 'Authorization: Bearer <company-token>'

import requests

url = "https://api.fluid.app/api/company/v2026-10/genealogy/nodes/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fluid.app/api/company/v2026-10/genealogy/nodes/{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://api.fluid.app/api/company/v2026-10/genealogy/nodes/{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 => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.fluid.app/api/company/v2026-10/genealogy/nodes/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fluid.app/api/company/v2026-10/genealogy/nodes/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "node": {
    "id": "01a08944-f0a6-7977-9ea8-6a9d8245340f",
    "effective_at": "2026-09-10T03:03:11.782708Z",
    "ended_at": "2026-09-10T03:03:12.000000Z",
    "leg": null,
    "member_id": "d96dec6b-07b3-5c76-bf43-5d9fedf54914",
    "parent_node_id": "01a08944-f09e-75ca-a913-0bfab6c7bd9d",
    "tree_id": "7096ad49-7117-53f6-8f7f-4805473d14c5"
  },
  "status": 200,
  "meta": {
    "request_uuid": null,
    "timestamp": "2026-09-10T03:03:12Z"
  }
}

Overview

Storefront

Commerce

Checkout

Members

Messaging

People

Payments

DAM

Website

Portal

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Portal & Widgets

Read recorded relationship for company access

Authorizations

Path Parameters

Query Parameters

Response