## List

`contact.list(ContactListParams**kwargs)  -> ContactListResponse`

**get** `/v1/contacts`

Returns a paginated list of contacts. Use `offset` and `limit` to paginate through results. See <u>[List endpoints](/using-the-api/list-endpoints/)</u> for more information about pagination.

**[Required scope](/using-the-api/scopes/):** `contacts:read`

**[Rate limit category](/using-the-api/rate-limits/):** Search

### Parameters

- `limit: Optional[int]`

  Maximum number of records to return. Defaults to 25, maximum 25.

- `offset: Optional[int]`

  Number of records to skip for pagination. Defaults to 0.

### Returns

- `class ContactListResponse: …`

  - `data: List[Data]`

    Array of entity objects for the current page.

    - `id: str`

      Unique identifier for the entity.

    - `created_at: str`

      ISO 8601 timestamp of when the entity was created.

    - `fields: Dict[str, DataFields]`

      Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.

      - `value: Union[str, float, bool, 3 more]`

        The field value, or null if unset.

        - `str`

        - `float`

        - `bool`

        - `List[Union[str, float, bool, 3 more]]`

          - `str`

          - `float`

          - `bool`

          - `List[Optional[object]]`

          - `Dict[str, object]`

        - `Dict[str, Union[str, float, bool, 3 more]]`

          - `str`

          - `float`

          - `bool`

          - `List[Optional[object]]`

          - `Dict[str, object]`

      - `value_type: Literal["ADDRESS", "CHECKBOX", "CURRENCY", 11 more]`

        The data type of the field.

        - `"ADDRESS"`

        - `"CHECKBOX"`

        - `"CURRENCY"`

        - `"DATETIME"`

        - `"EMAIL"`

        - `"FULL_NAME"`

        - `"MARKDOWN"`

        - `"MULTI_SELECT"`

        - `"NUMBER"`

        - `"SINGLE_SELECT"`

        - `"SOCIAL_HANDLE"`

        - `"TELEPHONE"`

        - `"TEXT"`

        - `"URL"`

    - `http_link: Optional[str]`

      URL to view the entity in the Lightfield web app, or null.

    - `relationships: Dict[str, DataRelationships]`

      Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).

      - `cardinality: str`

        Whether the relationship is `has_one` or `has_many`.

      - `object_type: str`

        The type of the related object (e.g. `account`, `contact`).

      - `values: List[str]`

        IDs of the related entities.

  - `object: str`

    The object type, always `"list"`.

  - `total_count: int`

    Total number of entities matching the query.

### Example

```python
from lightfield import Lightfield

client = Lightfield(
    api_key="My API Key",
)
contact_list_response = client.contact.list()
print(contact_list_response.data)
```