Search entities

post https://api.productboard.com/v2/entities/search

Performs a filtered search over Entities using a POST request. This endpoint supports the same filtering capabilities as GET /v2/entities, but allows a larger and more complex payload. It's useful when filtering by a long list of foreign key IDs or when URL length limits become a problem.

Limitations

Only the AND operator is supported when applying multiple filters. OR, NOT, or nested conditions are not supported.
You can search only within one entity type at a time.

Code examples

Replace <your-token> with a valid API token.

Search for features owned by multiple users:

curl -X POST "https://api.productboard.com/v2/entities/search" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "feature",
    "filter": {
      "owner.id": ["123", "456"]
    }
  }'

Search for initiatives with specific statuses:

curl -X POST "https://api.productboard.com/v2/entities/search" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "initiative",
    "filter": {
      "status.name": ["In Progress", "Done"]
    }
  }'