MARC

Get MARC Records

GET /api/.../marc/records?ids={ids}

Returns a list of MARC records based on the supplied list of bibliographic record id(s).

Request Information

Name Type Required Description
ids Array[Integer] Yes Bibliographic record id(s). Can be a comma-separated integer list. MinLength=1, MaxLength=20.

Response Information

Name Type Description
marcRecords DtoMarcRecord[] List of MARC records with associated bibliographic record id(s).
objectLocks DtoObjectLock[] List of bibliographic objects that cannot be returned with marcRecords due to being locked by other users or workstations.
DtoMarcRecord
Name Type Description
BibliographicRecordId Integer MARC record associated bibliographic record id.
BibliographicBrief DtoBibliographicBrief Brief bibliographic record data.
Record DtoMARC21Record MARC21 record information.
DtoBibliographicBrief
Name Type Description
BibliographicRecordId Integer bibliographic record id.
BrowseAuthor String bibliographic record author
BrowseTitle String bibliographic record title
ISBN String bibliographic record ISBN
ISSN String bibliographic record ISSN
UPCNumber String bibliographic record UPC number
OCLCNumber String bibliographic record OCLC number
PrimaryMARCTOMID Integer primary MARC type of material id.

See Bibliographic Record for DtoMARC21Record detail.

See Object Locks for DtoObjectLock detail.

See System Admin for DtoPermissionDescription detail.

Example Response status 200
application/json, text/json 
{
    "marcRecords": [
        {
            "BibliographicRecordId": 123,
            "BibliographicBrief": {
                "BibliographicRecordID": 123,
                "BrowseAuthor": "Galvin, Patrick J.",
                "BrowseTitle": "Finishing off",
                "ISBN": null,
                "ISSN": null,
                "UPCNumber": null,
                "OCLCNumber": null,
                "PrimaryMARCTOMID": 1
            },
            "Record": {
                "leader": "     cam  22      a 4500",
                "controlfields": [
                    {
                        "tag": "001",
                        "data": "123"
                    }
                ],
                "datafields": [
                    {
                        "tag": "010",
                        "ind1": " ",
                        "ind2": " ",
                        "subfields": [
                            {
                                "code": "a",
                                "data": "   77024521 "
                            }
                        ]
                    }
                ]
            }
        },
        {
            "BibliographicRecordId": 234,
            "BibliographicBrief": {
                "BibliographicRecordID": 234,
                "BrowseAuthor": "author",
                "BrowseTitle": "title",
                "ISBN": null,
                "ISSN": null,
                "UPCNumber": null,
                "OCLCNumber": null,
                "PrimaryMARCTOMID": 1
            },
            "Record": {
                "leader": "     cam  22      a 4500",
                "controlfields": [
                    {
                        "tag": "001",
                        "data": "234"
                    }
                ],
                "datafields": [
                    {
                        "tag": "010",
                        "ind1": " ",
                        "ind2": " ",
                        "subfields": [
                            {
                                "code": "a",
                                "data": "   77076958 /AC"
                            }
                        ]
                    }
                ]
            }
        }
    ],
    "objectLocks": [
        {
            "ObjectTypeID": 2,
            "ObjectID": 576,
            "PolarisUserID": 1,
            "WorkstationID": 11,
            "LockDate": "2024-06-06T21:33:10.26-04:00",
            "PolarisUserName": "some user",
            "WorkstationName": "some workstation",
            "ExistingLock": false,
            "StaffEmail": "email@nowhere.net"
        }
    ]
}
Example Response status 403
application/json, text/json 
{
  "ErrorCode": 10002,
  "Message": "",
  "MessageDetail": null,
  "StackTrace": null,
  "InnerException": null,
  "Data": [
    {
      "Subsystem": "Cataloging",
      "PermissionID": 141,
      "ControlRecordName": "Bibliographic records",
      "PermissionName": "Access",
      "Permitted": false,
      "AllowOverride": true,
      "Owner": 15,
      "IsOwned": true,
      "Owners": null,
      "OverrideUserID": 0
    },
    {
      "Subsystem": "Cataloging",
      "PermissionID": 143,
      "ControlRecordName": "Bibliographic records",
      "PermissionName": "Modify",
      "Permitted": false,
      "AllowOverride": true,
      "Owner": 3,
      "IsOwned": true,
      "Owners": null,
      "OverrideUserID": 0
    }
  ]
}

HTTP Response Codes

Code Description
200 OK. Success
400 Bad request
403 Forbidden. Permission(s) not granted.
404 Not Found

Required Permissions

Permission IDs found here.

    AccessCatalogingSubsystem_Allow
    BibliographicRecords_Access
    BibliographicRecords_Modify