Use this endpoint to suggest first names with /FIRSTNAMESUGGEST/ or last names with /LASTNAMESUGGEST/, using the GET method.
Related Name documentation:
Name GET request
/FIRSTNAMESUGGEST/
This endpoint provides a list of first names based on the user's input.
Endpoint
https://{SERVER_ADDRESS}/FIRSTNAMESUGGEST/?Firstname={FIRST_NAME}&Gender={GENDER}&NBResponse={NUM}&Licence={LICENCE_CODE}&Country={COUNTRY_CODE}&Format={FORMAT}&Verifname=YReplace the values in braces with your own information:
| 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/?Lastname={NAME}&NBResponse={NUM}&Licence={LICENCE_CODE}Replace the values in braces with your own information:
| 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