GET /api/v1/me/natural-person

Retrieve detailed personal information for the authenticated user.

Endpoint

GET /api/v1/me/natural-person

Authentication

Requires a valid OAuth access token with the eprospera:person.details.read scope.

Authorization: Bearer <access-token>

Required Scopes

• eprospera:person.details.read

Request

No request body or query parameters required.

Example Request

curl https://portal.eprospera.com/api/v1/me/natural-person \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

Response

Success Response (200 OK)

Returns detailed personal information for the authenticated user.

Field	Type	Description
givenName	string	User's first/given name
surname	string	User's last name/surname
name	string	Full name (formatted combination of given name and surname)
residentPermitNumber	string	Próspera Resident Permit Number (RPN)
countryOfBirth	string | null	Country where the user was born
citizenships	string[]	Array of countries where the user holds citizenship
dateOfBirth	string | null	Date of birth in ISO 8601 format (YYYY-MM-DD)
sex	string | null	Biological sex (Male, Female, or Other)
address	object | null	Current residential address
address.country	string	Country
address.line1	string	Address line 1 (street address)
address.line2	string | null	Address line 2 (apartment, suite, etc.)
address.city	string	City
address.state	string | null	State/Province/Region
address.postalCode	string	Postal/ZIP code
phoneNumber	string | null	Formatted phone number with country code

Example Response

{
  "givenName": "Maria",
  "surname": "Rodriguez",
  "name": "Maria Rodriguez",
  "residentPermitNumber": "90000000000123",
  "countryOfBirth": "Honduras",
  "citizenships": ["Honduras", "United States"],
  "dateOfBirth": "1990-05-15",
  "sex": "Female",
  "address": {
    "country": "Honduras",
    "line1": "Calle Principal 123",
    "line2": "Apt 4B",
    "city": "Roatan",
    "state": "Islas de la Bahía",
    "postalCode": "34101"
  },
  "phoneNumber": "+50498765432"
}

Null User Response

If no natural person record exists for the authenticated user:

null

Error Responses

401 Unauthorized - Missing Token

{
  "error": "missing_token"
}

401 Unauthorized - Invalid Token

{
  "error": "invalid_token"
}

401 Unauthorized - Insufficient Scopes

{
  "error": "missing_scopes: eprospera:person.details.read"
}

500 Internal Server Error

{
  "error": "Internal server error"
}

Usage Notes

• This endpoint returns information from the user's e-Próspera profile
• All users with approved residency applications will have a natural person record
• The residentPermitNumber is a unique identifier for each resident
• Phone numbers are formatted according to international standards (E.164)
• Date of birth is returned in ISO 8601 format (YYYY-MM-DD)
• Address information reflects the user's current registered address
• Citizenships array may be empty if the user hasn't provided this information
• Multiple citizenships are supported and returned as an array

Data Privacy

• Only the authenticated user's own data is accessible
• Data is only returned if the correct scope is granted during OAuth authorization
• All personal information is subject to e-Próspera's privacy policy
• Access tokens should be kept secure and never exposed in client-side code or logs

Related Endpoints

• GET /api/v1/me/natural-person/id-verification - Retrieve ID verification documents