profile

Returns information about a profile.

Usage

https://www.geni.com/api/profile-101

Parameters

Name Type Description Required
fields Array of Strings You can pass a list of fields you want returned in your call. For example, to get just the first and last names of a profile: https://www.geni.com/api/profile-21557506?fields=first_name,last_name. false
ids Array of Strings You can select a group of profiles on specific urls. For example: https://www.geni.com/api/profile?ids=101,31534,145 returns profile data for all three ids. false
only_ids Boolean The returned data structures will contain urls to other objects in our system unless the request includes 'only_ids=true.' Passing only_ids will force the system to return ids only. false

Returned Fields

Name Type Description
about_me String Profile's about me section
baptism Event Profile's baptism event info
big_tree Boolean True if the profile is attached to the big tree
birth Event Profile's birth event info
block_exists Boolean Indicates whether the profile is blocked
burial Event Profile's burial event info
cause_of_death String Profile's death cause
claimed Boolean True if the profile is claimed by a user
created_at String Timestamp of when the profile was created
creator String The url (or id) of the user who added this profile to the tree
curator String Profile's curator's url (or id)
current_residence Location The profile's current address
death Event Profile's death event info
display_name String The profile's display name
documents_updated_at String Returns a timestamp of the last document updated/added to the profile. Will not be return if no documents exist.
email String The Profile's email address
first_name String The profile's first name
gender String The profile's gender
get_email Boolean Indicates whether the profile can receive email
guid String The profile's guid
id String The profile's node id
is_alive Boolean True if the profile is living
language String Profile's language
last_name String The profile's last name
locked Boolean True if the profile has been locked down by a curator
maiden_name String The profile's maiden name
managers Array of Strings Urls (or ids) of profile(s) currently managing this profile
master_profile Boolean Indicates whether the profile is a master profile
merge_note Array or String Note explaining the profile's merge status
merge_pending Boolean Indicates whether the profile has a pending merge
merged_into String The url (or id) of the profile this profile is currently merged into
middle_name String The profile's middle name
mugshot_urls PhotoImageSizeMap All sizes of the profile's main photo
name String The profile's name as it appears on the site to the current user
nicknames Array of Strings Also known as. Returned as an array, but can be set as a comma delimited list.
occupation String The profile's occupation
phone_numbers Array of PhoneNumbers The Profile's phone numbers
photos_updated_at String Returns a timestamp of the last photo updated/added to the profile. Will not be return if no photos exist.
premium_start_date String Date when the profile became a pro user
profile_url String URL to access profile in a browser
public Boolean True if the profile is public
relationship String Profile's relationship to the current user (if any)
requested_merges Array of Strings The urls (or ids) of the profile(s) requested to be merged into this one
suffix String The profile's suffix
unions Array of Strings URLs to unions
updated_at String Timestamp of when the profile was last updated
url String URL to access profile through the API
videos_updated_at String Returns a timestamp of the last video updated/added to the profile. Will not be return if no videos exist.
Note: Blank fields will not be returned to save bandwidth.

app005