Recall API

This API is subject to change without notice / Use at own risk

Get all active recalls (tilbakekallelser) that are registered (by publishers) in Bokbasen's platform.

URL	`https://api.bokbasen.io/metaq/recalls`
Method	`GET`
Request headers	Authorization	Required	Access-token from Authentication Service Audience: `https://api.bokbasen.io/metaq/` You need scope `view:recalls` for this service.
Response body	`application/json`
Returns	200	OK

Example usage

curl \
  -H "Authorization: Bearer YOUR-TOKEN-HERE" \
  https://api.bokbasen.io/metaq/recalls

Response

ean	EAN
workId	Internal ID to the work EAN is part of
title	Title
author	Author
publishedYear	Year
productOwner	Object describing the product-owner (name & contact)
distributor	SD, FS, FBF, EGEN etc
reasonCode	`NEW` (Replaced by new edition), `OTHER` (Other reason) or `UNKNOWN`
returnCode	`RETURN_COLOPHON` (Only return the colophon-page) `RETURN_BOOK` (Return the book) `IMAGE_COLOPHON` (Send an image of the colophon-page) `UNKNOWN`
returnMethod	`RETURN_COLOPHON` (Only return the colophon-page) `RETURN_BOOK` (Return the book) `IMAGE_COLOPHON` (Send an image of the colophon-page) `UNKNOWN`
returnDeadline	Last day the book can be retuned (Date)

Example

{
    "recalls": [
        {
            "ean": "9788202702519",
            "workId": "823c20e2-7d1e-4aae-b3b8-01d242db330b",
            "title": "Brukerperspektiver i sosialt arbeid",
            "author": "Chudasama, Krishna",
            "publishedYear": 2022,
            "productOwner": {
                "id": "12b24a5f-b39f-417c-b278-e572959f6bae",
                "code": "900008",
                "name": "Cappelen Damm AS",
                "contactInfo": {
                    "email": "firmapost.forlag.sugarstage@bokbasen.no",
                    "phone": "21 61 65 00",
                    "address1": "Post adresse 1",
                    "address2": null,
                    "postalCode": "0055",
                    "city": "OSLO",
                    "country": "Norge"
                }
            },
            "distributor": "SD",
            "reasonCode": "OTHER",
            "returnCode": null,
            "returnMethod": "IMAGE_COLOPHON",
            "returnDeadline": "2024-06-01"
        },
        ...
    ]
}