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
created	Timestamp for when the recall was created
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",
            "created": "2025-10-11T11:43:28.233+00:00",
            "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"
        },
        ...
    ]
}