Upcoming change to Greeting & Title on traveller profiles
Currently available fields:
With the upcoming change, these fields will be deprecated. We are planning to remove these deprecated fields (gender & title) by the end of June 2024.
During the deprecation period, both the old and the new data structures ("greeting", see below) will be available in the API, with transparent conversion of the values.
However, you may only use either structure in a Create / Update request (i.e. do not send a "greeting" along with "gender" and "title" fields as these are mutually exclusive and might partially or fully overwrite each other if used in parallel).
New fields available will be:
Title structure 'Default (Europe)'
Title structure 'Compound (US/UK)'
Important: Depending on the agency settings for 'Title structure', either commonTitle / formalTitle OR compoundTitle are being used. Please consult our documentation for further details.
On top a new field will be available: Name suffix / nameSuffix
Transition logic for deprecated fields
We will continue to support the deprecated fields until their scheduled removal. The following translation logic will be applied:
| Direction | Field | Logic |
|---|---|---|
| From Faces (HTTP GET) | gender |
|
| title | Will be mapped one-to-one from greeting.formalTitle | |
| To Faces (HTTP PATCH / POST) | gender |
|
| title | Will be mapped one-to-one to greeting.formalTitle |
API rate limiting
If we monitor excessive API calls over a longer period, we reserve the right to set a rate limiting or to charge for these calls.