# Content Event

Content API v0.6.4 · 2 operations
Source: https://plasapi.com/content/v0.6.4/content-event/

No description in the specification.

## Get content events

`GET` `/content/event` · `GetContentEvents`

Retrieves a list of planned events with complete information. Returns full event representations suitable for detailed views.

Either `to_date` or `event_ids` must be included in a request.  
If `ui_language` is not set, all languages are return.


### Example request

**cURL**

```bash
curl -X GET "$PLAS_BASE_URL/content/event?version=0.6.4" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $PLAS_TOKEN"
```

**JavaScript**

```javascript
const response = await fetch(`${process.env.PLAS_BASE_URL}/content/event?version=0.6.4`, {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": `Bearer ${process.env.PLAS_TOKEN}`,
  },
});
const data = await response.json();
```

**Python**

```python
import os
import requests

response = requests.get(
    f"{os.environ['PLAS_BASE_URL']}/content/event",
    params={
        "version": "0.6.4",
    },
    headers={
        "Accept": "application/json",
        "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}",
    },
)
data = response.json()
```

The host and token are environment variables: `PLAS_BASE_URL` the provider’s base URL · `PLAS_TOKEN` an access token.

### Parameters

- `page` (In `query`, `integer`, optional) — Page number for pagination.
- `size` (In `query`, `integer`, optional) — Maximum number of events to return.
- `from_date` (In `query`, `string (date)`, optional) — Inclusive start date in YYYY-MM-DD format. If omitted, the server will use the current date in its local timezone (e.g., CET) as the default
- `to_date` (In `query`, `string (date)`, optional) — Inclusive end date.
- `event_ids` (In `query`, `array of string`, optional) — The event ids should be url encoded and separated by a comma (the comma should not be url encoded).

Shared across operations: `ui_language`, `version`. [See the shared contract on the version page.](https://plasapi.com/content/v0.6.4/)

### Responses

#### `200` Success

`GetContentEventsResponseBody`

Example (Generated from the schema):

```json
{
  "endOfResults": false,
  "events": [
    {
      "admission": {
        "type": "open"
      },
      "audiences": [
        {
          "id": "94549",
          "label": "Children"
        }
      ],
      "branch": {
        "branchId": "nordby-main",
        "branchName": "Nordby Main Library"
      },
      "categories": [
        {
          "id": "94549",
          "label": "Education"
        }
      ],
      "description": "An evening about how Norwegian crime fiction found readers all over the world.",
      "id": "94549",
      "images": [
        {
          "height": 1200,
          "mime": "png",
          "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
          "width": 800,
          "alt": {
            "text": "Your reservation is ready for pickup."
          },
          "caption": "Front cover",
          "credit": {
            "text": "Your reservation is ready for pickup."
          },
          "original": {
            "height": 1200,
            "mime": "png",
            "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
            "width": 800,
            "focalPoints": [
              {
                "type": "hotspot",
                "x": 0.5,
                "y": 0.5
              }
            ]
          },
          "type": "content"
        }
      ],
      "language": "nob",
      "location": {
        "location": "Auditorium, 2nd floor",
        "type": "at_branch"
      },
      "organizers": [
        {
          "id": "94549",
          "name": "Kari Nordmann"
        }
      ],
      "promoted": {
        "endTime": "2025-01-25T12:00:00+01:00",
        "startTime": "2025-01-25T11:00:00+01:00",
        "type": "promoted"
      },
      "relatedEvents": [
        "84411"
      ],
      "relevantWorks": {
        "type": "works",
        "workIds": [
          "882107"
        ]
      },
      "scheduling": {
        "endDate": "2025-01-25",
        "startDate": "2025-01-25",
        "type": "all_day"
      },
      "series": {
        "eventIds": [
          "84410"
        ],
        "seriesId": "3120"
      },
      "state": "scheduled",
      "teaser": "Join us for an evening about Norwegian crime fiction.",
      "title": "Author talk: Norwegian crime fiction",
      "updateTime": "2025-01-25T11:00:00+01:00",
      "url": "https://nordby.bibliotek.example/events/84410"
    }
  ],
  "total": 12
}
```

#### `400` The list of errors.

`Errors`

Shared response, defined once for the whole API. [See the shared contract on the version page.](https://plasapi.com/content/v0.6.4/)

Example (Generated from the schema):

```json
{
  "errors": [
    {
      "code": 200103,
      "info": "200103: invalid/unsupported query parameter value"
    }
  ]
}
```

#### `401` Bearer token invalid, missing, or expired.

No response body.

Shared response, defined once for the whole API. [See the shared contract on the version page.](https://plasapi.com/content/v0.6.4/)

## Get content events in series

`GET` `/content/event/series/{seriesId}` · `GetContentEventsInSeries`

Retrieves a list of planned events in a given series. Returns full event representations suitable for detailed views.

If `ui_language` is not set, all languages are return.


### Example request

**cURL**

```bash
curl -X GET "$PLAS_BASE_URL/content/event/series/3120?version=0.6.4" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $PLAS_TOKEN"
```

**JavaScript**

```javascript
const response = await fetch(`${process.env.PLAS_BASE_URL}/content/event/series/3120?version=0.6.4`, {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": `Bearer ${process.env.PLAS_TOKEN}`,
  },
});
const data = await response.json();
```

**Python**

```python
import os
import requests

response = requests.get(
    f"{os.environ['PLAS_BASE_URL']}/content/event/series/3120",
    params={
        "version": "0.6.4",
    },
    headers={
        "Accept": "application/json",
        "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}",
    },
)
data = response.json()
```

The host and token are environment variables: `PLAS_BASE_URL` the provider’s base URL · `PLAS_TOKEN` an access token.

### Parameters

- `seriesId` (In `path`, `string`, required) — Event series id.
- `page` (In `query`, `integer`, optional) — Page number for pagination.
- `size` (In `query`, `integer`, optional) — Maximum number of events to return.

Shared across operations: `ui_language`, `version`. [See the shared contract on the version page.](https://plasapi.com/content/v0.6.4/)

### Responses

#### `200` Success

`GetContentEventsInSeriesResponseBody`

Example (Generated from the schema):

```json
{
  "events": [
    {
      "admission": {
        "type": "open"
      },
      "audiences": [
        {
          "id": "94549",
          "label": "Children"
        }
      ],
      "branch": {
        "branchId": "nordby-main",
        "branchName": "Nordby Main Library"
      },
      "categories": [
        {
          "id": "94549",
          "label": "Education"
        }
      ],
      "description": "An evening about how Norwegian crime fiction found readers all over the world.",
      "id": "94549",
      "images": [
        {
          "height": 1200,
          "mime": "png",
          "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
          "width": 800,
          "alt": {
            "text": "Your reservation is ready for pickup."
          },
          "caption": "Front cover",
          "credit": {
            "text": "Your reservation is ready for pickup."
          },
          "original": {
            "height": 1200,
            "mime": "png",
            "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
            "width": 800,
            "focalPoints": [
              {
                "type": "hotspot",
                "x": 0.5,
                "y": 0.5
              }
            ]
          },
          "type": "content"
        }
      ],
      "language": "nob",
      "location": {
        "location": "Auditorium, 2nd floor",
        "type": "at_branch"
      },
      "organizers": [
        {
          "id": "94549",
          "name": "Kari Nordmann"
        }
      ],
      "promoted": {
        "endTime": "2025-01-25T12:00:00+01:00",
        "startTime": "2025-01-25T11:00:00+01:00",
        "type": "promoted"
      },
      "relatedEvents": [
        "84411"
      ],
      "relevantWorks": {
        "type": "works",
        "workIds": [
          "882107"
        ]
      },
      "scheduling": {
        "endDate": "2025-01-25",
        "startDate": "2025-01-25",
        "type": "all_day"
      },
      "series": {
        "eventIds": [
          "84410"
        ],
        "seriesId": "3120"
      },
      "state": "scheduled",
      "teaser": "Join us for an evening about Norwegian crime fiction.",
      "title": "Author talk: Norwegian crime fiction",
      "updateTime": "2025-01-25T11:00:00+01:00",
      "url": "https://nordby.bibliotek.example/events/84410"
    }
  ],
  "total": 12
}
```

#### `400` The list of errors.

`Errors`

Shared response, defined once for the whole API. [See the shared contract on the version page.](https://plasapi.com/content/v0.6.4/)

Example (Generated from the schema):

```json
{
  "errors": [
    {
      "code": 200103,
      "info": "200103: invalid/unsupported query parameter value"
    }
  ]
}
```

#### `401` Bearer token invalid, missing, or expired.

No response body.

Shared response, defined once for the whole API. [See the shared contract on the version page.](https://plasapi.com/content/v0.6.4/)

#### `404` Resource not found.

No response body.

Shared response, defined once for the whole API. [See the shared contract on the version page.](https://plasapi.com/content/v0.6.4/)