# Retrieve the Network index

> Returns the manifest of the Network index: every non-empty chunk with its path, `itemCount` and newest change.

`GET /networks` on `https://api.mediux.io`

Fetch the manifest, then fetch the chunks whose `updatedAt` moved since your last sync and re-validate the others with `If-None-Match` (an unchanged chunk answers `304 Not Modified`). `meta.scheme` is `idRange`: chunk `n` lists the Networks whose ID is at least `n * 20000` and below `(n + 1) * 20000`. Only non-empty chunks are listed. Each entry carries `hasSets` (always `false`: Talent, Brand and Category Sets are not in the API), `updatedAt` (the latest change to its public detail) and `artworkUpdatedAt` (the latest change to its `/assets`), so a library sync fetches only titles whose `artworkUpdatedAt` passed its last sync. Chunks and the manifest are refreshed hourly. The manifest is served with `Cache-Control: public, no-cache`, so send `If-None-Match` and expect `304 Not Modified` while nothing changed.

## Responses

### 200

The Network index manifest.

- `data` (array of object, required)
  - `chunk` (integer | string, required)
  - `path` (string (starts_with), required)
  - `itemCount` (integer, required)
  - `updatedAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
- `meta` (object, required)
  - `scheme` (string, required): One of "idRange", "uuidPrefix".
  - `chunkSize` (integer)
  - `chunkCount` (integer, required)
  - `totalItems` (integer, required)

### 304

Not modified. The `If-None-Match` validator still matches; no body.

### 400

The path is not a valid route, or the request carried a query string or body.

### 404

The resource does not exist or is not public.

### 405

Only `GET`, `HEAD` and `OPTIONS` are supported.

### 429

Too many cache misses from this address. Retry after the `Retry-After` delay.

### 503

Temporarily unavailable. Retry after the `Retry-After` delay.

## Example response (200)

```json
{
  "data": [],
  "meta": {
    "scheme": "idRange",
    "chunkSize": 20000,
    "chunkCount": 0,
    "totalItems": 0
  }
}
```
