journals

A record representing a Journal
type:object
Required:journal_title, short_title, _collections

Properties: $schema, _collections, _harvesting_info, _private_notes, book_series, control_number, date_ended, date_started, deleted, deleted_records, doi_prefixes, inspire_categories, issns, journal_title, legacy_creation_date, legacy_version, license, new_record, proceedings, public_notes, publisher, refereed, related_records, self, short_title, title_variants, urls

$schema

type:string
format:uri
minLength:1

_collections

Collections to which this record belongs
type:array
minItems:1
Every element of _collections is:
type:string
minLength:1

Allowed values:

  • Journals

_harvesting_info

MARC:583

Metadata about the harvesting process of this journal.

type:object

Properties: coverage, date_last_harvest, last_seen_item, method

coverage

MARC:583__a

Whether all articles are automatically added to Inspire (full) or a selection is made (partial).

type:string
minLength:1

Allowed values:

  • full
  • partial

date_last_harvest

MARC:583__c

Date on which the most recent harvest was performed.

Note

This date does not necessarily mean that any records were created on that day. This can happen if there was no journal update since the previous time, or that the update did not have any relevant effect for Inspire.

type:string
format:date
minLength:1

last_seen_item

MARC:583__3

Information about last processed item in the harvest. This item can be a volume, an issue or even a specific article.

type:string
minLength:1

method

MARC:583__i

How the harvesting is performed. Possible values are:

feed
Inspire receives a feed with publisher updates.
harvest
harvesting is done through webscraping.
print
articles are picked manually from the printed journal.
hepcrawl
harvesting is done through a native hepcrawl spider.
type:string
minLength:1

Allowed values:

  • feed
  • harvest
  • print
  • hepcrawl

_private_notes

List of private notes
MARC:595__a, 667__x

These notes are only visible to privileged users, not regular users.

type:array
minItems:1
Every element of _private_notes is:
Reference:sourced_value

book_series

MARC:980__a:BookSeries corresponds to true

Whether this “journal” is actually a serial whose volumes are books, i.e. a book series.

type:boolean

control_number

ID of current record
MARC:001

Read-only field.

type:integer

date_ended

MARC:Not present.

Date of last publication of the journal.

type:string
format:date
minLength:1

date_started

MARC:Not present.

Date of first publication of the journal.

type:string
format:date
minLength:1

deleted

Whether this record has been deleted
MARC:980__a/c:deleted
type:boolean

deleted_records

MARC:981__a

List of records that were deleted because they were replaced by this one. This typically happens when merging two records: one of them gets enriched with the information of the other one, which is then superfluous and gets deleted.

For the opposite concept, see new_record.

type:array
minItems:1
Every element of deleted_records is:
Reference:json_reference

doi_prefixes

List of DOI prefixes for this journal
MARC:677__d

This DOI prefix is the common start of DOIs in this journals, that all articles share.

Note

This is a list because journals can change publishers, and the new publisher will often assign new DOIs in its own prefix.

type:array
minItems:1
Every element of doi_prefixes is:
type:string
pattern:^10\.\d+(\.\d+)?/.*$
minLength:1

inspire_categories

List of Inspire categories
type:array
minItems:1
Every element of inspire_categories is:
Reference:inspire_field

issns

List of ISSNs
MARC:022
type:array
minItems:1
Every element of issns is:
type:object
Required:value

Properties: medium, value

medium

Physical medium to which this ISSN refers
MARC:022__b
type:string
minLength:1

Allowed values:

  • online
  • print

value

MARC:022__a
example:0295-5075
type:string
pattern:^\d{4}-\d{3}[\dX]$
minLength:1

journal_title

Reference:title
MARC:130

legacy_creation_date

Date of record creation on legacy
MARC:961__x

Only present if the record already existed on legacy Inspire.

type:string
format:date
minLength:1

legacy_version

Last record update
MARC:005

Used to indicate the version of the record on legacy.

type:string
minLength:1

license

MARC:540
type:object

Properties: license, url

license

License statement
MARC:540__a

Either the short name of the license or the full license statement.

example:CC-BY-4.0
type:string
minLength:1

url

URL of the license
MARC:540__u

URL where the full license statement may be found, if only a short name is provided in license.

type:string
format:uri
minLength:1

new_record

Record replacing this one
MARC:970__d

Contains a reference to the record replacing the current one, if it is marked as deleted.

Reference:json_reference

proceedings

MARC:690__a:Proceedings corresponds to true

Whether this journal publishes conference proceedings. If it publishes both conference proceedings and peer reviewed articles (depending on issue), both this field and refereed are true.

type:boolean

public_notes

List of public notes
MARC:500__a, 640__a, 680__i

Any notes about the document that do not fit into another field.

Note

These notes are publicly visible. For notes not shown to regular users, see _private_notes.

type:array
minItems:1
Every element of public_notes is:
Reference:sourced_value

publisher

List of publishers
MARC:643__b

The first element of the list is the current publisher of the journal.

Note

This is a list because journals can change publishers.

type:array
minItems:1
Every element of publisher is:
type:string
minLength:1

refereed

MARC:690__a:Peer review corresponds to true, 690__a:NON-PUBLISHED to false

Whether this journal is considered to perform peer review. This assessment might differ from the journal’s.

If the journal does not publish proceedings proceedings, all articles in it are flagged as refereed. Otherwise, it is only the case if the article is not a conference paper.

type:boolean

self

Reference:json_reference

short_title

MARC:711__a

Normalized title of the journal

example:Phys.Rev. D
type:string
minLength:1

title_variants

List of journal name variants
MARC:730__a

These name variants appear in references and are used to properly recognize citations.

example:PHYS REVIEW
type:array
minItems:1
Every element of title_variants is:
type:string
minLength:1

urls

type:array
minItems:1
Every element of urls is:
Reference:url