Profile API
Additional usage: If your acess point to the tree is a regular profile, the first number is a GUID (globally unique identifier), you can prefix this GUID with a g to access the API record:
https://www.geni.com/api/profile-g6000000012102785219
This API analysis is mainly based on the profile of Charlemagne: https://www.geni.com/api/profile-1693836?field_group=all&only_ids=true&master_profile=true
Parameters
The documentation for the parameter field_group=all is missing, - this is the option I have used as a base for this report.
Error: The master_profile field is NOT returned when using field_group=all, but it is implicit true if the curator field have a value.
- Wish: I would also like to have a language parameter option on requests so that my app can get profiles in another language without having to change my logged-in user profile language.
Returned Fields
Fields listed with (missing documentation) will be documented later in this thread.
birth_order, number, Profile's birth order (missing documentation)
current_residence - for deceased persons the field is used for: Last Residence
data_conflict, Boolean, True if the profile have data conflicts(missing documentation)
deleted, Boolean, True if the profile is deleted (missing documentation)
detail_strings, Hash, Nested maps of locales to details fields (eg. about me) to values (must be requested)
Example:
"detail_strings" : { "en-US" : { "about_me" : "US English" }, "fr" : { "about_me" : "French" } }
language, String, Profile's language.
Error: Can see any places where it is returned. For user profile I would expect the user selected language. For multi-lingual profiles this value should tell which language the displayed values is using (display_name, names, etc). See above the request for a language request argument.
locked, Boolean, True if the profile has been locked down by a curator.
Obsolete? Will only be returned if there is no other locks. In my opinion the locked=true should give the undocumented value locked_fields an all:true option, or returning locked=true even if locked_fields is used as well, since locked_fields also lock the profile fields for a curator.
locked_fields, LockedFields, - List over specific locked fields in the profile. (missing documentation)
marriage_orders, Hash, List over Union GUID:number pairs where number is married order (missing documentation)
Example from Charlemagne:
"marriage_orders": {
"6000000008568039331" : 1,
"6000000008568026367" : 2,
"6000000002349731751" : 3,
"6000000008567983715" : 4,
"6000000008567983698" : 5,
"6000000007834583056" : 6,
"6000000008248679887" : 7,
"6000000018556076868" : 8,
"6000000000351174125" : 9,
"6000000003796990098" : 10
}
Since referred marriage union is a GUID (globally unique identifier) you can, as with profiles, get the record by prefixing the number with the letter g.
https://www.geni.com/api/union-g6000000008568039331
merge_note, Array or String, Note explaining the profile's merge status.
Error? : Should be renamed to curator_note? I doubt it can be an array, and in any case array of what?
names, Hash, Nested maps of locales to name fields to values
Should be documented with example:
"names": {
"en-US": { "display_name": "Charlemagne" },
"no" : { "display_name" : "Karl den store" }
}
Localized name fields supported: title, first_name, middle_name, last_name, maiden_name, suffix, display_name, nicknames (Note: Comma separated, not array of strings as the nicknames profile field.
project_ids, Array of Strings, List project ID's in which a profile is tagged (missing documentation)
Example from Charlemagne:
"project_ids" : [
"project-895188",
"project-42771",
"project-2960381",
"project-1636100"
}
Some notes about timestamp values like updated_at
Example from Charlemagne:
"updated_at" : "1650996146"
The number 1650996146 is number of seconds since what old programmers like me calls The Unix Epoch, which is January 1st, 1970 00:00
Which, using C# can be converted like this using the above value:
DateTime UpdateAt = new DateTime(1970, 1, 1).AddSeconds(1650996146);
Which tell that the last update was on April 26, 2022 18:02:26
Question: Why is editing a spouse connection not flagged in updated_at?
