Skemaer

AdditionalIdentifier

AdditionalIdentifierTypeBibsentBibbi

typepåkrævet

string enumbibsentBibbi

valuepåkrævet

string

AdditionalIdentifierTypeEAN

digitspåkrævet

string enum13

typepåkrævet

string enumean

valuepåkrævet

string

AdditionalIdentifierTypeISBN

digitspåkrævet

string enum10 · 13

typepåkrævet

string enumisbn

valuepåkrævet

string

AdditionalIdentifierTypeISSN

typepåkrævet

string enumissn

valuepåkrævet

string

Agent

AgentPersonActiveLiteral

Date or date range the person was active. This is usually only recorded for historical persons where the birth and death dates are uncertain or unknown. A literal value, meaning there are no expected structure or format.

typepåkrævet

string enumliteral

valuepåkrævet

string

AgentRole

Telling the role of an agent, e.g. author, illustrator, editor.

AgentRoleMarcRelator

roleCodepåkrævet

stringA contribution role code from the MARC Code List for Relators.

typepåkrævet

string enummarcRelatorIdentifies the role code as being part of [MARC Code List for Relators](https://www.loc.gov/marc/relators/relaterm.html).

AgentTypeCollective

AgentTypePerson

Amount

The amount is in minor unit (see ISO 4217).

BaseAgent

description

stringThis is a description of the agent.

fullNamepåkrævet

stringThis is the full name of the agent.

id

stringThis isn't required, but if it's set: - The agent is searchable through the GET /agent endpoint. - Or you can search using the filter `plas.agent` to search on this agent.

images

array of ImageAgentImages of the agent.

BaseEventItem

eventIdpåkrævet

stringA unique identifier for the event.

typepåkrævet

stringThe type of event.

BasicTitle

language

LanguageThe language of the titles in the object.

mainpåkrævet

stringThis is the main title.

part

objectThis contains the information to distinguish the work.

remainder

stringThis is the remainder of the title.

Binding

BindingTypeLiteral

A literal binding, meaning there are no expected structure or format.

typepåkrævet

string enumliteral

valuepåkrævet

stringA displayable (human readable) representation of the binding.

CheckinField

acquiredFrom

PatronLoanAcquiredFrom

dueDate

string (date)This is the due date of the checkin item, meaning the date where item should (at the latest) be returned.

itemIdpåkrævet

stringThis is the item ID of the checked in item.

loanIdpåkrævet

LoanId

patronId

stringThis is the patron ID of the patron that made the checkin.

publicationId

stringThis is the publication ID of the checkin item.

publicationMetadata

PublicationFallback

sortingCode

stringThis is the sorting code, and can be used to sort checked in items, on e.g. a self service machine by reserved and not-reserved items.

transactionDateTimepåkrævet

string (date-time)This is the registered time and date of the checkin.

CheckinFieldWithRequiredPatronId

CheckinResponseBody

checkinpåkrævet

CheckinField

completed

booleanThis tells if the checkin was completed or not. It is only true if the checkin was completed, else it is false.

message

CheckOutOrInMessage

requestIdpåkrævet

stringThis is a unique identifier for the checkout request. This will change for each request.

statuspåkrævet

string enumcompleted · failedThis tells the status of the checkin. The status are: - `completed` means that the checkin went well and was completed. - `failed` means that the checkin failed, and the item was not checked in.

CheckinWithRequiredPatronIdResponseBody

CheckoutAcknowledgementType

typepåkrævet

stringThis is the type of what is to be acknowledged.

CheckoutAcknowledgementTypeFee

CheckoutAcknowledgementTypePreviouslyCheckedOut

CheckoutField

acquiredFrom

PatronLoanAcquiredFrom

dueDatepåkrævet

string (date)This is the due date of the checked out item.

itemIdpåkrævet

stringThis is the item ID of the checkout item.

loanIdpåkrævet

LoanId

patronIdpåkrævet

stringThis is the patron ID of the patron that made the checkout.

publicationId

stringThis is the publication ID of the checkout item.

publicationMetadata

PublicationFallback

renew

LoanRenewInfo

transactionDateTimepåkrævet

string (date-time)This is the registered time and date of the checkout.

CheckOutOrInLocationWithoutNames

The object tells the location where a checkout or checkin was made. The `sections` is for specifying the location more precisely.

branchIdpåkrævet

stringThe branch ID where the checkout or checkin was made.

sections

array of LocationSectionElementWithIdNameAndTypeThis is specifying the location more precisely.

CheckOutOrInMessage

Both type and text are optional, but at least one of them must be set.

text

stringMessage to the patron.

type

stringThis can be used instead of the text field to identify the message type. This can be used by a vendor to handle the message or control the content of the message.

CheckoutResponseBody

acknowledgement

objectIf this is set, the checkout needs to be acknowledged to be completed.

checkoutpåkrævet

CheckoutField

message

CheckOutOrInMessage

requestIdpåkrævet

stringThis is an unique identifier for the checkout request. This will change for each request.

statuspåkrævet

string enumcompleted · failedThis tells the status of the checkout. The status are: - `completed` means that the checkout went well and was completed. - `failed` means that the checkout failed, and the item was not checked out.

Contributor

agentpåkrævet

Agent

roles

array of AgentRoleList of roles (e.g. author, illustrator, editor) that the agent played in the creation of this entity.

Date

DateTypeCentury

The *century* date can be used if we only know which century an event happened.

beforeTheCommonEra

booleanThe default value is *false*, meaning common era, otherwise before the common era.

centurypåkrævet

integerThe century e.g. 19 century CE (meaning 1801 CE to 1900 CE), 3 century BCE (meaning 300 BCE to 201 BCE)

typepåkrævet

string enumcentury

DateTypeLiteral

A literal date, meaning there are no expected structure or format.

typepåkrævet

string enumliteral

valuepåkrævet

string

DateTypeRFC3339

The *rfc3339* date can be used if we now the date.

datepåkrævet

string (date)RFC3339 _full-date_ format (YYYY-MM-DD).

typepåkrævet

string enumrfc3339

DateTypeYear

The *year* date can be used if we only know which year an event happened.

typepåkrævet

string enumyear

yearpåkrævet

integerEg. 1924

DateTypeYearRange

The *yearRange* date can be used if we only know approx when an event happened. This can also be used give an open ended year range. *from* and *to* isn't required, but a least one of them should be set.

from

integerEg. 1924

to

integerEg. 1979

typepåkrævet

string enumyearRange

Edition

EditionTypeLiteral

A literal edition, meaning there are no expected structure or format.

typepåkrævet

string enumliteral

valuepåkrævet

stringA displayable (human readable) representation of the edition.

EditionTypeNumbering

display

stringA displayable (human readable) representation of the edition.

numberpåkrævet

integerThe edition number.

printing

integerThe printing number of the edition.

typepåkrævet

string enumnumbering

Error

codepåkrævet

ErrorCode

infopåkrævet

ErrorInfo

ErrorCode

A number representing the type of error. List of error codes: - \<error code\>: \<error description\> - 500: System error - 600: Unsupported Open Library API version</br>

ErrorInfo

Starts with the text matching the error code field (defined above), and a describing text could be added.

Errors

errorspåkrævet

array of ErrorThe first error should always be the most relevant.

EventConsentChanged

EventFeeDueDateIsApproaching

EventItemAddedToLoanHistory

EventItemCheckin

EventItemCheckout

EventItemPatronListCreated

EventItemPatronListDeleted

EventItemPatronListItemAddedToList

EventItemPatronListItemMovedOnList

EventItemPatronListItemRemovedFromList

EventItemPatronListUpdated

EventItemRemovedFromLoanHistory

EventLoanDueDateIsApproaching

EventPatronDeleted

EventReadyReservationExpiresSoon

EventReceiverRequest

EventReservationExpiresSoon

EventReservationReadyForPickup

EventReservationReminder

Extent

ExtentTypeLiteral

A literal extent, meaning there are no expected structure or format.

typepåkrævet

string enumliteral

valuepåkrævet

stringA displayable (human readable) representation of the extent.

ExtentTypePages

pagespåkrævet

integerNumber of physical pages.

typepåkrævet

string enumpages

ExtentTypePlaytime

playtimepåkrævet

integerThe total playtime in seconds.

typepåkrævet

string enumplaytime

ExtentTypeUnits

typepåkrævet

string enumunits

unitTypepåkrævet

string enumvolume · dvd · cd · bluRay · cassette · lp

unitspåkrævet

integerNumber of physical units (volumes, dvd, cd, ...)

FeeAmount

The amount is in minor unit (see ISO 4217).

FeeCreatedTime

The date and time the fee was created.

FeeCurrency

ISO 4217

FeeDueDate

The due date of the fee.

FeeId

This is the fee ID.

FeeItem

Item information related to a fee.

acquiredFrom

PatronLoanAcquiredFrom

itemIdpåkrævet

stringThe item identifier of the item that the fee is about.

publicationMetadatapåkrævet

PublicationFallback

FeePayableState

This state tells if the fee can be paid and finalized through this API. - *payable*: The fee is payable, and can be finalized through this API. - *not_payable*: The fee cannot be finalized through this API.

FeeRemainingAmount

The remaining amount is the amount that is still payable. If this is not equal to amount, part of the fee has been paid. The amount is in minor unit (see ISO 4217).

FeeType

Defines the type of fee being applied. All fees indicate that the patron should pay, never the other way around. The possible values are: - *fee*: Indicates a regular fee, typically for a late checked-in loan. - *compensation*: Indicates a compensation fee, typically applied due to a damaged or lost item. - *send_to_debt_collector*: Indicates that the fee has been sent to a debt collector because it was not paid in time.

GetVersionResponseBody

versionpåkrævet

VersionThis is recommended (by the vendor) version of the Open Library API, that is supported by the vendor.

ImageAgent

ImagePublication

ImageTypeAgent

ImageTypeBackCover

ImageTypeFrontCover

ImageUrl

height

integerThe image height in px.

mime

string enumpng · jpeg

urlpåkrævet

string

width

integerThe image width in px.

Language

codepåkrævet

stringA id that (if set) can be used with the filter `plas.language` to search on this genre. Codes can be found at <https://www.loc.gov/marc/languages/>

name

stringA displayable (human readable) value of the language.

LoanCreatedTime

The date and time the loan was made.

LoanDueDate

The latest date on which the loan must be returned.

LoanId

This is the loan ID.

LoanItemId

This is the item identifier of the checkout item.

LoanPublicationId

This is the publication ID of the loan. If this is empty, the publication is unknown.

LoanRenewableState

This tells the renewable state of the loan.

LoanRenewInfo

This contain information about renewal of the loan.

count

integerThe number of times this loan can still be renewed. If the field is missing, this information is unknown.

lastDate

string (date)The date when the loan was last renewed. If the field is missing, this information is unknown.

statepåkrævet

LoanRenewableState

LocationSectionElementType

This should be the section type of the section (element) ID.

LocationSectionElementWithId

idpåkrævet

stringThis is the section (element) ID

LocationSectionElementWithIdAndName

LocationSectionElementWithIdNameAndType

MediaType

code

MediaTypeType

namepåkrævet

stringA displayable (human readable) representation of the media type.

MediaTypeEnum

MediaTypeLiteral

MediaTypeType

A code that (if set) can be used with the filter `plas.mediaTypes` to search on this media type.

PatronConsent

availablepåkrævet

array of objectThe array must only contain one consent of each type.

evaluatedpåkrævet

PatronEvaluatedConsents

PatronConsentType

PatronEvaluatedConsent

givenpåkrævet

boolean

typepåkrævet

PatronConsentType

versionpåkrævet

stringThe version of the consent that the patron has made a choice for or against.

PatronEvaluatedConsents

The array must only contain one consent of each type.

PatronFee

amountpåkrævet

FeeAmount

createdTimepåkrævet

FeeCreatedTime

currencypåkrævet

FeeCurrency

dueDate

FeeDueDate

idpåkrævet

FeeId

items

array of FeeItemThe items this fee covers, if they are known.

payableStatepåkrævet

FeePayableState

remainingAmount

FeeRemainingAmount

typepåkrævet

FeeType

PatronList

idpåkrævet

stringThe ID of the list.

namepåkrævet

stringThe name of the list.

PatronListBaseItem

idpåkrævet

stringThe unique ID of the item in the list.

PatronListItem

PatronListItemWorkAndPublication

PatronLoan

acquiredFrom

PatronLoanAcquiredFrom

createdTimepåkrævet

LoanCreatedTime

dueDatepåkrævet

LoanDueDate

idpåkrævet

LoanId

itemIdpåkrævet

LoanItemId

location

CheckOutOrInLocationWithoutNames

publicationIdpåkrævet

LoanPublicationId

publicationMetadata

PublicationFallback

renewpåkrævet

LoanRenewInfo

PatronLoanAcquiredFrom

This tells from where (the material for) this loan was acquired. If this field are missing, the default value **local_circulation** should be assumed. * **local_circulation**: Meaning that this loan was acquired from the customers own inventory. * **interlibrary_loan**: Meaning that this loan was acquired as a interlibrary loan. * **unknown**: Meaning that this information is unknown.

PatronLoanAcquiredFromTypeInterlibraryLoan

typepåkrævet

string enuminterlibrary_loan

PatronLoanAcquiredFromTypeLocalCirculation

typepåkrævet

string enumlocal_circulation

PatronLoanAcquiredFromTypeUnknown

typepåkrævet

string enumunknown

PatronLoanHistory

acquiredFrom

PatronLoanAcquiredFrom

addedToHistoryTimepåkrævet

string (date-time)The date and time when the loan was added to the patron loan history.

checkinTime

string (date-time)The date and time the loan was checkin.

checkoutTime

LoanCreatedTime

dueDate

string (date)The due date of the loan at the time of checkin.

idpåkrævet

stringThis is the loan history ID (not the loan ID).

itemId

LoanItemId

loanId

LoanId

manuallyAddedpåkrævet

booleanWas the loan added manually by the patron.

publicationIdpåkrævet

LoanPublicationId

publicationMetadata

PublicationFallback

PatronReservation

createdTimepåkrævet

ReservationCreatedTime

expirationDate

ReservationExpirationDate

fulfillmentBy

PatronReservationFulfillmentBy

idpåkrævet

ReservationId

itemId

ReservationItemId

pickuppåkrævet

object

publicationIdpåkrævet

ReservationPublicationId

publicationMetadata

PublicationFallback

queueNumber

ReservationQueueNumber

statepåkrævet

ReservationState

PatronReservationFulfillmentBy

This tells from where the material that are expected to fulfill this reservation will be acquired from. If this field are missing, the default value **local_circulation** should be assumed. * **local_circulation**: (default) Meaning that this reservation will be fulfilling from the customers own inventory. * **interlibrary_loan**: Meaning that this reservation will be fulfilled as a interlibrary loan. * **purchase**: Meaning that reservation can not be fulfilled right away, but a request to purchase the material has been submitted. * **unknown**: Meaning that this information is unknown.

PatronReservationFulfillmentByTypeInterlibraryLoan

typepåkrævet

string enuminterlibrary_loan

PatronReservationFulfillmentByTypeLocalCirculation

typepåkrævet

string enumlocal_circulation

PatronReservationFulfillmentByTypePurchase

typepåkrævet

string enumpurchase

PatronReservationFulfillmentByTypeUnknown

typepåkrævet

string enumunknown

PickupLocation

The object tells a location where a reservation item can be picked up. The `sections` is for specifying the location more precisely. The branch name and section names are included in the response to make it easier to display the location. They are the same values as from the /locations endpoint.

branchIdpåkrævet

stringThe branch ID where a reservation should be picked up.

branchNamepåkrævet

stringThis is the name of the branch.

sections

array of LocationSectionElementWithIdNameAndTypeThis are specifying the location more precisely.

Publication

additionalIdentifiers

PublicationAdditionalIdentifiers

binding

Binding

contributors

PublicationContributors

creators

PublicationCreators

edition

Edition

extent

PublicationExtent

identifierpåkrævet

PublicationIdentifier

images

PublicationImages

language

PublicationLanguage

mediaTypes

PublicationMediaTypes

publicationDate

DateDate of publication.

publishers

array of PublisherAndPlacesList of publishers and associated place(s) of publication.

titlespåkrævet

PublicationTitles

workspåkrævet

array of PublicationWork

PublicationAdditionalIdentifiers

Other identifiers, like: ISBN, ISSN, ...

PublicationContributors

The contributor(s) to the publication.

PublicationCreators

The creator(s) of the publication.

PublicationExtent

Together all the Extents in the array describes the total extent of the publication.

PublicationFallback

This metadata is only intended as fallback data, for when the provider is not able to serve the metadata through the GET /publication endpoint. This can for some provider be the case when working with e.g. interlibrary loans.

PublicationIdentifier

Publication identifier. This is searchable through the GET /publication endpoint.

PublicationImages

Images to use with the publication.

PublicationLanguage

This is the language(s) of the this publication. If the publication uses multi languages this will also contain them.

PublicationMediaTypes

PublicationTitles

Title of the publication.

PublicationWork

identifierpåkrævet

PublicationWorkIdentifier

relation

PublicationWorkRelation

PublicationWorkIdentifier

Work identifier of this publication. This is searchable through the GET /work endpoint.

PublicationWorkRelation

Describes the publications relation to a work. - contains: The publication contains this work, meaning the work is part of the publication. - embodies: The publication embodies this work, meaning the publication is the entire work.

Publisher

id

stringThe unique identifier of the publisher. It can be used to search for the other entries by the publisher

namepåkrævet

stringThe publisher's name.

PublisherAndPlaces

places

array of PublisherPlacePlace of publication. Usually one place, but can be multiple.

publisherpåkrævet

Publisher

PublisherPlace

placepåkrævet

string

ReservationCreatedTime

The date and time the reservation was created.

ReservationExpirationDate

The date when the reservation expires. If this is missing, the value is unknown.

ReservationId

This is the reservation ID.

ReservationItemId

This is the item identifier that actually fulfills the reservation. This can often only be set when the reservation is ready for pickup. If the reservation is on item level, it can be set earlier.

ReservationPickupExpirationDate

The date for the last chance to pick up the reservation. If this is missing, the value is unknown.

ReservationPickupNote

This is the note that is used to tell the patron where to get the reservation. E.g. - a shelf number, e.g. "Shelf 9". - an instruction, e.g. "Front desk" - an identifier, e.g. "10/114"

ReservationPublicationId

This is the publication ID of the reservation. If this is empty, the publication is unknown.

ReservationQueueNumber

The queue number tells what number in the queue the patron is. If this is missing, it represents that the queue number is unknown.

ReservationState

This represents where in the acquiring process this reservation is.

Title

TitleTypeOriginal

TitleTypeParallel

TitleTypePreferred

TitleTypeVariant

Version

Open Library API version.