Get a selected real estate agent's professional profile

View all Realty in US Property & Mortgage Data endpoints →

Retrieve an agent profile using the required profile_id query parameter, taken from the id field of an /agents/v2/list result. The optional fulfillment_id comes from that result's fulfillment_id field. Keep these identifiers separate; a profile ID and a fulfillment ID are not interchangeable. The documented profile_id example is 56d09a4b2cfde1010000abb1, while fulfillment_id has no supplied default. The available documentation example shows profile identifiers id and _id; fullname, profile_name, bio and profile_description; an address object with line, city, postal_code, state, state_code and country; agent_represents.buyer and agent_represents.seller booleans; an areas_served string; and languages and licenses arrays whose item structures are not established by the empty sample arrays. It also shows broker and office objects with name and fulfillment_id, photo.href, and meta.last_update_date. Feedback-related fields include recommendations.count and a ratings object with average_rating, overall_rating, reviews_count and responseCount. The sample mixes numeric and string rating values, so do not assume one numeric type for every ratings field. These are unverified documentation fields, not observed live-response guarantees: no probe response is available for this operation, and the supplied example is incomplete. Handle absent fields and do not infer current contact details, license validity, photo usage rights or a complete professional history from a returned profile. Retrieve recommendations and reviews through their separate operations when those are the intended views.

API Features

Directory-to-profile ID mapping Use an agent-list result's id as the required profile_id, keeping the selected person's profile lookup tied to the directory record.
Optional fulfillment identifier Pass fulfillment_id separately when available from the same agent-list result; it does not replace the required profile_id.
Professional biography and location fields The unverified documentation example includes fullname, bio, profile_description, address and areas_served for a profile layout that tolerates missing values.
Representation and organization context The example documents buyer and seller representation flags plus broker and office objects; these fields are not proof of licensing or current affiliation.
Profile sample type awareness Empty languages and licenses arrays do not establish their item schemas, and mixed rating types call for field-by-field handling rather than blanket numeric conversion.

Live API Demo

GET /api/project/realty-in-us/agents-v2-get-profile

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-profile?key=<API_KEY>&profile_id=56d09a4b2cfde1010000abb1'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Where do I get profile_id for this request?

Use the id field of the selected result from /agents/v2/list. profile_id is a required string. The documented example is 56d09a4b2cfde1010000abb1; an actual lookup should use the identifier of the agent the user selected.

Is fulfillment_id required to get an agent profile?

No. This operation requires profile_id and accepts fulfillment_id as an optional string from the agent-list result's fulfillment_id field. No fulfillment_id default is supplied for the profile request. Do not exchange the two identifiers.

Which professional details are documented in the response?

The incomplete documentation example includes profile names and biography, address, areas_served, buyer and seller representation flags, broker and office objects, photo.href and meta.last_update_date. It also contains languages and licenses arrays, but their empty example values do not define an item schema. None of these fields was confirmed by a live response for this operation.

Does a profile confirm that an agent has a valid license?

No. A returned profile, representation flag or licenses field is not a licensing determination. The available example does not establish the structure or verification status of license records, so check the relevant licensing authority separately when that assurance is needed.

Can I treat the profile's ratings as complete reviews?

No. The example contains rating summaries and recommendations.count, not an established collection of review entries. Some rating values are strings and others are numbers. Use the separate review or recommendation operation for those views and verify the returned structure before rendering individual feedback.

Related operations

Guides

View Subscription Plans →