Project Metadata

Export project metadata and the work breakdown structure (all work orders) — the lookup tables for resolving projectId and taskId references in other exports, or for mirroring the whole project catalogue.

Endpoints

Route	Description
GET /v1/project	Project list with details
GET /v1/project/work-breakdown-structure	Work breakdown structure (all work orders)

• Test base: https://core-api.ditio.dev/reporting
• Production base: https://core-api.ditio.app/reporting
• Scope: reportingapiv1 — see Authentication

Query parameters

Metadata endpoints use the shared filter without a work-date window: ModifiedSince/ModifiedBefore (incremental sync), ProjectId, CompanyId, OwnCompanyDataOnly, ExcludeDataFromSubsidiaries, ChunkLimit, ContinuationToken — see Pagination.

Example

export DITIO_REPORTING_BASE="https://core-api.ditio.dev/reporting"  # test

# Projects
curl -H "Authorization: Bearer $TOKEN" \
  "$DITIO_REPORTING_BASE/v1/project"

# Work breakdown structure
curl -H "Authorization: Bearer $TOKEN" \
  "$DITIO_REPORTING_BASE/v1/project/work-breakdown-structure"

Pagination

Results are paginated using ContinuationToken. See Pagination.

Related

• Project Data guide — integration walkthrough
• Projects (Integration API) — creating and updating projects
• User Metadata — user roster
• Resource Metadata — equipment catalogue