> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arquos.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Le planning des visites d’une semaine

> Le planning des visites d’une semaine

### Endpoint & Authentification

| Méthode | URL |
| :- | :- |
| `GET` | `https://api.arquos.eu/api/v2/planning` |

**En-têtes (Headers) :**

* `Authorization: Bearer [VOTRE_JETON_D_API]`
* `X-Arquos-Agency: [IDENTIFIANT_D_AGENCE]` (facultatif, voir [Agence](/v2/agence))

### Paramètres de la requête

<ParamField query="day" type="string">
  Un jour de la semaine voulue, AAAA-MM-JJ ; la semaine en cours par défaut.
</ParamField>

<ParamField header="X-Arquos-Agency" type="string">
  L’identifiant de l’agence où agir. Absent : l’agence par défaut du compte. Une agence hors de sa portée est refusée (403).
</ParamField>

### Réponse (`200`)

Les visites de la semaine du jour demandé (la semaine en cours par défaut).

<ResponseField name="id" type="string">
  L’identifiant Arquos.
</ResponseField>

<ResponseField name="technicianId" type="string">
  Le technicien de la visite. Peut valoir `null`.
</ResponseField>

<ResponseField name="day" type="string">
  Le jour de la visite (le jour où elle a été faite, pour une visite faite). Au format AAAA-MM-JJ. Peut valoir `null`.
</ResponseField>

<ResponseField name="status" type="string">
  Le statut de la visite (`planifiee`, `faite`…). Peut valoir `null`.
</ResponseField>

<ResponseField name="equipmentId" type="string">
  L’équipement visité. Peut valoir `null`.
</ResponseField>

<ResponseField name="number" type="string">
  Son numéro. Peut valoir `null`.
</ResponseField>

<ResponseField name="building" type="string">
  Le nom de l’immeuble. Peut valoir `null`.
</ResponseField>

<ResponseField name="address" type="string">
  L’adresse de l’immeuble. Peut valoir `null`.
</ResponseField>

<ResponseField name="deadline" type="string">
  La date limite de la visite d’après le plan de maintenance. Au format AAAA-MM-JJ. Peut valoir `null`.
</ResponseField>

<ResponseField name="overdue" type="boolean">
  Planifiée après sa date limite. Peut valoir `null`.
</ResponseField>

### Les erreurs

| Code | Quand |
| :- | :- |
| `400` | Requête mal formée ou champ obligatoire manquant. |
| `401` | Jeton absent, inconnu ou révoqué. |
| `403` | Agence hors de votre portée. |
| `404` | Objet introuvable dans vos agences. |
| `429` | Trop d’appels : réessayez après le délai de l’en-tête Retry-After. |

Le corps d'une erreur porte `error`, sa raison en français. Voir [Les erreurs](/v2/erreurs).

<RequestExample>
  ```bash cURL theme={"system"}
  curl --request GET \
  --url https://api.arquos.eu/api/v2/planning \
  --header 'Authorization: Bearer arq_agent_VOTRE_JETON'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"system"}
  [
  {
    "id": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "technicianId": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "day": "2026-10-10",
    "status": "texte",
    "equipmentId": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192",
    "number": "texte",
    "building": "texte",
    "address": "texte",
    "deadline": "2026-10-10",
    "overdue": true
  }
  ]
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.