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

# Blob List Shares

> Listez les liens de partage actifs de votre compte avec GET /v1/shares, avec leur expiration, les téléchargements restants et la présence d'un mot de passe.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  La clé d'API de votre compte. Vous pouvez la trouver dans les [paramètres de votre compte](https://squarecloud.app/fr/account/security).
</ParamField>

List Shares renvoie tous les liens de partage du compte qui n'ont ni expiré ni été révoqués, avec le nombre de téléchargements restants pour chacun. Nécessite le scope `blob:read`. Un lien dont le fichier a été supprimé, déplacé ou a changé de visibilité quitte la liste la première fois que quelqu'un l'ouvre.

### Limites de débit

<Note>20 requêtes par minute (`RATE_LIMITED`, 429).</Note>

### Réponse

<ResponseField name="status" type="string">
  "success" en cas de succès, "error" sinon.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="Afficher l'objet">
    <ResponseField name="shares" type="array">
      <Expandable title="Afficher l'objet">
        <ResponseField name="id" type="string">
          L'id du partage.
        </ResponseField>

        <ResponseField name="url" type="string">
          Le lien.
        </ResponseField>

        <ResponseField name="object" type="string">
          L'id du fichier partagé.
        </ResponseField>

        <ResponseField name="expires_at" type="ISO 8601">
          Date d'expiration du lien.
        </ResponseField>

        <ResponseField name="remaining_downloads" type="number | null">
          Téléchargements restants, ou `null` lorsqu'il n'y a pas de limite.
        </ResponseField>

        <ResponseField name="password" type="boolean">
          Indique si le lien demande un mot de passe.
        </ResponseField>

        <ResponseField name="created_at" type="ISO 8601">
          Date de création du lien.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://blob.squarecloud.app/v1/shares' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "shares": [
        {
          "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
          "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
          "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
          "expires_at": "2026-10-02T12:00:00.000Z",
          "remaining_downloads": 3,
          "password": false,
          "created_at": "2026-09-25T12:00:00.000Z"
        }
      ]
    }
  }
  ```
</ResponseExample>

### Erreurs

| Code           | HTTP | Quand                              |
| -------------- | ---- | ---------------------------------- |
| `RATE_LIMITED` | 429  | Plus de 20 requêtes en une minute. |