List projects

GET

/projects

List all projects with pagination.

Request

Authorization

OAuth 2.0

Implicit

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://accounts.zoho.com/oauth/v2/auth

Query Params

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/projects?filter_by=Status.All&customer_id=460000000044001&sort_column=created_time&page=1&per_page=200'

Response Example

{
    "code": 0,
    "message": "success",
    "projects": [
        {
            "project_id": "460000000044019",
            "project_name": "REAL TIME TRAFFIC FLUX",
            "customer_id": "460000000044001",
            "customer_name": "SAF Instruments Inc",
            "description": "The New York State Department of  Taxation and Finance",
            "status": "active",
            "billing_type": "fixed_cost_for_project",
            "rate": 1.23,
            "created_time": "2016-06-05T02:30:08-0700",
            "has_attachment": false,
            "total_hours": "12:26",
            "billable_hours": "12:26"
        }
    ],
    "page_context": [
        {
            "page": 1,
            "per_page": 200,
            "report_name": "Taxes",
            "has_more_page": false,
            "sort_order": "D",
            "sort_column": "created_time"
        }
    ]
}

Modified at 2025-10-12 16:28:37

Create a project

Update a project using a custom field's unique value