> ## 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).
</Note>

## Parameters

<div className="integrations-table">
  | 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.                                                                |
</div>

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

<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-custom-objects-with-freshservice-and-send-results-via-email/canvas" />
</div>