Use this endpoint to suggest first names with /FIRSTNAMESUGGEST/ or last names with /LASTNAMESUGGEST/, using the POST method.
Related Name documentation:
Name POST request
/FIRSTNAMESUGGEST/
This endpoint provides a list of first names based on the user's input.
Endpoint
https://{SERVER_ADDRESS}/FIRSTNAMESUGGEST/Add the following parameters in the request body using x-www-form-urlencoded.
| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| Licence | {LICENCE_CODE} |
Licence code assigned to your account. | Mandatory |
| Firstname | {FIRST_NAME} |
Part of the first name already entered by the user. | Mandatory |
| Gender | {GENDER} |
M, F, or I. |
Optional |
| NBResponse | {NUM} |
Maximum number of suggestions to return. | Optional. Default: 10. |
| Country | {COUNTRY_CODE} |
ISO 3-letter country code used to prioritize suggestions. | Optional |
| Format | {FORMAT} |
Desired output format. | Optional. Default: 0. |
| Verifname | Y |
Checks whether the first name exists without autocomplete. | Optional |
Format values
| Format | Description |
|---|---|
0 |
First name in uppercase without accents. |
1 |
First letter uppercase without accents. |
2 |
First name in lowercase without accents. |
/LASTNAMESUGGEST/
This endpoint provides a list of last names based on the user's input.
Endpoint
https://{SERVER_ADDRESS}/LASTNAMESUGGEST/Add the following parameters in the request body using x-www-form-urlencoded.
| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| Licence | {LICENCE_CODE} |
Licence code assigned to your account. | Mandatory |
| Lastname | {NAME} |
Part of the last name already entered by the user. | Mandatory |
| NBResponse | {NUM} |
Maximum number of suggestions to return. | Optional. Default: 10. |
Related to