# Holding

Provider API v0.6.7 · 1 operasjon
Kilde: https://plasapi.com/no/provider/v0.6.7/holding/

Which physical items the library has for a set of publications, and where each item is: its branch and section, its current state such as available or on loan, and for periodicals which issue it is. Vendors use it to show availability before a patron reserves.

## Get holdings

`GET` `/holdings` · `GetHoldings`

### Eksempel på kall

**cURL**

```bash
curl -X GET "$PLAS_BASE_URL/holdings?publication_ids=310552&version=0.6.7" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $PLAS_TOKEN"
```

**JavaScript**

```javascript
const response = await fetch(`${process.env.PLAS_BASE_URL}/holdings?publication_ids=310552&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']}/holdings",
    params={
        "publication_ids": "310552",
        "version": "0.6.7",
    },
    headers={
        "Accept": "application/json",
        "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}",
    },
)
data = response.json()
```

Verten og tokenet er miljøvariabler: `PLAS_BASE_URL` providerens adresse · `PLAS_TOKEN` et access token.

### Parametere

- `publication_ids` (i `query`, `array of string`, påkrevd) — A list of publication IDs, each publication ID should be url encoded and separated by a comma.
- `show_to` (i `query`, `array of string enum`, valgfri) — A list of show_to values, where each value is url encoded and separated by a comma.

This tells the provider that the returned data is intended to be shown to a specific group of users, and
all returned data must be filtered appropriately.

If no groups are given, all data should be returned.

- `patron_id` (i `query`, `string`, valgfri) — The patron ID of the active patron.

Felles for operasjonene: `version`. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)

### Svar

#### `200` The response will contain a mapping from each publication ID to an array of holdings.

`GetHoldingResponseBody`

Eksempel (Generert fra skjemaet):

```json
{
  "holdings": {
    "holding-310552": [
      {
        "locations": [
          {
            "items": [
              {
                "availableState": "available",
                "itemId": "03011042557129",
                "lendingDays": 28,
                "loanableState": "loanable",
                "pickupLocations": [
                  {
                    "branchId": "nordby-main",
                    "branchName": "Nordby Main Library",
                    "sections": [
                      {
                        "id": "nordby-main-children",
                        "name": "Children’s department",
                        "type": "department"
                      }
                    ]
                  }
                ],
                "reserveId": "7730015"
              }
            ],
            "location": {
              "branchId": "nordby-main",
              "branchName": "Nordby Main Library",
              "path": [
                {
                  "id": "nordby-main-children",
                  "name": "Children’s department",
                  "type": "department"
                }
              ]
            },
            "pickupLocations": [
              {
                "branchId": "nordby-main",
                "branchName": "Nordby Main Library",
                "sections": [
                  {
                    "id": "nordby-main-children",
                    "name": "Children’s department",
                    "type": "department"
                  }
                ]
              }
            ],
            "shelfmark": "839.82 Und"
          }
        ],
        "numberOfReservations": 5,
        "periodical": {
          "grouping": [
            {
              "type": "year",
              "value": "2025"
            }
          ],
          "name": "Kari Nordmann"
        },
        "publicationId": "310552",
        "reserveId": "7730015"
      }
    ]
  }
}
```

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

`Errors`

Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)

Eksempel (Generert fra skjemaet):

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

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

Ikke noe innhold i svaret.

Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)