## List all individuals (client profiles)

`individuals.list(IndividualListParams**kwargs)  -> SyncCursorPagination[Individual]`

**get** `/individuals`

Retrieve a paginated list of client profiles/individuals using cursor-based pagination

### Parameters

- `after: Optional[str]`

  Cursor for forward pagination. Returns items after this cursor.

- `before: Optional[str]`

  Cursor for backward pagination. Returns items before this cursor.

- `household_id: Optional[str]`

  Filter individuals by household ID

- `is_primary: Optional[bool]`

  Filter by primary client status

- `limit: Optional[int]`

  Maximum number of items to return

### Returns

- `class Individual: …`

  - `id: str`

    Unique identifier with client_profile_ prefix

  - `created_at: datetime`

    Timestamp when the individual was created

  - `first_name: str`

    First name of the individual

  - `household_id: str`

    Household ID this individual belongs to

  - `is_beneficiary: bool`

    Whether this client profile should be an eligible beneficiary for entities and gifts

  - `is_deceased: bool`

    Whether this client profile is deceased

  - `is_grantor: bool`

    Whether this client profile should be an eligible grantor/owner/other principal for entities

  - `is_primary: bool`

    Whether this is one of the (at most) two primary clients on this household

  - `is_trustee: bool`

    Whether this client profile should be an eligible trustee for entities

  - `last_name: str`

    Last name of the individual

  - `updated_at: datetime`

    Timestamp when the individual was last updated

  - `address_line1: Optional[str]`

    Street address line 1 (from address edge)

  - `address_line2: Optional[str]`

    Street address line 2 (from address edge)

  - `city: Optional[str]`

    City (from address edge)

  - `country: Optional[str]`

    Country (from address edge)

  - `date_of_birth: Optional[date]`

    Date of birth (encrypted field)

  - `date_of_death: Optional[date]`

    Date of death if applicable (encrypted field)

  - `deleted_at: Optional[datetime]`

    Timestamp when the individual was soft deleted

  - `email: Optional[str]`

    Email address

  - `middle_name: Optional[str]`

    Middle name of the individual

  - `notes: Optional[str]`

    Notes about the client profile

  - `postal_code: Optional[str]`

    ZIP or postal code (from address edge)

  - `state: Optional[str]`

    State or province (from address edge)

  - `suffix: Optional[str]`

    Name suffix (Jr., Sr., III, etc.)

### Example

```python
from withluminary import Luminary

client = Luminary()
page = client.individuals.list()
page = page.data[0]
print(page.id)
```

#### Response

```json
{
  "data": [
    {
      "id": "client_profile_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "created_at": "2024-01-15T09:30:00Z",
      "first_name": "John",
      "household_id": "household_01ARZ3NDEKTSV4RRFFQ69G5FAV",
      "is_beneficiary": true,
      "is_deceased": true,
      "is_grantor": true,
      "is_primary": true,
      "is_trustee": true,
      "last_name": "Smith",
      "updated_at": "2024-01-20T14:45:00Z",
      "address_line1": "123 Main St",
      "address_line2": "Apt 4B",
      "city": "San Francisco",
      "country": "USA",
      "date_of_birth": "1980-05-15",
      "date_of_death": "2019-12-27",
      "deleted_at": "2019-12-27T18:11:19.117Z",
      "email": "john.smith@example.com",
      "middle_name": "Michael",
      "notes": "notes",
      "postal_code": "94102",
      "state": "CA",
      "suffix": "Jr."
    }
  ],
  "page_info": {
    "has_next_page": true,
    "has_previous_page": false,
    "end_cursor": "eyJpZCI6ImhvdXNlaG9sZF8wMUFSWjNOREVLVFNWNFJSRkZRNjlHNUZBViJ9",
    "start_cursor": "eyJpZCI6ImhvdXNlaG9sZF8wMUFSWjNOREVLVFNWNFJSRkZRNjlHNUZBViJ9"
  },
  "total_count": 100
}
```