Skip to main content
OCLC Support

Entity Management API

Discover the details of the Entity Management API.

Overview

Through the Entity Management API users can create and edit WorldCat Entity data.

 Note: Included with OCLC Meridian Subscription.

To learn about OCLC APIs and get started with the Entity Management API, see:

If you're ready to start using the Entity Management API, the OCLC Developer Network can help you learn more. The OCLC Developer Network allows you to learn about OCLC APIsview OCLC API documentation, and participate in the OCLC APIs community.

Authorization Scopes

  • Create Entities - entity-management:create_entities
  • Read Entities - entity-management:read_entities
  • Merge Entities - entity-management:merge_entities
  • Edit Entities including adding, updating and deleting claims - entity-management:edit_entities
  • Read brief entity data - entity-management:read_brief_entities
  • Read entity references - entity-management:read_references
  • Read entity history - entity-management:read_history

Examples

GET v1/management/entities/{id}

Scope - entity-management:read_entities

Examplehttps://entities.api.oclc.org/v1/management/entities/E39PBJjCPhTpKwkW7gjMkpjBfq

Example code
{
    "sameAs": [
        "http://www.wikidata.org/entity/Q38453",
        "http://id.worldcat.org/fast/1206785",
        "http://id.loc.gov/authorities/names/n79126460",
        "http://viaf.org/viaf/168448485",
        "http://sws.geonames.org/4575352"
    ],
    "administrativelyPartOf": [
        "https://id.oclc.org/worldcat/entity/E39QbtfRBC8KgYHtHkT8CBKfhB"
    ],
    "@context": "https://id.oclc.org/api/context.json",
    "id": "https://id.oclc.org/worldcat/entity/E39PBJjCPhTpKwkW7gjMkpjBfq",
    "prefLabel": {
        "ar": "كولومبيا",
        "be": "Горад Калумбія",
        "bg": "Колумбия",
        "bn": "কলাম্বিয়া",
        "da": "Columbia",
        "de": "Columbia",
        "el": "Κολούμπια",
        "en": "Columbia",
        "eo": "Columbia",
        "es": "Columbia",
        "fa": "کلمبیا، کارولینای جنوبی",
        "fi": "Columbia",
        "fr": "Columbia",
        "fy": "Kolumbia",
        "gu": "કોલંબિયા",
        "he": "קולומביה",
        "hi": "कोलंबिया",
        "hy": "Կոլումբիա",
        "id": "Columbia",
        "io": "Columbia",
        "it": "Columbia",
        "ja": "コロンビア",
        "ka": "კოლუმბია",
        "ko": "컬럼비아",
        "ky": "Колумбия",
        "lt": "Kolumbija",
        "lv": "Kolumbija",
        "mk": "Колумбија",
        "mr": "कोलंबिया",
        "nl": "Columbia",
        "nn": "Columbia i Sør-Carolina",
        "no": "Columbia",
        "oc": "Columbia",
        "os": "Колумби",
        "pi": "कोलम्बिया",
        "pl": "Columbia",
        "pt": "Colúmbia",
        "ru": "Колумбия",
        "sa": "कोलम्बिया",
        "sc": "Colùmbia",
        "sk": "Columbia",
        "sr": "Коламбија",
        "sv": "Columbia",
        "ta": "கொலம்பியா",
        "te": "కొలంబియా",
        "uk": "Колумбія",
        "ur": "کولمبیا، جنوبی کیرولائنا",
        "yi": "קאלאמביע",
        "zh": "哥伦比亚",
        "mrj": "Колумби",
        "sgs": "Kuolumbėjė"
    },
    "altLabel": {
        "en": [
            "South Carolina--Columbia"
        ]
    },
    "elevation": [
        {
            "type": [
                "Measurement"
            ],
            "unit": {
                "type": [
                    "Concept"
                ],
                "prefLabel": {
                    "en": "feet"
                }
            },
            "hasValue": "89"
        }
    ],
    "population": [
        {
            "type": [
                "Measurement"
            ],
            "hasValue": "133803"
        }
    ],
    "type": [
        "AdministrativeArea"
    ],
    "typeDetail": [
        "http://id.worldcat.org/fast/861748"
    ],
    "geographicCoordinates": [
        "Point(-81.03481 34.00071)"
    ],
    "description": {
        "en": "seat of a first-order administrative division in Richland County, South Carolina, United States, North America"
    }
}

GET v1/mangement/entities/{id}/references

Scope - entity-management:read_references

Examplehttps://entities.api.oclc.org/v1/management/entities/E39PBJjCPhTpKwkW7gjMkpjBfq/references

Example code

[
    {
        "digId": null,
        "version": 1,
        "agent": "127950",
        "entity_type": "AdministrativeArea",
        "change_type": "add",
        "change_date": "2024-06-03T17:39:14.2Z",
        "change_data": {
            "spatialArea": {
                "type": [
                    "Measurement"
                ],
                "unit": {
                    "type": [
                        "Concept"
                    ],
                    "prefLabel": {
                        "en": "sq mi"
                    }
                },
                "hasValue": "45.00"
            }
        },
        "count": 0
    },
    {
        "digId": null,
        "version": 2,
        "agent": "127950",
        "entity_type": "AdministrativeArea",
        "change_type": "remove",
        "change_date": "2024-06-03T17:39:20.65Z",
        "change_data": {
            "spatialArea": {
                "type": [
                    "Measurement"
                ],
                "unit": {
                    "type": [
                        "Concept"
                    ],
                    "prefLabel": {
                        "en": "sq mi"
                    }
                },
                "hasValue": "45.00"
            }
        },
        "count": 0
    }
]

GET v1/management/entities/{id}/history

Scope - entity-management:read_history

Example: https://entities.api.oclc.org/v1/management/entities/E39PBJdCvPcj33MDBF4HDyf6rq/history

Example code
[
    {
        "property": "elevation",
        "reference_id": "E39PBJjCPhTpKwkW7gjMkpjBfq$9141ec9c-1173-4846-a198-1dfbfe50fd72",
        "reference_url": "http://sws.geonames.org/4575352",
        "claim_data": {
            "elevation": {
                "type": [
                    "Measurement"
                ],
                "unit": {
                    "type": [
                        "Concept"
                    ],
                    "prefLabel": {
                        "en": "feet"
                    }
                },
                "hasValue": "89"
            }
        }
    },
    {
        "property": "administrativelyPartOf",
        "reference_id": "E39PBJjCPhTpKwkW7gjMkpjBfq$be9bd68f-8afb-4d6e-b273-e9153bfe1abe",
        "reference_url": "http://sws.geonames.org/4575352",
        "claim_data": {
            "administrativelyPartOf": "https://id.oclc.org/worldcat/entity/E39QbtfRBC8KgYHtHkT8CBKfhB"
        }
    },
    {
        "property": "geographicCoordinates",
        "reference_id": "E39PBJjCPhTpKwkW7gjMkpjBfq$975e69c2-1504-4f60-a6a3-37df452aa422",
        "reference_url": "http://sws.geonames.org/4575352",
        "claim_data": {
            "geographicCoordinates": "Point(-81.03481 34.00071)"
        }
    },
    {
        "property": "population",
        "reference_id": "E39PBJjCPhTpKwkW7gjMkpjBfq$fe6f7019-7ac5-45e9-984d-ebe0803ebd9c",
        "reference_url": "http://sws.geonames.org/4575352",
        "claim_data": {
            "population": {
                "type": [
                    "Measurement"
                ],
                "hasValue": "133803"
            }
        }
    }
]

POST /v1/management/entities

Examplehttps://entities.api.oclc.org/v1/entity-management/entity

Example code - PATCH section
[
    {
        "op": "add",
        "path": "/occupation",
        "value": {
            "label": "Astronaut
            "languageCode": "en"
        }
    }
]
Example code - Response
{
    "entityData": {
        "id": "https://id.oclc.org/worldcat/entity/E39QR8DyfTDkCPH7kfQcBtdpk3",
        "type": [
            "Person"
        ],
        "altLabel": {
            "en": [
                "alt label data"
            ]
        },
        "prefLabel": {
            "en": "John Glenn",
            "pl": "John Glenn"
        },
        "description": {
            "en": "American astronaut and politician (1921-2016)"
        },
        "occupation": [
            {
                "prefLabel": {
                    "en": "Astronaut"
                },
                "type": [
                    "Concept"
                ]
            }
        ]
    },
    "qualityScore": {
        "disambiguation": "Partially disambiguated",
        "completeness": "Minimally complete",
        "composite": "28.57",
        "advice": "Contribute to the quality score by adding one of the following properties to the entity:",
        "properties": [
            "relatedPlace",
            "honorificSuffix",
            "activeStartDate",
            "nominatedFor",
            "relatedFamily",
            "relatedPerson"
        ]
    },
    "entityMd5": "05e340eed0d9a39a3084ca1f808b00f3"
}