# Content Event

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

Library events and series of events, such as author talks, reading clubs and activities for children. The vendor can fetch events with their time, place, pricing, admission and the works they relate to, and fetch the series an event belongs to.

## 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.7" \
  -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.7`, {
  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.7",
    },
    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.7/)

### 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.7/)

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.7/)

## 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.7" \
  -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.7`, {
  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.7",
    },
    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.7/)

### 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.7/)

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.7/)

#### `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.7/)