# List updates

URL: /en/docs/api/v1/updates/get
Last Updated: 2026-07-30T21:15:44.973Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/updates

**List updates**

Retrieve all updates for the current tenant, sorted by published time, scheduled time, and creation time.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Responses:**

- `200` - Updates for the current tenant
  - `updates` (array of Update (object))
    - `id` (string)
    - `title` (string)
    - `slug` (any): URL-safe identifier used by Trust Center update modal links.
    - `summary` (any)
    - `description_md` (any): Markdown body shown in the Trust Center update modal or timeline.
    - `status` (enum: draft | scheduled | published | archived)
    - `classification` (object)
      - `id` (string)
      - `title` (string)
      - `color` (any)
      - `translations` (array of ClassificationTranslation (object))
        - `languages_code` (string)
        - `title` (string)
      - `custom_fields` (array of ClassificationCustomField (object))
        - `title` (string)
        - `translations` (array of ClassificationTranslation (object))
          - `languages_code` (string)
          - `title` (string)
        - `options` (array of object)
          - `value` (string)
          - `label` (array of object)
            - `languages_code` (string)
            - `translation` (string)
    - `access_level` (AccessLevel (enum: public | restricted | requires_nda | internal))
    - `send_mode` (enum: none | immediate | scheduled)
    - `channels` (array of UpdateChannel (enum: trust_center | email.subscribers | email.custom))
    - `scheduled_at` (any)
    - `scheduled_timezone` (any)
    - `published_at` (any)
    - `effective_at` (any)
    - `effective_timezone` (any)
    - `order` (enum: asc | desc)
    - `parent` (object)
      - `id` (string)
      - `title` (string)
    - `template` (object)
      - `id` (string)
      - `title` (string)
      - `summary` (any)
      - `description_md` (any)
      - `badge` (any)
      - `tenant` (any)
      - `category` (object)
        - `id` (string)
        - `title` (string)
    - `documents` (array of UpdateDocumentRelation (object))
      - `id` (string)
      - `documents_id` (object)
        - `id` (string)
        - `title` (string)
    - `subprocessors` (array of UpdateSubprocessorRelation (object))
      - `id` (string)
      - `subprocessors_id` (object)
        - `id` (string)
        - `title` (string)

  Example (success):
  
  ```json
  {
  "updates": [
    {
      "id": "upd_01JZ9VYQ8B3V1VFA4NV3D6A7P9",
      "title": "SOC 2 Type II report published",
      "slug": "soc-2-type-ii-report-published",
      "status": "published",
      "access_level": "restricted",
      "send_mode": "immediate",
      "channels": [
        "trust_center",
        "email.subscribers"
      ],
      "order": "desc"
    }
  ]
}
  ```
- `401` - Unauthorized
- `500` - Failed to load updates

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/updates" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```