The Projects API returns project and task data, allowing you to programmatically retrieve work items, assignments, and status information.

Endpoint

POST: https://api.ag.prodoscore.com/query/projects/project_api

Request Payload

Key Parameters

Pagination:

• page — Results page (default: 1)
• limit — Records per page (default: 50, max: 500)

Filters:

• group_id — Filter by team/group
• user_id — Filter by assignee user ID
• search — Text search (searches task name and description)
• start_date, end_date — Date range filter (YYYY-MM-DD)

Sorting:

• sort_by — Column to sort by (e.g., "created_date", "due_date", "project_name")
• desc — true for descending, false for ascending (default: false)

Response Fields

Each task record includes:

• task_id — Unique task identifier
• task_name — Task title
• project_id — Associated project identifier
• project_name — Project title
• project_owner — Project owner name
• assignee_id — User ID of assignee
• assignee_name — Full name of assignee
• reporter_id — User ID of task reporter
• reporter_name — Full name of task reporter
• status_id — Status identifier
• status_name — Status (e.g., "TODO", "IN PROGRESS", "DONE")
• created_date — Task creation date (ISO 8601)
• start_date — Task start date
• due_date — Task due date
• description — Task description (if available)
• priority — Task priority level

Example Response

Break Report API (Related)

A companion endpoint for break data:

Endpoint: POST https://api.ag.prodoscore.com/query/reports/break_report

Returns per break record:

• break_start — Break start timestamp
• break_end — Break end timestamp
• break_duration — Duration in seconds
• break_type — Type of break (e.g., "Lunch", "Tea")
• employee_name — Employee who took the break
• employee_id — Employee identifier
• team_name — Employee's team

Request payload follows the same pattern: start_date, end_date, group_id, user_id, page, limit

Use Cases

• Project Status Export: Export all tasks for a specific project to compare with external tools
• Team Workload Analysis: Get tasks by team to understand load distribution
• Overdue Task Tracking: Filter for tasks past their due_date to identify at-risk work items
• Time Tracking Integration: Use task assignments to correlate with time-tracking data from the productivity API