{
"profile": {
"id": "<string>",
"gender": "WOMAN",
"version": "2025-01-01T12:34:20Z",
"firstName": "<string>",
"nickname": "<string>",
"description": "<string>",
"birthdate": "1990-05-14",
"countryCode": "FR",
"city": "<string>",
"postalCode": "<string>",
"timeZone": "Europe/Paris",
"features": {
"ethnicity": "ASIAN",
"height": 123,
"weight": 123,
"eyesColor": "BLACK",
"hairColor": "BLACK",
"hairLength": "AVERAGE",
"maritalStatus": "SINGLE",
"job": "<string>",
"interests": [
"TAILORING"
],
"bdsmInterests": [
"BDSM_BLOOD_PLAY"
],
"sexualInterests": [
"ANAL"
],
"lookingFor": [
"MAN"
],
"sexualOrientation": "HETEROSEXUAL",
"childrenCount": 123,
"wantsChildren": "YES",
"surgeryStatus": "UNKNOWN",
"unitSystem": "METRIC",
"livingWith": "ALONE"
},
"personality": "SUPPORTIVE",
"mainPictureUrl": "https://example.org/images/public.jpg",
"pictures": [
"https://example.org/images/public.jpg"
],
"privatePictures": [
"https://example.org/images/private.jpg"
],
"expiresAt": "2025-01-01T12:34:20Z",
"children": [
{
"name": "<string>",
"gender": "WOMAN",
"age": 123
}
],
"pets": [
{
"name": "<string>",
"sex": "MALE",
"age": 123,
"breed": "<string>",
"type": "<string>"
}
]
}
}Hide child attributes
The profile's ID (must be the same as the profileId parameter passed to the endpoint).
Gender of the profile owner.
WOMAN, MAN, TRANS_MAN, TRANSMASCULINE, TRANS_WOMAN, TRANSFEMININE An arbitrary string compared against the one stored in our profile database; any mismatch will trigger a profile data refresh. For example, you can use the latest update date as the version number.
"2025-01-01T12:34:20Z"
First name of the profile owner. You must provide either a first name or a nickname. At least one is required.
Nickname of the profile owner. You must provide either a first name or a nickname. At least one is required.
Description of the profile.
Birthdate of the profile owner, formatted as yyyy-MM-dd.
"1990-05-14"
Country code of the profile owner. Must be a two-letter ISO 3166-1 alpha-2 code.
2"FR"
City of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the city will be ignored.
64Postal code of the profile owner. You must provide a country code for this parameter to be used by our system. If no country code is provided, the postal code will be ignored.
64Time zone of the profile owner. See our supported time zones list.
"Europe/Paris"
Features of the profile.
Hide child attributes
The ethnicity of the profile. Default is null.
ASIAN, BLACK, CAUCASIAN, MIDDLE_EAST, HISPANIC_LATINO, INDIAN, MEDITERRANEAN, OTHER, UNCERTAIN Height in metric by default (cm). Set unitSystem to IMPERIAL for inches.
Weight in metric by default (kg). Set unitSystem to IMPERIAL for pounds.
The color of the eyes. Default is null.
BLACK, BLUE_GREY, BLUE, BROWN, GREEN_BLUE, GREEN, GREY, OTHER, UNKNOWN The color of the hair. Default is null.
BLACK, BLOND, BROWN, DARK_BLOND, GREY, RED, WHITE, OTHER, UNKNOWN The length of the hair. Default is null.
AVERAGE, BALD, HALF_LONG, LONG, SHORT, VERY_LONG, VERY_SHORT The marital status of the profile. Default is null.
SINGLE, SEPARATED, IN_RELATIONSHIP, MARRIED, DIVORCED, WIDOW The job of the profile. Default is null.
32The interests of the profile. Default is an empty array.
TAILORING, BOOK_READING, TRAVELING, COOKING, GARDENING, PHOTOGRAPHY, PAINTING, MUSIC, MOVIES, CYCLING, HIKING, FITNESS, GAMING, DANCING, YOGA, SOFTWARE_DEVELOPMENT, DIY_PROJECTS, WRITING, LANGUAGES, ASTRONOMY, VOLUNTEERING, FISHING, BIRD_WATCHING, SPORTS, EDUCATION, ECONOMY, FOOD_DRINKING, CULINARY, TECHNOLOGY, MEDICAL, NATURE, CULTURE, ART The BDSM interests of the profile. Default is an empty array.
BDSM_BLOOD_PLAY, BDSM_BONDAGE, BDSM_BREATH_PLAY, BDSM_BUTTOCKS, BDSM_DOMINATION, BDSM_EDGE_PLAY, BDSM_FIRE_PLAY, BDSM_FISTING, BDSM_FLOGGING, BDSM_GOLDEN_SHOWER, BDSM_HARD, BDSM_KINKSTER, BDSM_KNIFE_PLAY, BDSM_MASOCHIST, BDSM_NEEDLE_PLAY, BDSM_ORGASM_DENIAL, BDSM_PET_PLAY, BDSM_QUEENING_FACESITTING, BDSM_SADISM, BDSM_SOFT, BDSM_STRAP_ON_DILDO, BDSM_SUBMISSION, BDSM_SUSPENSION, BDSM_ZENTAI The sexual interests of the profile. Default is an empty array.
ANAL, VAGINAL, ORAL_GIVING, ORAL_RECEIVING, KISSING, CUDDLING, DOMINANCE, SUBMISSION, BDSM, ROLEPLAY, PUBLIC_SEX, GROUP_SEX, SWINGING, WATCHING, BEING_WATCHED, THREESOME, FOREPLAY, DIRTY_TALK, SENSUAL_MASSAGE, TOYS, LIGHT_BONDAGE, SPANKING, CHOKING, FEET, EXHIBITIONISM, VOYEURISM The profile looking for genders. Default is an empty array.
MAN, WOMAN The sexual orientation of the profile. Default is null.
HETEROSEXUAL, GAY, LESBIAN, BISEXUAL, ASEXUAL, DEMISEXUAL, PANSEXUAL, QUEER, QUESTIONING, AROMANTIC, OMNISEXUAL, OTHER The number of children the profile has. Default is null.
The preference for having children. Default is null.
YES, NO, MAYBE For Transgender profile only. The surgery status of the profile. Default is null.
UNKNOWN, PRE_OP, POST_OP, NON_OP, PREFER_NOT_TO_SAY The unit system used for the profile. Default is METRIC.
IMPERIAL, METRIC Describes the user's current living situation. Default is null if unspecified.
ALONE, KIDS, PARENTS, ROOMMATE, PARTNER, PARTNER_AND_KIDS Personality of the profile.
SUPPORTIVE, TEASING, CONFIDENT, GEEKY, POETIC, HIGH_ENERGY, INTELLECTUAL, ROMANTIC, SARCASTIC, POSSESSIVE, NATURAL, APPRECIATIVE, PASSIONNATE URL of the main picture. Must be HTTPS
"https://example.org/images/public.jpg"
List of public picture URLs. All URLs must be HTTPS
["https://example.org/images/public.jpg"]List of private picture URLs. All URLs must be HTTPS
["https://example.org/images/private.jpg"]An ISO-8601 formatted date. By default, set to one week after profile creation. Purges profile data when reached; fresh data is fetched on next use. Avoid setting durations shorter than 24 hours. Use the version parameter for user profile updates.
"2025-01-01T12:34:20Z"
List of children the profile has.
List of pets the profile has.
Hide child attributes
Name of the pet.
1 - 32Sex of the pet.
MALE, FEMALE Age of the pet.
Breed of the pet.
1 - 32Type of the pet.
1 - 32