Person Retrieval by Passport
GET/v1/api/people/passport/:passport
Returns a person by passport number, with personal data, address and loyalty wallets (loyaltyData).
Request
Path Parameters
Responses
- 200
- 404
Successful retrieval.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
First name.
Last name.
Email.
Phone.
CPF.
Passport.
Date of birth.
Country of origin.
Registration source.
Street.
Address number.
Zip code.
Address complement.
Neighborhood.
City.
State.
Possible values: [ADULT, CHILD, null]
Classification of the age group (Adult or Child).
Legacy field, no longer updated. Read the person's levels from loyaltyData[].tier.
Legacy flag. It does not tell whether the person opted into a loyalty program.
Person ID.
Creation date.
Default value: true
Whether the person is enabled or not.
loyaltyData object[]
The person's loyalty wallets, with balance and level.
ID of the loyalty credential that holds the wallet.
Credential alias, or its ID when it has no alias.
Balance.
Date of the next balance expiration.
Amount that expires on nextExpirationAt.
The person's level in this wallet. For a manual loyalty credential, it is the level set with loyaltyTier.
{
"firstName": "string",
"lastName": "string",
"email": "string",
"phone": "string",
"cpf": "string",
"passport": "string",
"dob": "string",
"country": "string",
"registrationSource": "string",
"addressStreetName": "string",
"addressNumber": "string",
"addressZipCode": "string",
"addressAdditionalInformation": "string",
"addressDistrict": "string",
"addressCity": "string",
"addressState": "string",
"id": "string",
"creationDate": "string",
"enabled": true,
"loyaltyData": [
{
"id": "string",
"alias": "string",
"balance": 0,
"nextExpirationAt": "string",
"nextExpirationValue": 0,
"tier": "string"
}
]
}
No person with this passport in the tenant.
- application/json
- Schema
- Example (from schema)
- Example
Schema
What went wrong, in Portuguese.
Always empty in this API.
{
"errorCode": 404,
"errorMessage": "string",
"errorType": "AmazingNiaraException",
"errorData": {}
}
{
"errorCode": 404,
"errorMessage": "Pessoa com passaporte FT123456 não encontrada",
"errorType": "AmazingNiaraException",
"errorData": {}
}