API — projects/list endpoint

Required scope: projects:read (“OAuth application” flow) or project:read (partner flow).

Returns, for each project accessible to your token, its general information and the status of each step and sub-step of the project (current, completed, disabled, ...). Each step and sub-step also carries its name in French, English and Spanish (name_fr, name_en, name_es) — empty for a step outside the standard process.

The possession field gives the ownership share of the token's user in this project (useful for a property with several owners). It is null for a partner token (client_credentials, not linked to a user) or if this user is not one of the project's owners.

The country is provided in two forms: country (legacy numeric id) and country_iso / country_name_fr / country_name_en / country_name_es — empty if the id matches none of the 3 countries currently installed (Cameroon, France, Senegal).

curl https://construction.my-smartlife.fr/api/projects/list \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Example response:

{
  "projects": [
    {
      "id": "12",
      "name": "Résidence Les Palmiers",
      "city": "Abidjan",
      "country": 1,
      "country_iso": "FR",
      "country_name_fr": "France",
      "country_name_en": "France",
      "country_name_es": "Francia",
      "currency": "XOF",
      "possession": 50.0,
      "status": { "label": "en_cours", "legacy_value": 40 },
      "start_date": "2024-01-01",
      "steps": {
        "3": {
          "name_fr": "Avant construction",
          "name_en": "Pre-construction",
          "name_es": "Preconstrucción",
          "status": "current",
          "date": { "begin": "2024-01-01", "end": "" },
          "sub_steps": {
            "0": { "name_fr": "Definir le projet de construction", "name_en": "Define the construction project", "name_es": "Definir el proyecto de construcción", "status": "completed", "date": { "begin": "", "end": "" } },
            "1": { "name_fr": "Estimer le budget global prévisionnel", "name_en": "Estimate the overall provisional budget", "name_es": "Estimar el presupuesto global previsto", "status": "current", "date": { "begin": "", "end": "" } }
          }
        }
      }
    }
  ]
}