Member API

List the user's memberships

Every membership the signed-in member’s user holds, the credential’s own included, so a client can offer a company switcher. A company the user administers is listed too, with its admin roles. Removed memberships and removed companies never appear.

Sorted by company name in the database’s collation order (not lowercased), companies without a name last, then by membership id. A cursor is bound to the query that issued it: one sent with other filter values, or by another user, is ignored and the first page is returned.

GET

api

member

v2026-10

companies

List the user's memberships

curl --request GET \
  --url https://api.fluid.app/api/member/v2026-10/companies \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.fluid.app/api/member/v2026-10/companies', 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/member/v2026-10/companies",
  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/member/v2026-10/companies"

	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/member/v2026-10/companies")

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

{
  "status": 200,
  "data": [
    {
      "id": "0192f3a8-5c1e-7d42-9b6a-3e8f1c2d4a57",
      "company": {
        "id": "0192f39f-7a3b-7c21-a8e4-1d6b9f3c5e82",
        "name": "Dunder Mifflin Paper Company",
        "subdomain": "dunder-mifflin",
        "logo_url": "https://cdn.fluid.app/companies/dunder-mifflin/logo.png",
        "icon_url": "https://cdn.fluid.app/companies/dunder-mifflin/icon.png",
        "primary_color": "1F4E8C"
      },
      "member_type": {
        "id": "0192f3a1-2b7d-7e10-8c4f-5a9d2e6b1f03",
        "slug": "rep",
        "name": "Brand Partner"
      },
      "roles": [],
      "active": true,
      "current": true,
      "joined_at": "2026-09-02T14:31:07Z"
    },
    {
      "id": "0192f3b4-6f8a-7b93-9d2c-4e5f6a7b8c90",
      "company": {
        "id": "0192f3b0-8c1d-7e45-a6f7-2b3c4d5e6f71",
        "name": "Hooli",
        "subdomain": "hooli",
        "logo_url": "https://cdn.fluid.app/companies/hooli/logo.png",
        "icon_url": null,
        "primary_color": "2E9E4F"
      },
      "member_type": {
        "id": "0192f3b1-4d5e-7f60-b7a8-3c4d5e6f7a82",
        "slug": "customer",
        "name": "Customer"
      },
      "roles": [],
      "active": true,
      "current": false,
      "joined_at": "2026-09-14T09:12:48Z"
    }
  ],
  "meta": {
    "request_uuid": "0192f4c8-5b6c-7d74-c3e8-0f1a2b3c4d5e",
    "timestamp": "2026-09-30T15:08:21Z",
    "pagination": {
      "next_cursor": null
    }
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

A member credential in the Authorization: Bearer header: a member session JWT, a portal JWT whose login is linked to a membership in that company, or a member token. The credential alone identifies the member and company.

Query Parameters

filter[active]

boolean

true (the default) lists the memberships whose active is true; false lists the rest: inactive, locked, or in an inactive company.

page[cursor]

string

Opaque cursor from a previous response's meta.pagination.next_cursor. Omit for the first page. A cursor that is malformed, tampered with or older than three days returns 400; start again from the first page.

page[limit]

integer

Page size. Defaults to 25, at most 100.

Required range: 1 <= x <= 100

Response

One page of the user's memberships.

status

integer

required

data

object[]

required

Show child attributes

meta

object

required

Envelope metadata present on every response.

Show child attributes

List the user's memberships

curl --request GET \
  --url https://api.fluid.app/api/member/v2026-10/companies \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.fluid.app/api/member/v2026-10/companies', 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/member/v2026-10/companies",
  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/member/v2026-10/companies"

	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/member/v2026-10/companies")

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

{
  "status": 200,
  "data": [
    {
      "id": "0192f3a8-5c1e-7d42-9b6a-3e8f1c2d4a57",
      "company": {
        "id": "0192f39f-7a3b-7c21-a8e4-1d6b9f3c5e82",
        "name": "Dunder Mifflin Paper Company",
        "subdomain": "dunder-mifflin",
        "logo_url": "https://cdn.fluid.app/companies/dunder-mifflin/logo.png",
        "icon_url": "https://cdn.fluid.app/companies/dunder-mifflin/icon.png",
        "primary_color": "1F4E8C"
      },
      "member_type": {
        "id": "0192f3a1-2b7d-7e10-8c4f-5a9d2e6b1f03",
        "slug": "rep",
        "name": "Brand Partner"
      },
      "roles": [],
      "active": true,
      "current": true,
      "joined_at": "2026-09-02T14:31:07Z"
    },
    {
      "id": "0192f3b4-6f8a-7b93-9d2c-4e5f6a7b8c90",
      "company": {
        "id": "0192f3b0-8c1d-7e45-a6f7-2b3c4d5e6f71",
        "name": "Hooli",
        "subdomain": "hooli",
        "logo_url": "https://cdn.fluid.app/companies/hooli/logo.png",
        "icon_url": null,
        "primary_color": "2E9E4F"
      },
      "member_type": {
        "id": "0192f3b1-4d5e-7f60-b7a8-3c4d5e6f7a82",
        "slug": "customer",
        "name": "Customer"
      },
      "roles": [],
      "active": true,
      "current": false,
      "joined_at": "2026-09-14T09:12:48Z"
    }
  ],
  "meta": {
    "request_uuid": "0192f4c8-5b6c-7d74-c3e8-0f1a2b3c4d5e",
    "timestamp": "2026-09-30T15:08:21Z",
    "pagination": {
      "next_cursor": null
    }
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "status": 123,
  "error": {
    "message": "<string>",
    "details": {}
  },
  "meta": {
    "request_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Storefront

Commerce

Checkout

Members

Messaging

People

Payments

DAM

Website

Portal

Content and tools

Analytics

Sales channels

Settings

FairShare SDK

Droplets

Developers

Portal & Widgets

List the user's memberships

Authorizations

Query Parameters

Response