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

Retrieve all custom objects.

**Note:** By default, only Custom objects from the primary workspace will be returned for accounts with workspaces. For Custom objects from other workspaces, use the `Workspace ID` filter.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Freshservice documentation](https://api.freshservice.com/#list_all_custom_objects).

## Parameters

| Parameter | Description |
| - | - |
| Page | The page number of the results to retrieve. |
| Per Page | The maximum number of records to retrieve per page. Values can range from `1` to `100`. |
| Return All Pages | Automatically fetch all resources, page by page. |
| Workspace ID | The ID of the workspace. |

## Example Output

```json theme={"dark"}
{
	"custom_objects": [
		{
			"id": 1000040838,
			"title": "Service Item Approvals",
			"description": "This is a sample object to store additional information about the Items available on the Service Catalog such as designated Approvers, Vendor Information and Category. When a request for an item in this list is raised, you can use this information within the workflows to enrich your automations. Check out our sample workflow “Service Item Approvals/Routing with Custom Objects”",
			"updated_at": "2021-02-17T14:29:08Z",
			"last_updated_by": {
				"email": "system-noreply@domain.freshservice.com",
				"id": 1232007390,
				"name": "System"
			},
			"workspace_id": 2
		}
	],
	"meta": {
		"count": 1,
		"page": 1,
		"per_page": 30
	}
}
```

## Workflow Library Example

[List Custom Objects with Freshservice and Send Results Via Email](https://library.blinkops.com/workflows/list-custom-objects-with-freshservice-and-send-results-via-email)

![Workflow Library](https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max\&auto=format\&n=ojHYuDeYX5FWuN8a\&q=85\&s=b8af968e71438a9499c3223c9bd29fb2)

Preview this Workflow on desktop

[https://library.blinkops.com/workflows/list-custom-objects-with-freshservice-and-send-results-via-email/canvas](https://library.blinkops.com/workflows/list-custom-objects-with-freshservice-and-send-results-via-email/canvas)