> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Contacts

Retrieve a list of contacts for the organization.

**Note:** Maximum `60` requests per minute are allowed.

For more information about the required permissions refer to [Access Control](https://docs.usepylon.com/pylon-docs/customer-portal/access-control).

<Note>
  External Documentation

  To learn more, visit the [Pylon documentation](https://docs.usepylon.com/pylon-docs/developer/api/api-reference/contacts#get-contacts).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                    |
  | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
  | Cursor           | The pagination token used to specify the next page of results. Can be obtained from the `pagination.cursor` property from a previous response. |
  | Limit            | The maximum number of results to return per page. The valid range is `1` - `999`.                                                              |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                               |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"account": {
				"id": "text"
			},
			"avatar_url": "text",
			"custom_fields": {
				"ANY_ADDITIONAL_PROPERTY": {
					"slug": "text",
					"value": "text",
					"values": [
						"text"
					]
				}
			},
			"email": "text",
			"emails": [
				"text"
			],
			"external_ids": [
				{
					"external_id": "text",
					"label": "text"
				}
			],
			"id": "text",
			"integration_user_ids": [
				{
					"id": "text",
					"source": "text"
				}
			],
			"name": "text",
			"phone_numbers": [
				"text"
			],
			"portal_role": "no_access",
			"portal_role_id": "text",
			"primary_phone_number": "text"
		}
	],
	"pagination": {
		"cursor": "text",
		"has_next_page": true
	},
	"request_id": "text"
}
```

## Workflow Library Example

[List Contacts with Pylon and Send Results Via Email](https://library.blinkops.com/workflows/list-contacts-with-pylon-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-contacts-with-pylon-and-send-results-via-email/canvas" />
</div>