Getting started
Create API credentials, authenticate with OAuth 2.0 client credentials, and make your first call in five minutes.
Getting started
Create API credentials, authenticate with OAuth 2.0 client credentials, and make your first call in five minutes.
Guides
Workflow-first walkthroughs: export hours for payroll, push excavator telemetry, pull project structures and safety data.
API reference
Every endpoint with schemas, examples, and an in-browser client to try requests against your own account.
Concepts
How Ditio models the site: companies, projects, work orders, transactions, and the approval pipeline.
Every integration starts the same way: exchange your client credentials for a short-lived bearer token, then call the API. Credentials are self-service — any Ditio administrator can create an API client from Company Setup → Integration in Ditio Web.
# Test environment — see Authentication for productionexport DITIO_IDENTITY_BASE="https://identity.ditio.dev"
curl -X POST "$DITIO_IDENTITY_BASE/connect/token" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" \ -d "scope=ditioapiv3"# Test environment — see Authentication for productionexport DITIO_API_BASE="https://core-api.ditio.dev/core"
curl "$DITIO_API_BASE/api/v4/integration/projects" \ -H "Authorization: Bearer $TOKEN"Export time & payroll data
Pull time registrations, absences, and processed payroll lines into your BI or payroll system with cursor-based pagination.
Machine integration
Push excavator states and weight measures from fleet management or scale systems straight into Ditio’s mass-transport workflow.
Projects, people & equipment
Sync projects, work orders, employees, and machines between Ditio and your ERP or HR system — reads and writes.
Safety & compliance
Export checklist completions, HSE incidents, and machine inspection records for compliance reporting.