---
updatedAt: 2026-07-30T10:16:50.000Z
agentTools:
  projectIndex: https://developers.hrflow.ai/llms.txt
---

# 📖 The Profile Object

Fields' description and JSON of the Profile Object.

## Profile Object

| Field                              | Type                                                                                           | Description                                        |
| ---------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| <code>key</code>                   | <code>string</code> <span style={{color:"red"}}>Required</span>                                | Identification key of the Profile.                 |
| <code>reference</code>             | <code>string</code> <span style={{color:"red"}}>Required</span>                                | Custom identifier of the Profile.                  |
| <code>info</code>                  | [Info](https://developers.hrflow.ai/reference/the-profile-object#info-of-the-profile) <span style={{color:"red"}}>Required</span> | Object containing the Profile's info.              |
| <code>text\_language</code>        | <code>string ISO 639-1</code> <span style={{color:"red"}}>Required</span>                      | Code language of the Profile.                      |
| <code>text</code>                  | <code>string</code> <span style={{color:"red"}}>Required</span>                                | Full text of the Profile.                          |
| <code>consent\_algorithmic</code>  | [Consent Algorithmic](https://developers.hrflow.ai/reference/the-profile-object#consent-algorithmic)                              | Algorithmic consent status of the Profile.         |
| <code>archived\_at</code>          | <code>datetime ISO 8601</code>                                                                 | Archive date of the Profile. Null if not archived. |
| <code>updated\_at</code>           | <code>datetime ISO 8601</code>                                                                 | Last update date of the Profile.                   |
| <code>created\_at</code>           | <code>datetime ISO 8601</code>                                                                 | Creation date of the Profile.                      |
| <code>experiences\_duration</code> | <code>float</code>                                                                             | Total number of years of experience.               |
| <code>educations\_duration</code>  | <code>float</code>                                                                             | Total number of years of education.                |
| <code>experiences</code>           | [Experiences](https://developers.hrflow.ai/reference/the-profile-object#experiences)                                              | List of experiences of the Profile.                |
| <code>educations</code>            | [Educations](https://developers.hrflow.ai/reference/the-profile-object#educations)                                                | List of educations of the Profile.                 |
| <code>attachments</code>           | [Attachments](https://developers.hrflow.ai/reference/the-profile-object#attachments)                                              | List of documents attached to the Profile.         |
| <code>skills</code>                | [Skills](https://developers.hrflow.ai/reference/objects#skills)                                                                   | List of skills of the Profile.                     |
| <code>languages</code>             | [Languages](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)       | List of spoken languages of the Profile.           |
| <code>certifications</code>        | [Certifications](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)  | List of certifications of the Profile.             |
| <code>courses</code>               | [Courses](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)         | List of courses of the Profile.                    |
| <code>tasks</code>                 | [Tasks](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)           | List of tasks of the Profile.                      |
| <code>interests</code>             | [Interests](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)       | List of interests of the Profile.                  |
| <code>tags</code>                  | [Tags](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)            | List of tags of the Profile.                       |
| <code>ranges</code>                | [Ranges](https://developers.hrflow.ai/reference/objects#ranges)                                                                   | List of ranges of the Profile.                     |
| <code>metadatas</code>             | [Metadatas](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)       | List of metadatas of the Profile.                  |
| <code>labels</code>                | [Labels](https://developers.hrflow.ai/reference/objects#labels)                                                                   | List of labels of the Profile.                     |

## Info of the Profile

Info is an object accessible via the field <code>info</code> and follows the structure below:

| Field                    | Type                             | Description                                               |
| ------------------------ | -------------------------------- | --------------------------------------------------------- |
| <code>full\_name</code>  | <code>string</code>              | Profile full name.                                        |
| <code>first\_name</code> | <code>string</code>              | Profile first name.                                       |
| <code>last\_name</code>  | <code>string</code>              | Profile last name.                                        |
| <code>email</code>       | <code>string</code>              | Profile email.                                            |
| <code>phone</code>       | <code>string</code>              | Profile phone number.                                     |
| <code>date\_birth</code> | <code>datetime ISO 8601</code>   | Profile date of birth.                                    |
| <code>location</code>    | [Location](https://developers.hrflow.ai/reference/objects#location) | Profile location object.                                  |
| <code>urls</code>        | [URLs](https://developers.hrflow.ai/reference/objects#urls)         | Profile social URLs.                                      |
| <code>picture</code>     | <code>string</code>              | Profile picture URL.                                      |
| <code>gender</code>      | <code>string</code>              | Profile gender: <code>male</code> or <code>female</code>. |
| <code>summary</code>     | <code>string</code>              | Profile summary text.                                     |

## Experiences

Experiences is an array of objects accessible via the field <code>experiences</code> and follows the structure below:

| Field                       | Type                                                                                          | Description                              |
| --------------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------- |
| <code>key</code>            | <code>string</code>                                                                           | Identification key of the Experience.    |
| <code>company</code>        | <code>string</code>                                                                           | Company name of the Experience.          |
| <code>logo</code>           | <code>string</code>                                                                           | Logo of the company.                     |
| <code>title</code>          | <code>string</code>                                                                           | Title of the Experience.                 |
| <code>description</code>    | <code>string</code>                                                                           | Description of the Experience.           |
| <code>location</code>       | [Location](https://developers.hrflow.ai/reference/objects#location)                                                              | Location object of the Experience.       |
| <code>date\_start</code>    | <code>datetime ISO 8601</code>                                                                | Start date of the Experience.            |
| <code>date\_end</code>      | <code>datetime ISO 8601</code>                                                                | End date of the Experience.              |
| <code>skills</code>         | [Skills](https://developers.hrflow.ai/reference/objects#skills)                                                                  | List of skills used in the Experience.   |
| <code>certifications</code> | [Certifications](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas) | List of certifications gained.           |
| <code>courses</code>        | [Courses](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)        | List of courses completed.               |
| <code>tasks</code>          | [Tasks](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)          | Tasks performed during the Experience.   |
| <code>languages</code>      | [Languages](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)      | Languages used in the Experience.        |
| <code>interests</code>      | [Interests](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)      | Related interests during the Experience. |

## Educations

Educations is an array of objects accessible via the field <code>educations</code> and follows the structure below:

| Field                       | Type                                                                                          | Description                                 |
| --------------------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------- |
| <code>key</code>            | <code>string</code>                                                                           | Identification key of the Education.        |
| <code>school</code>         | <code>string</code>                                                                           | School or university name.                  |
| <code>logo</code>           | <code>string</code>                                                                           | Logo of the school.                         |
| <code>title</code>          | <code>string</code>                                                                           | Title or degree of the Education.           |
| <code>description</code>    | <code>string</code>                                                                           | Description of the Education.               |
| <code>location</code>       | [Location](https://developers.hrflow.ai/reference/objects#location)                                                              | Location object of the Education.           |
| <code>date\_start</code>    | <code>datetime ISO 8601</code>                                                                | Start date of the Education.                |
| <code>date\_end</code>      | <code>datetime ISO 8601</code>                                                                | End date of the Education.                  |
| <code>skills</code>         | [Skills](https://developers.hrflow.ai/reference/objects#skills)                                                                  | List of skills gained during the Education. |
| <code>certifications</code> | [Certifications](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas) | Certifications acquired.                    |
| <code>courses</code>        | [Courses](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)        | Courses taken.                              |
| <code>tasks</code>          | [Tasks](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)          | Tasks completed.                            |
| <code>languages</code>      | [Languages](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)      | Languages studied.                          |
| <code>interests</code>      | [Interests](https://developers.hrflow.ai/reference/objects#languages-certifications-courses-tasks-interests-tags-metadatas)      | Related interests.                          |

## Consent Algorithmic

The `consent_algorithmic` object contains 2 sub-objects:

* `owner`: Data Owner’s consent for processing their own profile.
* `controller`: Data Controller’s consent (e.g. recruiter/company).

| Field                              | Type                | Description                             |
| ---------------------------------- | ------------------- | --------------------------------------- |
| <code>owner.parsing</code>         | <code>string</code> | Parsing consent for Data Owner.         |
| <code>owner.revealing</code>       | <code>string</code> | Revealing consent for Data Owner.       |
| <code>owner.embedding</code>       | <code>string</code> | Embedding consent for Data Owner.       |
| <code>owner.searching</code>       | <code>string</code> | Searching consent for Data Owner.       |
| <code>owner.scoring</code>         | <code>string</code> | Scoring consent for Data Owner.         |
| <code>owner.upskilling</code>      | <code>string</code> | Upskilling consent for Data Owner.      |
| <code>controller.parsing</code>    | <code>string</code> | Parsing consent for Data Controller.    |
| <code>controller.revealing</code>  | <code>string</code> | Revealing consent for Data Controller.  |
| <code>controller.embedding</code>  | <code>string</code> | Embedding consent for Data Controller.  |
| <code>controller.searching</code>  | <code>string</code> | Searching consent for Data Controller.  |
| <code>controller.scoring</code>    | <code>string</code> | Scoring consent for Data Controller.    |
| <code>controller.upskilling</code> | <code>string</code> | Upskilling consent for Data Controller. |

## Example of Profile JSON

```json Profile Object
{
  "key": "8af2b7a0b48fbc936ace283ec020b0d6d4c4b018",
  "reference": null,
  "consent_algorithmic": {
    "owner": {
      "parsing": true,
      "revealing": false,
      "embedding": true,
      "searching": true,
      "scoring": true,
      "reasoning": false
    },
    "controller": {
      "parsing": true,
      "revealing": false,
      "embedding": true,
      "searching": true,
      "scoring": true,
      "reasoning": false
    }
  },
  "archived_at": null,
  "updated_at": "2021-12-10T15:18:46+0000",
  "created_at": "2021-12-10T15:18:46+0000",
  "info": {
    "full_name": "Harry James Potter",
    "first_name": "Harry James",
    "last_name": "Potter",
    "email": "harry.potter@hogwarts.net",
    "phone": "0747532699",
    "date_birth": "1997-06-26T00:00:00+0000",
    "location": {
      "text": "Number 4, Privet Drive, Little Whinging",
      "lat": null,
      "lng": null,
      "gmaps": null,
      "fields": null
    },
    "urls": [
      {"type": "from_resume", "url" : "https://hrflow.ai/"},
      {"type": "from_resume", "url" : "https://developers.hrflow.ai/"},
      {"type": "linkedin", "url" : "https://fr.linkedin.com/doe-john"},
      {"type": "linkedin", "url" : "https://fr.linkedin.com/doe-jane"},
      {"type": "twitter", "url" : "https://twitter.com/hrflowai"},
      {"type": "facebook", "url" : "https://www.facebook.com/hrflowai/"},  
      {"type": "github", "url" : "https://github.com/harry-james-potter"}
  ],
    "picture": null,
    "gender": "male",
    "summary": "Sorcerer Apprentice"
  },
  "text_language": "en",
  "text": "Harry James Potter\nSorcerer Apprentice\n\ndate of birth: June 26th 1997\nNumber 4, Privet Drive, Little Whinging\nemail: harry.potter@hogwarts.net\nphone: 0747532699\n\nExperiences\n\nApril 2002 - July 2002\tHogwarts School of Witchcraft and Wizardry\nMagic Investigator\nSolving mysteries about the Sorcerer's stone.\nteamplayer, empathy.\n\nEducations\n\nDecember 2001 - December 2002\tHogwarts School of Witchcraft and Wizardry\nSorcerer Apprentice\nFirst year of study.\nwitchcraft, levitation, lycanthropy.\n\nSkills\n\nwitchcraft\ndark arts\nperseverance\nempathy\n\nInterests\n\nquidditch\nwizard chess",
  "experiences_duration": 0.25,
  "educations_duration": 1,
  "experiences": [
    {
      "key": "8af2b7a0b48fbc936ace283ec020b0d6d4c4b019",
      "company": "Hogwarts School of Witchcraft and Wizardry",
      "logo": null,
      "title": "Magic Investigator",
      "description": "Solving mysteries about the Sorcerer's stone.",
      "location": {
        "text": "Hogwarts",
        "lat": null,
        "lng": null,
        "gmaps": null,
        "fields": null
      },
      "date_start": "2002-04-01T00:00:00+0000",
      "date_end": "2002-07-01T00:00:00+0000",
      "skills": [
        {
          "name": "teamplayer",
          "type": "soft",
          "value": null
        },
        {
          "name": "empathy",
          "type": "soft",
          "value": null
        }
      ],
      "certifications": [],
      "courses": [],
      "tasks": [],
      "languages": [],
      "interests": []
    }
  ],
  "educations": [
    {
      "key": "8af2b7a0b48fbc936ace283ec020b0d6d4c4b020",
      "school": "Hogwarts School of Witchcraft and Wizardry",
      "logo": null,
      "title": "Sorcerer Apprentice",
      "description": "First year of study.",
      "location": {
        "text": "Hogwarts",
        "lat": null,
        "lng": null,
        "gmaps": null,
        "fields": null
      },
      "date_start": "2001-12-01T00:00:00+0000",
      "date_end": "2002-12-01T00:00:00+0000",
      "skills": [
        {
          "name": "witchcraft",
          "type": "hard",
          "value": null
        },
        {
          "name": "levitation",
          "type": "hard",
          "value": null
        },
        {
          "name": "lycanthropy",
          "type": "hard",
          "value": null
        }
      ],
      "certifications": [],
      "courses": [],
      "tasks": [],
      "languages": [],
      "interests": []
    }
  ],
  "attachments": [],
  "skills": [
    {
      "name": "witchcraft",
      "type": "hard",
      "value": null
    },
    {
      "name": "dark arts",
      "type": "hard",
      "value": null
    },
    {
      "name": "perseverance",
      "type": "soft",
      "value": null
    },
    {
      "name": "empathy",
      "type": "soft",
      "value": null
    }
  ],
  "languages": [],
  "certifications": [],
  "courses": [],
  "tasks": [],
  "interests": [
    {
      "name": "quidditch",
      "value": null
    },
    {
      "name": "wizard chess",
      "value": null
    }
  ],
  "labels": [],
  "tags": [
    {
      "name": "contract_type",
      "value": "Full Time"
    }
  ],
  "ranges": [
  	{
    	"name": "salary_expectation",
    	"value_min": "45000",
    	"value_max": "60000"
  	},
  	{
    	"name": "availability",
    	"value_min": "2026-09-01",
    	"value_max": "2026-12-31"
  	}
],
  "metadatas": []
}
```

<br />