List members

GET

api

v2025-06

members

List members

curl --request GET \
  --url https://api.fluid.app/api/v2025-06/members \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.fluid.app/api/v2025-06/members', 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/v2025-06/members",
  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/v2025-06/members"

	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/v2025-06/members")

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

{
  "members": [
    {
      "id": "<string>",
      "email": "<string>",
      "name": "<string>",
      "activity_status": "<string>",
      "username": "<string>",
      "external_id": "<string>",
      "legacy_user_company_id": 123,
      "legacy_customer_id": 123,
      "orders_count": 123,
      "total_spent_in_base": 123,
      "first_name": "<string>",
      "last_name": "<string>",
      "member_type_slug": "<string>",
      "country_code": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "status": 123
}

{
  "message": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page[cursor]

string

Cursor token from the previous response page.

page[limit]

integer

Number of members to return.

Required range: 1 <= x <= 100

sort

enum<string>

Sort order. Prefix with - to reverse.

Available options:

created_at,

-created_at,

name,

-name

filter[active]

boolean

Restrict to active (true) or inactive (false) members.

filter[member_type_slug]

string

Restrict to one member type, e.g. customer or rep.

filter[search]

string

Free-text match across name, email, and username.

filter[country_iso]

string

ISO 3166-1 alpha-2 country code.

Pattern: ^[A-Za-z]{2}$

filter[external_id]

string

The member's external id, as set by an integration.

Restrict to members sponsored by this member.

filter[rank_id]

integer

Restrict to members holding this rank.

filter[orders_count_min]

integer

Minimum lifetime order count.

filter[orders_count_max]

integer

Maximum lifetime order count.

filter[total_spent_min]

number

Minimum lifetime spend, in the company base currency.

filter[total_spent_max]

number

Maximum lifetime spend, in the company base currency.

filter[created_at_from]

string<date-time>

Only members created at or after this time.

filter[created_at_to]

string<date-time>

Only members created at or before this time.

filter[updated_at_from]

string<date-time>

Only members updated at or after this time.

filter[updated_at_to]

string<date-time>

Only members updated at or before this time.

Response

Success

members

object[]

required

Show child attributes

meta

object

required

Show child attributes

status

integer

List members

curl --request GET \
  --url https://api.fluid.app/api/v2025-06/members \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.fluid.app/api/v2025-06/members', 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/v2025-06/members",
  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/v2025-06/members"

	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/v2025-06/members")

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

{
  "members": [
    {
      "id": "<string>",
      "email": "<string>",
      "name": "<string>",
      "activity_status": "<string>",
      "username": "<string>",
      "external_id": "<string>",
      "legacy_user_company_id": 123,
      "legacy_customer_id": 123,
      "orders_count": 123,
      "total_spent_in_base": 123,
      "first_name": "<string>",
      "last_name": "<string>",
      "member_type_slug": "<string>",
      "country_code": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  },
  "status": 123
}

{
  "message": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

{
  "message": "<string>",
  "error": "<string>",
  "error_message": "<string>",
  "errors": "<string>",
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Task guides

Portal & Widgets

Endpoints

Auth endpoints

Checkout endpoints

Public SDK endpoints

Member endpoints

Payment gateway endpoints

Cart payment endpoints

Commerce endpoints

Webhooks endpoints

Company admin endpoints (v0)

Analytics

List members

Authorizations

Query Parameters

Response