Saltar al contingut principal
GET

Llistat de projectes

Scope:projects:projects.read
https://api.holded.com/api/v2/projects

Retorna una llista paginada de projectes del teu compte.

Paràmetres

Paràmetres de consulta

cursorstringopcional

Cursor opac per a la paginació. Utilitza el valor retornat a la resposta anterior

limitintegeropcional= 50

Nombre màxim de projectes a retornar per pàgina

statusstringopcional

Filtra projectes per estat. Utilitza «active» o «in_progress» per obtenir només els projectes actius

"active""in_progress""completed""cancelled""waiting""budgeted"

Petició

python
import requests

url = "https://api.holded.com/api/v2/projects?cursor=value&limit=50&status=value"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respostes

Resposta

json
{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "string",
      "description": "string",
      "type": "string",
      "icon": "string",
      "color": "string",
      "key": "string",
      "scope": "string",
      "users": {},
      "contact_id": "string",
      "contact_name": "string",
      "start_date": "string",
      "due_date": "string",
      "tags": [
        "string"
      ],
      "archived": false,
      "status": 0,
      "number_of_tasks": 0,
      "completed_tasks": 0,
      "billable": false
    }
  ],
  "has_more": false,
  "cursor": "string"
}

Respostes exitoses

200Llistat de projectesapplication/json
object
items[]object[]required
idstringrequired

Unique identifier

namestringrequired

Project name

descriptionstringrequired

Project description

typestringrequired

Project type

iconstringrequired

Project icon

colorstringrequired

Project color

keystringrequired

Project key

scopestringrequired

Project scope

usersobjectrequired

Project members keyed by user ID

contact_idstring | nullrequired

Contact ID

contact_namestringrequired

Contact name

start_datestring | nullrequired

Start date, formatted according to the account's date settings

due_datestring | nullrequired

Due date, formatted according to the account's date settings

tags[]string[]required

Tags

archivedbooleanrequired

Whether the project is archived

statusintegerrequired

Project status

number_of_tasksintegerrequired

Total number of tasks

completed_tasksintegerrequired

Number of completed tasks

billablebooleanrequired

Whether the project is billable

has_morebooleanrequired

Whether there are more items on the next page

cursorstring | nulloptional

Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.

Respostes d'error

401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
429Límit de sol·licituds exceditapplication/json