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 — see Which scope for which host.

Examples use the environment variables from Environments and default to the test environment.

Older endpoints: PascalCase and no interactive reference

These endpoints predate the Integration API. They are not in the interactive API reference, and they answer in PascalCase (ProjNumber, Description) unlike the rest of the API. Send the header case: camel-case to get camelCase property names instead.

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" \
  -H "case: camel-case" \
  "$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/...)
Who is on a project and their project role	Integration API: project personnel
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 External References — the validated lists behind externalProjectNumber and sub project numbers
• Project Metadata — paginated bulk export