> ## 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

Get a list of contacts with optional filtering.

<Note>
  External Documentation

  To learn more, visit the [Oracle Service Cloud documentation](https://docs.oracle.com/en/cloud/saas/b2c-service/cxsvc/op-services-rest-connect-v1.4-contacts-get.html).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter           | Description                                                                                                                                                                                                                                                                                      |
  | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Application Context | The application context information to attach as `OSvC-CREST-Application-Context` request header. For more information, please refer to [Oracle documentation](https://docs.oracle.com/en/cloud/saas/b2c-service/cxsvc/c_osvc_custom_headers.html#CustomHeaders-12F270BF__concept-102-2DB1C328). |
  | Fields              | A comma-separated list of attributes to return for each object in the response.                                                                                                                                                                                                                  |
  | Limit               | The maximum number of results to return per page.                                                                                                                                                                                                                                                |
  | Offset              | The pagination offset indicating the starting point for the next set of results.                                                                                                                                                                                                                 |
  | Order By            | A comma-separated list of attributes and order, used to determine the order in which the records are returned.                                                                                                                                                                                   |
  | Return All Pages    | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                 |
  | Search Query        | The ROQL to filter the results by. For more information, please refer to [Oracle's documentation](https://docs.oracle.com/middleware/12212/adapter-rightnow/using-rightnow-adapter/GUID-0D1B2623-1C65-4966-B715-12F58E0CDE9B.htm).                                                               |
  | Total Results       | Select whether to return the total count of available results.                                                                                                                                                                                                                                   |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter          | Description                                                                                                                                                                                                                                                                                                                                                             |
  | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Next Request After | The time (in milliseconds) that must elapse before subsequent API calls will be executed. This value will be attached as `osvc-crest-next-request-after` request header. For more information, please refer to [Oracle documentation](https://docs.oracle.com/en/cloud/saas/b2c-service/cxsvc/c_osvc_custom_headers.html#CustomHeaders-12F270BF__concept-136-12F2B577). |
</div>

## Example Output

```json theme={"dark"}
{
	"items": [
		{
			"id": 2,
			"lookupName": "Susan Meadows",
			"createdTime": "2013-08-21T20:30:18Z",
			"updatedTime": "2013-08-21T21:02:09Z",
			"links": [
				{
					"rel": "canonical",
					"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/2"
				}
			]
		},
		{
			"id": 3,
			"lookupName": "George Langston",
			"createdTime": "2013-08-21T20:31:10Z",
			"updatedTime": "2013-08-21T21:04:22Z",
			"links": [
				{
					"rel": "canonical",
					"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/3"
				}
			]
		},
		{
			"id": 82,
			"lookupName": "Calvin Hobbes",
			"createdTime": "2015-09-29T20:15:35Z",
			"updatedTime": "2015-09-29T20:15:35Z",
			"links": [
				{
					"rel": "canonical",
					"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts/82"
				}
			]
		}
	],
	"hasMore": false,
	"links": [
		{
			"rel": "canonical",
			"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts"
		},
		{
			"rel": "describedby",
			"href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/contacts",
			"mediaType": "application/schema+json"
		},
		{
			"rel": "self",
			"href": "https://mysite.example.com/services/rest/connect/v1.4/contacts"
		}
	]
}
```

## Workflow Library Example

[List Contacts with Oracle Service Cloud and Send Results Via Email](https://library.blinkops.com/workflows/list-contacts-with-oracle-service-cloud-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-oracle-service-cloud-and-send-results-via-email/canvas" />
</div>