> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.repliers.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Understanding the Members Endpoint

# Overview

The Members endpoint retrieves agent and broker information directly from Multiple Listing Service (MLS) data feeds. This endpoint provides access to the official roster of real estate professionals as maintained by MLS boards, including their contact details, brokerage affiliations, and professional designations.

# Key Differentiation: Members vs. Agents

**Important:** The Members endpoint is fundamentally different from the Agents resource in Repliers.

* **Members endpoint** (`/members`): Returns MLS member records as they exist in the MLS data feed. These are official registrations maintained by MLS boards and include licensed real estate professionals in that market.

* **Agents resource** (covered in [this article](https://help.repliers.com/en/article/agents-and-clients-in-repliers-1cl1bav/)): Refers to internally created entities within your Repliers account that you manage through the dashboard or API. These are your own custom agent records that you create and maintain for your application's needs.

A way to understand this distinction is that Members are the official MLS directory entries, while Agents are your custom records within Repliers.

# Endpoint Details

**Endpoint:** `GET /members`

**Parameters:**
* `pageNum` - Page number to retrieve (use this to iterate through the result set)

**Purpose:** Retrieve paginated lists of MLS member records with their complete professional information.

# Response Structure

The Members endpoint returns a paginated response with the following top-level structure:

* `page` - Current page number in the result set
* `numPages` - Total number of pages available
* `pageSize` - Number of members returned per page (typically 100)
* `count` - Total number of member records available
* `members` - Array of member objects

## Member Object Fields

Each member record includes comprehensive professional information:

### Core Identifiers
* `resource` - The MLS resource this member belongs to (e.g., "Property:2505")
* `agentId` - Member's unique identifier in the MLS system
* `boardAgentId` - Board-specific agent identifier
* `officeId` - Identifier for the member's affiliated office

### Basic Information
* `name` - Full name of the real estate professional
* `position` - Professional title or designation (e.g., "REALTOR Salesperson", "Broker")
* `board` - MLS board affiliation (when available)
* `updatedOn` - Timestamp of the last update to this record

### Contact Information
* `email` - Professional email address
* `phones` - Array of phone numbers (may include multiple numbers)
* `website` - Professional or team website URL
* `social` - Array of social media profile links

### Photo Information
The `photo` object contains:
* `small` - URL to small profile photo
* `large` - URL to larger profile photo
* `updatedOn` - Timestamp of when the photo was last updated

### Brokerage Information
The `brokerage` object includes:
* `name` - Name of the brokerage firm
* `address` - Complete address object with:
* `address1` - Primary street address
* `address2` - Secondary address line (suite, unit, etc.)
* `city` - City name
* `state` - State or province abbreviation
* `postal` - ZIP or postal code
* `country` - Country code

# Common Use Cases

## Building Agent Directories
Use the Members endpoint to populate your application with real estate professional profiles directly from MLS data. This ensures your directory stays synchronized with official MLS rosters.

## Member Information Lookup
The Members endpoint supports various search and filtering capabilities. Available query parameters include `agentId`, `boardAgentId`, `officeId`, `keywords`, and `pageNum`. The `keywords` parameter performs broad searches across member details including names, contact information, and professional designations. Refer to the API documentation for complete details on how to use each parameter.

## Market Research
Analyze the composition of real estate professionals in a market, including which brokerages have the most agents and geographic distribution of professionals.

## Profile Enrichment
Cross-reference member data with your internal agent records to enrich them with official MLS information like professional designations, office affiliations, and updated contact details.

# Important Considerations

## Data Source
All member information comes directly from MLS data feeds. Repliers doesn't modify or supplement this data beyond formatting it for API delivery.

## Agent Availability
If an agent is absent from the Members endpoint, the most likely explanation is that the agent has not had any listings in the MLS system. Members are captured when they appear on property listings, so agents without any historical listing activity will not be present in this endpoint. Additionally, members of MLS boards that do not disclose agent information on listings will not have data available through this endpoint.

## Update Frequency
Member records are updated according to the MLS board's data refresh schedule. 

## Pagination
With potentially tens of thousands of members per MLS board, proper pagination handling is essential. Use the `pageNum` parameter to iterate through pages, and check the `numPages` field to determine when you've reached the end of the result set.


# Example Response Structure

Here's a simplified example showing the structure you'll receive:

```json
{
  "page": 1,
  "numPages": 394,
  "pageSize": 100,
  "count": 39337,
  "members": [
    {
      "resource": "Property:2505",
      "agentId": "MRD12345",
      "boardAgentId": "MRD12345",
      "officeId": "MRD999",
      "updatedOn": "2021-01-22 20:42:48",
      "name": "Jane Smith",
      "board": null,
      "position": "REALTOR Salesperson",
      "phones": ["555-123-4567", "555-987-6543"],
      "social": [],
      "website": null,
      "photo": {
        "small": null,
        "large": null,
        "updatedOn": null
      },
      "brokerage": {
        "name": "Premier Real Estate Group",
        "address": {
          "address1": "123 Main Street",
          "address2": "Suite 100",
          "city": "Chicago",
          "state": "IL",
          "postal": "60601",
          "country": null
        }
      },
      "email": "jsmith@example.com"
    }
  ]
}
```

# Privacy Considerations
While this is publicly available MLS data, remember that it contains personal contact information. Use this data responsibly and in accordance with applicable privacy regulations and MLS rules.