---
title: "Get a single member by MemberKey"
method: GET
path: "/odata/v1/Member/{MemberKey}"
tags: ["Member"]
---

# Get a single member by MemberKey

`GET /odata/v1/Member/{MemberKey}`

Both methods are valid and return the same result: a single Member entity identified by its unique MemberKey.
The path-style is more intuitive and commonly used in RESTful APIs.
The function-style follows OData conventions and may be required in certain query contexts (e.g., when the key contains special characters or is not a simple numeric ID).

<b>Path-style access: </b>```/odata/v1/Member/{MemberKey}```

<b>Example: </b>```/odata/v1/Member/14090```

<b>Function-style access: </b>```/odata/v1/Member('{MemberKey}')```

<b>Example: </b>```/odata/v1/Member('14090')```

## Path parameters

- `MemberKey` string, required

## Query parameters

- `$select` string

## Response `200`

OK (DDF.Core.Entities.Member object)

- DDFInfrastructureSwaggerExampleModelsODataSingleResponse1DDFCoreEntitiesMemberDDFCoreVersion1000CultureNeutralPublicKeyTokenNull
  - `@odata.context` string, nullable
  - `MemberKey` string, nullable — A unique identifier for this record.
  - `MemberMlsId` string, nullable — The local, well-known identifier. This value may not be unique, specifically in the case of aggregation systems, this value should be the identifier from the original system.
  - `OfficeKey` string, nullable — The unique identifier of the member's office.
  - `OfficeNationalAssociationId` string, nullable — The national association ID of the office. i.e. In Canada, this is the Organization ID of the Office.
  - `JobTitle` string, nullable — The title or position of the member within their organization.
  - `MemberAORKey` string, nullable — A system unique identifier. This is the Board ID of the Member's Primary Board or Association of REALTORS.
  - `MemberAddress1` string, nullable — The street number, direction, name and suffix of the member.
  - `MemberAddress2` string, nullable — The unit/suite number of the member.
  - `MemberFax` string, nullable — North American 10 digit phone numbers should be in the format of ###-###-#### (separated by hyphens). Other conventions should use the common local standard. International numbers should be preceded by a plus symbol.
  - `MemberFirstName` string, nullable — The first name of the Member.
  - `MemberLastName` string, nullable — The last name of the Member.
  - `MemberMiddleName` string, nullable — The middle name of the Member.
  - `MemberNamePrefix` string, nullable — Prefix to the name (e.g. Dr. Mr. Ms. etc.)
  - `MemberNameSuffix` string, nullable — Suffix to the surname (e.g. Esq., Jr., III etc.)
  - `MemberNationalAssociationId` string, nullable — The national association ID of the member. i.e. In Canada this is the CREA ID of the member.
  - `MemberNickname` string, nullable — An alternate name used by the Member, usually as a substitute for the first name.
  - `MemberOfficePhone` string, nullable — North American 10 digit phone numbers should be in the format of ###-###-#### (separated by hyphens). Other conventions should use the common local standard. International numbers should be preceded by a plus symbol.
  - `MemberOfficePhoneExt` string, nullable — The extension of the given phone number (if applicable).
  - `MemberPostalCode` string, nullable — The postal code of the member.
  - `MemberPager` string, nullable — North American 10 digit phone numbers should be in the format of ###-###-#### (separated by hyphens). Other conventions should use the common local standard. International numbers should be preceded by a plus symbol.
  - `MemberTollFreePhone` string, nullable — North American 10 digit phone numbers should be in the format of ###-###-#### (separated by hyphens). Other conventions should use the common local standard. International numbers should be preceded by a plus symbol.
  - `ModificationTimestamp` string, Enum: DateTime, nullable — Date/time the roster (member or office) record was last modified (in Zulu time (UTC)).
  - `OriginalEntryTimestamp` string, Enum: DateTime, nullable — Date/time the roster (member or office) record was originally input into the source system (in Zulu time (UTC)).
  - `MemberCity` string, nullable — The city of the member.
  - `MemberAOR` string, Enum: AOR, nullable — The Member's Primary Board Name or Association's Name of REALTORS.
  - `MemberCountry` string, Enum: Country, nullable — The country in a postal address.
  - `MemberDesignation` integer[], nullable — Designations and certifications acknowledging experience and expertise in various real estate sectors are awarded by CREA and each affiliated group upon completion of required courses
  - `MemberLanguages` integer[], nullable — The languages the member speaks.
  - `MemberSocialMedia` DDFCoreEntitiesSocialMedia[], nullable — A collection of the types of social media fields available for this member. The collection includes the type of system and other details pertinent about social media.
    - `SocialMediaKey` string, nullable — The local, well-known identifier. This value may not be unique, specifically in the case of aggregation systems, this value should be the identifier from the original system.
    - `ResourceRecordKey` string, nullable — The primary key of the related record from the source resource. For example the ListingKey, MemberKey, OfficeKey, etc. This is a foreign key from the resource selected in the ResourceName field.
    - `SocialMediaType` string, Enum: SocialMediaType, nullable — The type of sites, blog, social media, the Member URL or ID is referring to. i.e. Website, FaceBook, LinkedIn, Twitter, Instagram, etc.
    - `ModificationTimestamp` string, date-time — The transactional timestamp automatically recorded by the MLS system representing the date/time the media record was last modified (in Zulu time (UTC)).
    - `ResourceName` unknown
    - `SocialMediaUrlOrId` string, nullable — The website URL or ID of social media site or account of the member.
  - `Media` DDFCoreEntitiesMedia[], nullable — A collection of the types of media fields available for this Member.
    - `MediaKey` string, nullable — A unique identifier for this record from the immediate source. This may be a number, or string that can include URI or other forms. This is the system you are connecting to and not necessarily the original source of the record.
    - `LongDescription` string, nullable — The full description of the object.
    - `MediaURL` string, nullable — The URI to the media file referenced by this record.
    - `ModificationTimestamp` string, Enum: DateTime, nullable — Date/time the record was last modified (in Zulu time (UTC)).
    - `Order` integer, nullable — The order in which the media object is displayed. Zero is the primary photo per RETS convention.
    - `PreferredPhotoYN` boolean, nullable — When set to true, the media record in question is the preferred photo. This will typically mean the photo to be shown when only one of the photos is to be displayed.
    - `ResourceRecordId` string, nullable — The well known identifier of the related record from the source resource.
    - `ResourceRecordKey` string, nullable — The primary key of the related record from the source resource.
    - `ResourceName` string, Enum: ResourceName, nullable — The resource or table of the listing or other record the media relates to. i.e. Property, Member, Office, etc.
    - `MediaCategory` string, Enum: MediaCategory, nullable — Category describing the , Photos, Documents, Video, Unbranded Virtual Tour, Branded Virtual Tour, Floor Plan, Logo
  - `MemberStateOrProvince` string, Enum: StateOrProvince, nullable — The state or province in which the member is addressed.
  - `MemberStatus` string, Enum: MemberStatus, nullable — The current status of the member.
  - `MemberType` string, Enum: MemberType, nullable — The type of member. i.e. Agent, Broker, Office Manager, Appraiser, Assistants, MLO, Realtor, Association Staff, MLS Staff, etc.
  - `MemberEmailYN` boolean, nullable — This flag signifies the availability of a REALTOR®’s email address. It is intended for clients who use the Lead API endpoint to communicate with Realtors. If the flag is false, these clients should turn off the email REALTOR® function for the respective REALTOR®. Clients not using Lead API endpoint can disregard this field.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/realtor/apis/realtor-ca-ddf-web-api-documentation.md) · [All operations](https://skmtc.net/realtor/apis/realtor-ca-ddf-web-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/realtor/realtor-ca-ddf-web-api-documentation/versions/17c9ffddac21/schema)
