Projects & Resources (read-only)

Read-only lookup endpoints on the core API for projects, their tasks, and resources. These are handy for on-demand lookups (e.g. populating a dropdown in your integration’s configuration UI). All use the ditioapiv3 scope.

# Test (default for all examples)
export DITIO_API_BASE="https://core-api.ditio.dev/core"
# Production: export DITIO_API_BASE="https://core-api.ditio.app/core"

Endpoints

Method	Route	Description
GET	/api/projects	Projects in your company (active only by default)
GET	/api/projects/search	Search projects by text
GET	/api/projects/{projId}	Get a single project
GET	/api/projects/{projId}/tasks	List a project’s tasks (work orders)
GET	/api/resources/details/{resourceId}	Get resource details
GET	/api/resources/types	List resource types

List projects

GET /api/projects

Returns only active projects by default. Control this with activeInactiveAll:

• ?activeInactiveAll=1 — only inactive projects
• ?activeInactiveAll=2 — all projects (active and inactive)

curl -H "Authorization: Bearer $TOKEN" \
  "$DITIO_API_BASE/api/projects?activeInactiveAll=2"

Search projects

GET /api/projects/search?searchString={text}&activeOnly=true

Project tasks

GET /api/projects/{projId}/tasks

Supports the same activeInactiveAll parameter.

Which project surface should I use?

Need	Use
Create/update projects and work orders	Integration API (api/v4/integration/...)
Mirror the whole catalogue into BI / a warehouse	Project Metadata extraction (/v1/project, paginated)
Quick on-demand lookups	These endpoints

Related

• Projects (Integration API) — full CRUD
• Project Metadata — paginated bulk export
• Interactive API reference — schemas and try-it for these endpoints