Skip to content

Person

Represents a person with basic identity information.

```typescript
const person: Person = {
name: "John Michael Smith",
displayName: "John Smith",
first: "John",
last: "Smith",
gender: "male",
birthdate: "1990-05-15",
age: 33,
photoURL: "https://example.com/photos/john-smith.jpg"
};
## Fields
| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | ✓ | Full name of the person. |
| `photoURL` | `string \| null` | ✓ | URL to the person's profile photo or avatar. Can be null if no photo is available. |
| `displayName` | `string` | | Preferred display name for the person. Often a shortened or preferred version of their full name. |
| `first` | `string` | ✓ | First name or given name. |
| `last` | `string` | ✓ | Last name or family name. |
| `gender` | `string \| string \| string \| string \| null` | ✓ | Gender identity of the person. Can be null if not specified or prefer not to answer. |
| `birthdate` | `string \| null` | ✓ | Date of birth in ISO 8601 format (YYYY-MM-DD). Can be null if not provided. |
| `age` | `number` | | Current age in years. Typically calculated from birthdate. |
### Field Examples
**name:**
```text
"John Michael Smith"
"Sarah Johnson"

photoURL:

"https://example.com/photos/john-smith.jpg"
"https://cdn.example.com/avatars/user123.png"
null

displayName:

"John Smith"
"Mike"
"Dr. Johnson"

first:

"John"
"Sarah"
"Michael"

last:

"Smith"
"Johnson"
"Williams"

gender:

"male"
"female"
"other"
null

birthdate:

"1990-05-15"
"1985-12-25"
null

age:

33
28
45