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

# Search Blueprint Entities

Search for blueprint entities in your software catalog based on a set of rules.

<Note>
  External Documentation

  To learn more, visit the [Port documentation](https://docs.port.io/api-reference/search-a-blueprints-entities/).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Blueprint Identifier | The ID of the blueprint to search entities for.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
  | Exclude              | A comma-separated list of properties to exclude from the response.<br /><br />**Note:** To use `Meta-properties` - the `$` prefix must be included (e.g. `$createdAt`, `$updatedAt`).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
  | From                 | The token to use for pagination. Can be obtained from the `next` property from a previous response.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | Include              | A comma-separated list of properties to include in the response.<br /><br />**Note:** To use `Meta-properties` - the `$` prefix must be included (e.g. `$createdAt`, `$updatedAt`).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | Limit                | The maximum number of entities to return in the response. Valid range is `1` to `1000`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
  | Query Combinator     | The combinator to apply to the search rules.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
  | Return All Pages     | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | Rules                | A list of search rules to apply to the blueprint entities.<br /><br />**For example:**<br />  <pre><code>\[<br />      \{<br />        "property": "\$blueprint",<br />        "operator": "=",<br />        "value": "service"<br />      },<br />      \{<br />        "combinator": "or",<br />        "rules": \[<br />          \{<br />            "property": "environment",<br />            "operator": "=",<br />            "value": "production"<br />          },<br />          \{<br />            "property": "environment",<br />            "operator": "=",<br />            "value": "staging"<br />          }<br />        ]<br />      }<br />    ]<br /></code></pre> |
  | Use Query            | Select to use the query parameters (rules and combinator).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
</div>

## Example Output

```json theme={"dark"}
{
	"ok": true,
	"next": "string",
	"entities": [
		{
			"identifier": "string",
			"title": "string",
			"icon": "string",
			"team": "string",
			"properties": {},
			"relations": {}
		}
	]
}
```

## Workflow Library Example

[Search Blueprint Entities with Port and Send Results Via Email](https://library.blinkops.com/workflows/search-blueprint-entities-with-port-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/search-blueprint-entities-with-port-and-send-results-via-email/canvas" />
</div>
