orcid_client 0.6.0 → 0.9.3

data/resources/common_3.0/samples/common-3.0.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<common:application-group-orcid
+    xmlns:common="http://www.orcid.org/ns/common" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.orcid.org/ns/common ../common-3.0.xsd ">
+    <common:uri>https://orcid.org/8888-8888-8888-8880</common:uri>
+    <common:path>8888-8888-8888-8880</common:path>
+    <common:host>orcid.org</common:host> 
+</common:application-group-orcid>

data/resources/common_3.0/samples/common-3.0_external-identifier.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<common:external-ids xmlns:common="http://www.orcid.org/ns/common">
+	<common:external-id>
+	        <common:external-id-type>doi</common:external-id-type>
+	        <common:external-id-value>value</common:external-id-value>   
+	        <common:external-id-normalized transient="true">normalized-value</common:external-id-normalized>                        
+	        <common:external-id-url>http://orcid.org</common:external-id-url>
+	        <common:external-id-relationship>self</common:external-id-relationship>
+	</common:external-id>
+</common:external-ids>
+

data/resources/notification_3.0/README.md

@@ -0,0 +1,130 @@
+
+# ORCID API v3.0 Notifications Permission Guide
+The ORCID API supports functionality to enable member organizations to add permission requests to a user's ORCID Inbox. These requests provide a "snapshot" example of the type of activities that will be added to the user's ORCID record as a result of granting the permission.
+
+_**User-friendly implementation detail**: Several fields described below are displayed directly to the end user. The ORCID user interface is currently available in 10+ languages, and emails sent to the user are also presented in the user's language of choice. The language preference of the user is available via the ORCID API, and is always public. We strongly recommend that you read and consider the user's language when providing messages to them, providing user-displayed fields in their preferred language when feasible._
+
+## Notifications Permission XML
+XML for the ```permission``` notifications follows the [notification-permission-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/notification_3.0/notification-permission-3.0.xsd) and consists of the following sections:
+
+- **notification:notification-type**: The type of notification - for this type of notification, the value is always ```permission```. 
+
+- **notification:authorization-url**: This field is the URL string that you would call if you were asking for the permission from the user from your own application. It is formatted as a URL string, using the format found for the call [GET OAUTH/AUTHORIZE](http://members.orcid.org/api/get-oauthauthorize). _Note: one may specify only the URL path if desired. This approach is useful if you want to use identical code in multiple environments, for example on the ORCID Sandbox and Production environments._
+
+- **notification:notification-subject**: DISPLAYED TO END USER. A plain text value for describing to the user the type of items that you'll plan to add to his/her record once permission is granted. This value should be short (fewer than 25 characters), and can be a bit more descriptive, for example, "your recent publications", or "validated affiliations", or it can simply mirror the value used for ```notification:item-type``` below (education, employment, etc. You should assume that this text will be used in the middle of a sentence _(for example, the message subject line of "Add <notification:item-type> to your ORCID record")_, so you should use discretion on capitalization and length.
+
+<p align="center">
+  <img src='https://raw.githubusercontent.com/ORCID/orcid-model/master/src/main/resources/notification_3.0/images/notification-subject.jpg' alt='notification-subject' width='600'>
+</p>
+
+- **notification:notification-intro**: DISPLAYED TO END USER. A short message that will be included in the inbox message to the end-user. This message will be presented before the list of activities that you have included in the message. Your intro message should not exceed 1000 characters.
+
+<p align="center">
+  <img src='https://raw.githubusercontent.com/ORCID/orcid-model/master/src/main/resources/notification_3.0/images/notification-intro.jpg' alt='notification-intro' width='600'>
+</p>
+
+**notification:items block**
+
+Consists of one or more ```notification:item``` elements, which contain the following sub-elements:
+
+- **notification:item-type**: The type of ORCID item represented by this ```item``` element. Chosen from the following: ```education```, ```employment```, ```funding```, ```work```, or ```peer-review```.
+
+- **notification:item-name**: DISPLAYED TO END USER. The name that should be shown to the end user to describe the item. This field is usually the name of the item that might be added once permission is granted (for example, the title of an article), but it also could include other identifying information, for example, _"Article Title (as published in journal ABC)"_, where "(as published in journal ABC)" is additional infomration that the client application would like to present to the user.
+
+- **notification:external-identifier**: DISPLAYED TO END USER. An external identifier for the item. While this field is not required, it is very helpful information to provide to the end user, as it distinguishes the item from others that may be similar. Note that, when adding the item to the ORCID record, at least one external identifier is required, even if an internal reference identifier is used for this purpose. 
+
+For an example XML file, see [notification-permission-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/notification_3.0/samples/notification-permission-3.0.xml)
+
+***Note:*** *Sample files contain system-generated elements/attributes that are returned when reading items from ORCID. The following items should not be included when posting items to ORCID. These fields will be present when reading notifications using this API:*
+
+- **put-code** - ORCID_internal identifier for this notification. _(exception: you must include the put-code when updating items using the PUT method to update an item previously added)_
+- **source** - the system will include your client application as the source
+- **created-date** - date that you created this notification; automatically assigned by the system
+- **sent-date** - date that the notification was sent to the end user from the inbox _(note that usually inbox messages are sent in batch to the user at an interval that the user specifies.)_
+- **read-date** - date that the user read your notification in the ORCID Inbox, OR took action on the notification sent through the users email
+- **actioned-date** - Date the user took action on the notification _(note that some notifications will not have explicit actions, in this case, reading the notification would update both the read & actioned date)_.
+- **archived-date** - date that the user archived your notification
+
+
+## Notifications Permission Reference
+```permission``` notifications are available only in ORCID API v2.0_rcX, which uses a slightly different data structure from previous API versions. 
+
+In v2.0_rcX, items are read, added, and modified on an individual basis (rather than as a list), using a ```put-code```, which is a system-generated identifier used within the ORCID database.
+
+The ```put-code``` for a specific item can be obtained by reading notifications.
+
+Other notable differences between v2.0_rcX previous versions include:
+
+- An explicit ```DELETE``` method is used to remove record items
+
+### Request a notification access token
+
+Authorized client applications may obtain a notification access token from the ORCID server (using a 2-legged, or "client_credentials" OAuth flow) as described below. If your client is not yet authorized, please [contact support](http://orcid.org/help/contact-us) to request this feature to be turned on for your client. 
+
+_Please note that ORCID reserves the right to limit the client applications with authorization to send messages directly to ORCID iD holders using the ORCID Inbox._
+
+**Resource URL**
+
+| Environment | Resource URL |
+| ----------- | ------------ |
+|Developers Sandbox | https://api.sandbox.orcid.org/oauth/token |
+| Production Registry | https://api.orcid.org/oauth/token |
+
+**Parameters**
+
+| Field | Value|
+| ---- | ---- |
+| client_id<br/>*required* | The client id value &lt;client-id&gt; from ORCID client application registration |
+| client_secret<br/>*required* | The client secret value &lt;client-secret&gt; from ORCID client application registration |
+| scope<br/>*required* | The authorization scope for the requested access token. Value must be ```/premium-notification``` |
+| grant_type<br/>*required* | Specifies the authorization mechanism for the granting the access token. Value for this call must be ```client_credentials``` |
+
+**Header**
+
+| Field | Value|
+| ---- | ---- |
+| Accept<br/>_required_ | The format for the call response. Must be ```Accept: application/json``` |
+
+### REST API for notifications
+
+| Action                   | HTTP method | Scope                    | URL                                                      |
+|-------------------------|-------------|--------------------------|----------------------------------------------------------|
+| Add a notification | POST | /premium-notification | http://api.sandbox.orcid.org/v3.0/[ORCID]/notification-permission |
+| Read a notification | GET | /premium-notification | http://api.sandbox.orcid.org/v3.0/[ORCID]/notification-permission/[PUT-CODE] |
+| Flag an unread notification as archived | DELETE | /premium-notification | http://api.sandbox.orcid.org/v3.0/[ORCID]/notification-permission/[PUT-CODE] |
+
+- **[ORCID]** is the ORCID iD for the record, formatted as XXXX-XXXX-XXXX-XXXX
+- **[PUT-CODE]** is the ```put-code``` attribute for the specific ```notification``` that you wish to read or modify.
+
+### Example cURL Statements
+#### Request a notification access token
+```
+curl -i -L -H 'Accept: application/json' \
+	-d 'client_id=APP-...' \
+	-d 'client_secret=...' \
+	-d 'scope=/premium-notification' \
+	-d 'grant_type=client_credentials' \
+	'http://api.sandbox.orcid.org/oauth/token'
+```
+
+#### Add a notification
+```
+curl -i -H 'Authorization: Bearer ...' \
+	-H 'Content-Type: application/orcid+xml' \
+	-X POST -d '@[FILE-PATH]/notification-permission.xml' \
+	https://api.sandbox.orcid.org/v3.0/[ORCID]/notification-permission
+```
+
+#### Read a notification
+```
+curl -i -H 'Authorization: Bearer ...' \
+	-H 'Content-Type: application/orcid+xml' \
+	https://api.sandbox.orcid.org/v3.0/[ORCID]/notification-permission/[PUT-CODE]
+```
+
+#### Flag an unread notification as archived
+```
+curl -i -H 'Authorization: Bearer ...' \
+	-H 'Content-Type: application/orcid+xml' \
+	-X DELETE https://api.sandbox.orcid.org/v3.0/[ORCID]/notification-permission/[PUT-CODE] 
+```

data/resources/notification_3.0/notification-custom-3.0.xsd

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified"
+	targetNamespace="http://www.orcid.org/ns/notification" xmlns:notification="http://www.orcid.org/ns/notification"
+	xmlns:common="http://www.orcid.org/ns/common"
+	xmlns:xs="http://www.w3.org/2001/XMLSchema"
+	xmlns:vc="http://www.w3.org/2007/XMLSchema-versioning" vc:minVersion="1.1">
+	<xs:import namespace="http://www.orcid.org/ns/common" schemaLocation="../common_2.1/common-2.1.xsd" />
+	<xs:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="../xml.xsd"/>
+	<xs:element name="notification">
+		<xs:complexType>
+			<xs:sequence>
+				<xs:element name="notification-type">
+			        <xs:simpleType>
+			            <xs:restriction base="xs:string">
+			                <xs:enumeration value="custom"/>
+			            </xs:restriction>
+			        </xs:simpleType>
+			    </xs:element>
+				<xs:element name="subject">
+					<xs:simpleType>
+						<xs:restriction base="xs:string">
+							<xs:maxLength value="200" />
+						</xs:restriction>
+					</xs:simpleType>
+				</xs:element>
+				<xs:element type="xs:string" name="body-text"/>
+				<xs:element type="xs:string" name="body-html"/>
+				<xs:element ref="common:created-date" minOccurs="0"/>
+				<xs:element ref="common:sent-date"/>
+				<xs:element ref="common:read-date" minOccurs="0"/>
+				<xs:element ref="common:archived-date" minOccurs="0"/>
+				<xs:element ref="common:source" minOccurs="0"/>
+			</xs:sequence>
+            <xs:attribute name="put-code" type="common:put-code" use="optional" />
+            <xs:attribute ref="xml:lang" use="optional" />
+		</xs:complexType>
+	</xs:element>
+</xs:schema>

data/resources/notification_3.0/notification-permission-3.0.xsd

@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="UTF-8"?> 
+<xs:schema attributeFormDefault="unqualified"
+	elementFormDefault="qualified" targetNamespace="http://www.orcid.org/ns/notification"
+	xmlns:notification="http://www.orcid.org/ns/notification" xmlns:common="http://www.orcid.org/ns/common"
+	xmlns:activities="http://www.orcid.org/ns/activities" xmlns:xs="http://www.w3.org/2001/XMLSchema"
+	xmlns:vc="http://www.w3.org/2007/XMLSchema-versioning" vc:minVersion="1.1">
+	<xs:import namespace="http://www.orcid.org/ns/common"
+		schemaLocation="../common_2.1/common-2.1.xsd" />
+	<xs:import namespace="http://www.orcid.org/ns/activities"
+		schemaLocation="../record_2.1/activities-2.1.xsd" />
+	
+	<xs:element name="notifications"> 
+		<xs:annotation>
+			<xs:documentation>Notification container</xs:documentation>
+		</xs:annotation>
+		<xs:complexType>
+			<xs:sequence>
+				<xs:element name="notification" type="notification:notification"
+					minOccurs="0" maxOccurs="unbounded" />
+			</xs:sequence>
+		</xs:complexType>
+	</xs:element>
+	
+	<xs:element name="notification">
+		<xs:annotation>
+			<xs:documentation>Notification element
+			</xs:documentation>
+		</xs:annotation>
+		<xs:complexType>
+			<xs:complexContent>
+				<xs:extension base="notification:notification"></xs:extension>
+			</xs:complexContent>
+		</xs:complexType>
+	</xs:element>
+	
+	<xs:complexType name="notification">
+		<xs:sequence>
+			<xs:element name="notification-type" type="notification:notification-type" />
+			<xs:element name="authorization-url" type="notification:authorization-url" />
+			<xs:element ref="notification:notification-subject" />
+			<xs:element ref="notification:notification-intro" />
+			<xs:element name="items" type="notification:items" />
+			<xs:element ref="common:created-date" minOccurs="0" />
+			<xs:element ref="common:sent-date" minOccurs="0" />
+			<xs:element ref="common:read-date" minOccurs="0" />
+			<xs:element name="actioned-date" type="notification:actioned-date"
+				minOccurs="0" />
+			<xs:element ref="common:archived-date" minOccurs="0" />
+			<xs:element ref="common:source" minOccurs="0" />
+		</xs:sequence>
+		<xs:attribute name="put-code" type="common:put-code"
+			use="optional" />
+	</xs:complexType>
+	
+	<xs:simpleType name="notification-type">
+		<xs:restriction base="xs:string">
+			<xs:enumeration value="permission" />
+		</xs:restriction>
+	</xs:simpleType>
+	
+	<xs:complexType name="authorization-url">
+		<xs:sequence>
+			<xs:choice>
+				<xs:sequence>
+					<xs:element name="uri" type="xs:anyURI" />
+					<xs:element name="path" type="xs:string" minOccurs="0" />
+				</xs:sequence>
+				<xs:element name="path" type="xs:string" />
+			</xs:choice>
+			<xs:element name="host" type="xs:string" minOccurs="0" />
+		</xs:sequence>
+	</xs:complexType>
+	
+	<xs:element name="notification-subject">
+		<xs:annotation>
+			<xs:documentation>The subject line for the message (displayed to the
+				end user)
+			</xs:documentation>
+		</xs:annotation>
+		<xs:simpleType>
+			<xs:restriction base="xs:string" />
+		</xs:simpleType>
+	</xs:element>
+	<xs:element name="notification-intro">
+		<xs:annotation>
+			<xs:documentation>A text-only introductory message to be displayed to
+				the end user, and displayed before the example list of items.
+			</xs:documentation>
+		</xs:annotation>
+		<xs:simpleType>
+			<xs:restriction base="xs:string">
+				<xs:maxLength value="1000" />
+			</xs:restriction>
+		</xs:simpleType>
+	</xs:element>
+	<xs:complexType name="items">
+		<xs:sequence>
+			<xs:element name="item" type="notification:item"
+				maxOccurs="unbounded" />
+		</xs:sequence>
+	</xs:complexType>
+	<xs:complexType name="item">
+		<xs:sequence>
+			<xs:element name="item-type" type="notification:activity-type" />
+			<xs:element name="item-name">
+				<xs:simpleType>
+					<xs:restriction base="xs:string">
+						<xs:maxLength value="1000" />
+					</xs:restriction>
+				</xs:simpleType>
+			</xs:element>
+			<xs:element ref="common:external-id" minOccurs="0" />
+		</xs:sequence>
+	</xs:complexType>
+	<xs:simpleType name="activity-type">
+		<xs:restriction base="xs:string">
+			<xs:enumeration value="education"></xs:enumeration>
+			<xs:enumeration value="employment"></xs:enumeration>
+			<xs:enumeration value="funding"></xs:enumeration>
+			<xs:enumeration value="work"></xs:enumeration>
+			<xs:enumeration value="peer-review"></xs:enumeration>
+		</xs:restriction>
+	</xs:simpleType>
+	<xs:complexType name="actioned-date">
+		<xs:annotation>
+			<xs:documentation>The date time when the user took action on the
+				notification.
+			</xs:documentation>
+		</xs:annotation>
+		<xs:simpleContent>
+			<xs:extension base="xs:dateTime" />
+		</xs:simpleContent>
+	</xs:complexType>
+</xs:schema>

data/resources/notification_3.0/samples/notification-custom-3.0.xml

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<notification:notification put-code="1"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://www.orcid.org/ns/notification ../notification-custom-3.0.xsd"
+    xmlns:notification="http://www.orcid.org/ns/notification"
+    xmlns:common="http://www.orcid.org/ns/common"
+    xml:lang="en-gb">
+    <notification:notification-type>custom</notification:notification-type>
+    <notification:subject>Important Notification from ORCID</notification:subject>
+    <notification:body-text>This is an email with important info.
+    </notification:body-text>
+    <notification:body-html><![CDATA[
+        <p>
+            This is an email with <em>important</em> info.
+        </p>]]>
+    </notification:body-html>
+	<common:created-date>2014-01-01T09:17:56</common:created-date>
+    <common:sent-date>2014-01-01T14:45:32</common:sent-date>
+    <common:source>
+        <common:source-orcid>
+            <common:uri>https://orcid.org/2111-1111-1111-1114</common:uri>
+            <common:path>2111-1111-1111-1114</common:path>
+            <common:host>orcid.org</common:host>
+        </common:source-orcid>
+        <common:source-name>Member 1</common:source-name>
+    </common:source>
+</notification:notification>

data/resources/notification_3.0/samples/notification-permission-3.0.xml

@@ -0,0 +1,58 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
+<!--
+
+    =============================================================================
+
+    ORCID (R) Open Source
+    http://orcid.org
+
+    Copyright (c) 2012-2014 ORCID, Inc.
+    Licensed under an MIT-Style License (MIT)
+    http://orcid.org/open-source-license
+
+    This copyright and license information (including a link to the full license)
+    shall be included in its entirety in all copies or substantial portion of
+    the software.
+
+    =============================================================================
+
+-->
+<notification:notification put-code="1" xsi:schemaLocation="http://www.orcid.org/ns/notification ../notification-permission-3.0.xsd" xmlns:common="http://www.orcid.org/ns/common" xmlns:notification="http://www.orcid.org/ns/notification" xmlns:activities="http://www.orcid.org/ns/activities" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+    <notification:notification-type>permission</notification:notification-type>
+    <notification:authorization-url>
+        <!-- API user can specify just the path if they want, and leave out the uri element. -->
+        <notification:uri>https://orcid.org/oauth/authorize?client_id=APP-U4UKCNSSIM1OCVQY&amp;response_type=code&amp;scope=/orcid-works/create&amp;redirect_uri=http://somethirdparty.com</notification:uri>
+        <notification:path>/oauth/authorize?client_id=APP-U4UKCNSSIM1OCVQY&amp;response_type=code&amp;scope=/orcid-works/create&amp;redirect_uri=http://somethirdparty.com</notification:path>
+        <notification:host>orcid.org</notification:host>
+    </notification:authorization-url>
+    <notification:notification-subject>Subject</notification:notification-subject>
+    <notification:notification-intro>Intro</notification:notification-intro>
+    <notification:items>
+        <notification:item>
+            <notification:item-type>work</notification:item-type>
+            <notification:item-name>A Really Interesting Research Article</notification:item-name>
+            <common:external-id>
+                <common:external-id-type>doi</common:external-id-type>
+                <common:external-id-value>http://10.5555/12345ABCDE</common:external-id-value>
+                <common:external-id-relationship>self</common:external-id-relationship>
+            </common:external-id>
+        </notification:item>
+        <notification:item>
+            <notification:item-type>employment</notification:item-type>
+            <notification:item-name>Head of Research at NanoBiologica</notification:item-name>
+        </notification:item>
+    </notification:items>
+    <!--  Read only for API user -->
+    <common:created-date>2014-01-01T09:17:56</common:created-date>
+    <!--  Read only for API user -->
+    <common:sent-date>2014-01-01T14:45:32</common:sent-date>
+    <common:source>
+        <!--  Read only for API user - will only be able to see notifications for which they are the source -->
+        <common:source-client-id>
+            <common:uri>https://orcid.org/client/APP-U4UKCNSSIM1OCVQY</common:uri>
+            <common:path>APP-U4UKCNSSIM1OCVQY</common:path>
+            <common:host>orcid.org</common:host>
+        </common:source-client-id>
+        <common:source-name>Member 1</common:source-name>
+    </common:source>
+</notification:notification>

data/resources/record_3.0/README.md

@@ -0,0 +1,408 @@
+# ORCID API v3.0 Guide
+
+## Endpoints
+
+- activities (read only)
+- address
+- biography (read only)
+- distinction/distinctions
+- education/educations
+- email (read only)
+- employment/employments
+- external-identifiers
+- funding/fundings
+- invited-position/invited-positions
+- keywords
+- membership/memberships
+- other-names
+- peer-review/peer-reviews
+- person (read only)
+- personal-details (read only)
+- qualification/qualifications
+- record (read only)
+- research-resource/research-resources
+- researcher-urls
+- service/services
+- work/works
+
+## XSDs and current state (all stable)
+- [activities-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/activities-3.0.xsd)
+**stable**
+- [address-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/address-3.0.xsd)
+**stable**
+- [bulk-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/bulk-3.0.xsd)
+**stable**
+- [common-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/common_3.0/common-3.0.xsd)
+**stable**
+- [distinction-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/distinction-3.0.xsd)
+**stable**
+- [education-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/education-3.0.xsd)
+**stable**
+- [email-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/email-3.0.xsd)
+**stable**
+- [employment-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/employment-3.0.xsd)
+**stable**
+- [error-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/error-3.0.xsd)
+**stable**
+- [funding-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/funding-3.0.xsd)
+**stable**
+- [invited-position-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/invited-position-3.0.xsd)
+**stable**
+- [keyword-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/keyword-3.0.xsd)
+**stable**
+- [membership-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/membership-3.0.xsd)
+**stable**
+- [other-names-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/other-name-3.0.xsd)
+**stable**
+- [peer-review-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/peer-review-3.0.xsd)
+**stable**
+- [person-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/person-3.0.xsd)
+**stable**
+- [person-external-identifier-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/person-external-identifier-3.0.xsd)
+**stable**
+- [personal-details-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/personal-details-3.0.xsd)
+**stable**
+- [qualification-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/qualification-3.0.xsd)
+**stable**
+- [research-resource-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/research-resource-3.0.xsd)
+**stable**
+- [researcher-url-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/researcher-url-3.0.xsd)
+**stable**
+- [search-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/search-3.0.xsd)
+**stable**
+- [service-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/service-3.0.xsd)
+**stable**
+- [work-3.0.xsd](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/work-3.0.xsd)
+**stable**
+
+## Tutorials
+
+- [General guide to the ORCID API](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web)
+- [Tutorials for reading and writing to ORCID records](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web/tutorial)
+
+
+## Changes from Version 2.1:
+
+### JSON
+- JSON enumerated types are now expressed in lowercase with dashes instead of underscores, matching the existing XML enums (ie *JOURNAL_ARTICLE* is now expressed as *journal-article*). This affects enums for visibility, locale, work types, contributor roles, citation types, external identifier relationship, funding types, peer review types, and peer review role
+
+### Assertion Origin Source information
+- Member clients can now generating tokens that allow another client to update an ORCID record on behalf of the original client. This process is described in the [Token Delegation tutorial](https://github.com/ORCID/ORCID-Source/blob/master/orcid-api-web/tutorial/token_delegation.md).
+- Items added using token delegation have additional source fields *common:assertion-origin-client-id* and *common:assertion-origin-name*.
+- Items added by clients associated with a Search and Link Wizard have the client listed as the source of the item and the user as the source of the assertion with the fields *common:assertion-origin-orcid* and *common:assertion-origin-orcid*
+
+### Identifiers
+- Addition of new identifier relationship *version-of*, which is intended to map works to identifiers of different versions and instances of the same work. Works with the same *version-of* identifier are grouped together.
+
+### Activities external identifiers
+- Addition of *common:external-id-normalized* for work and peer-review identifiers. The common:external-id-normalized field is a transient, system generated field which expresses the identifier in a standard format that is used for grouping. In general, normalized identifiers trim extraneous text such as the identifier type or the expression of the identifier as a url. Additional normalization is done based on the rules of the identifier type and may include setting all alpha characters to lower case,  or transforming spaces, dashes, periods and other characters that can be treated as equivalent. [See the full normalization rules](https://github.com/ORCID/ORCID-Source/tree/master/orcid-core/src/main/java/org/orcid/core/utils/v3/identifiers). Identifiers which can not be normalized will return a error message when reading them.
+
+### Affiliations
+- Addition of new affiliation sections: Distinction, Invited-position, Membership, Qualification, and Service in addition to the existing Education and Employment sections. For more information see [Affiliations tutorial](https://github.com/ORCID/ORCID-Source/blob/master/orcid-api-web/tutorial/affiliations.md)
+- Summary information now available for each section including affiliation source, role-title, department-name, dates, organization and external-ids
+- Addition of optional element *common:external-ids* for identifiers that apply to the affiliation itself (*common:disambiguated-organization-identifier* should continue to be be used for organizational identifiers)
+- Grouping of affiliations using external-ids, including returning affiliations in the *activities:affiliation-group* tag when reading an entire section.
+- *common:start-date* is required if *common:end-date* is provided
+- Addition of optional element *common:url* for recording links about the affiliation
+- Addition of optional element *common:external-ids* for recording identifiers for the affiliation
+- Disambiguated organization identifier is now required and must be a valid Ringgold, FundRef, or GRID identifier
+- Use of common namespace for *common:department-name*, *common:role-title* and *common:organization*
+
+### Research-resources
+- This new section of the ORCID record captures information about things that researchers use for their research which require a specific proposal process or credential to access, such as collections, equipment, infrastructure, and services. For more information see the [Research-resource tutorial](https://github.com/ORCID/ORCID-Source/blob/master/orcid-api-web/tutorial/research-resources.md).
+
+### Works
+- an external-id with a *self* relationship is now required when posting works
+- *work:journal-title* field is returned with the work summary
+- Addition of *common:external-id-normalized* when reading works for normalized work identifiers
+- Use of common namespace for *common:url* replacing *work:url* and this field is now returned in the work summary
+- Addition of *annotation*, *software* and *physical object* to the list of [supported work types](https://members.orcid.org/api/resources/work-types)
+- work type *dissertation* has been migrated to *dissertation-thesis*
+
+### Fundings
+- Disambiguated organization identifier is now required and must be a valid Ringgold, FundRef, or GRID identifier
+- Use of common namespace for *common:organization*, replacing *funding:organization*
+- Use of common namespace for *common:url* replacing *funding:url* and this field is now returned in the funding summary
+- *common:start-date* is required if *common:end-date* is provided
+
+### Peer-review
+- *reviewer-role* and *review-type* are returned with the peer-review summary
+- Disambiguated organization identifier is now required and must be a valid Ringgold, FundRef, or GRID identifier
+- Addition of *common:external-id-normalized* when reading peer-reviews for normalized peer-review identifiers
+- Addition of *grant*, *contract*, *award*, *salary-award*, and *research-resource-proposal* to supported subject types
+
+## Sample files:
+
+- [read activities-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/activities-3.0.xml)
+- [read address-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/address-3.0.xml)
+- [write address-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/address-3.0.xml)
+- [write bulk-work xml-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/bulk-work-3.0.xml)
+- [write bulk-work-3.0.json](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/bulk-work-3.0.json)
+- [read biography-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/biography-3.0.xml)
+- [distinction-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/distinction-3.0.xml)
+- [write distinction-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/distinction-3.0.xml)
+- [read distinctions-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/distinctions-3.0.xml)
+- [read education-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/education-3.0.xml)
+- [write education-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/education-3.0.xml)
+- [read educations-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/educations-3.0.xml)
+- [read email-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/email-3.0.xml)
+- [read emails-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/emails-3.0.xml)
+- [read employment-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/employment-3.0.xml)
+- [write employment-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/employment-3.0.xml)
+- [read employments-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/employments-3.0.xml)
+- [error-message-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/error-3.0.xml)
+- [read external-identifier-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/external-identifier-3.0.xml)
+- [write external-identifier-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/external-identifier-3.0.xml)
+- [read external-identifiers-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/external-identifiers-3.0.xml)
+- [read funding-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/funding-3.0.xml)
+- [write funding-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/funding-3.0.xml)
+- [read fundings-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/fundings-3.0.xml)
+- [read invited-position-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/invited-position-3.0.xml)
+- [write invited-position-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/invited-position-3.0.xml)
+- [read invited-positions-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/invited-positions-3.0.xml)
+- [read keyword-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/keyword-3.0.xml)
+- [write keyword-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/keyword-3.0.xml)
+- [read keywords-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/keywords-3.0.xml)
+- [read membership-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/membership-3.0.xml)
+- [write membership-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/membership-3.0.xml)
+- [read memberships-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/memberships-3.0.xml)
+- [read other-name-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/other-name-3.0.xml)
+- [write other-name-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/other-name-3.0.xml)
+- [read other-names-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/other-names-3.0.xml)
+- [read peer-review-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/peer-review-3.0.xml)
+- [write full peer-review-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/peer-review-full-3.0.xml)
+- [write simple peer-review-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/peer-review-simple-3.0.xml)
+- [read peer-reviews-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/peer-reviews-3.0.xml)
+- [read person-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/person-3.0.xml)
+- [read personal-details-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/personal-details-3.0.xml)
+- [read qualification-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/qualification-3.0.xml)
+- [write qualification-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/qualification-3.0.xml)
+- [read qualifications-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/qualification-3.0.xml)
+- [read research-resource-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/research-resource-3.0.xml)
+- [write research-resource-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/research-resource-3.0.xml)
+- [read research-resources-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/research-resource-3.0.xml)
+- [read researcher-url-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/researcher-url-3.0.xml)
+- [write researcher-url-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/researcher-url-3.0.xml)
+- [read researcher-urls-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/researcher-urls-3.0.xml)
+- [search-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/search-3.0.xml)
+- [read service-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/service-3.0.xml)
+- [write service-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/service-3.0.xml)
+- [read services-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/services-3.0.xml)
+- [read work-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/work-3.0.xml)
+- [write full work-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/work-full-3.0.xml)
+- [write simple work-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/write_samples/work-simple-3.0.xml)
+- [read works-3.0.xml](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/works-3.0.xml)
+
+For working with json see [ORCID conversion util](https://github.com/ORCID/orcid-conversion-lib)
+
+## REST API Reference
+
+### API Tutorials
+- [General guide to the ORCID API](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web)
+- [Tutorials for reading and writing to ORCID records](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web/tutorial)
+
+### Swagger
+
+The swagger interfaces to the API available at:
+- [member](https://api.orcid.org/v3.0/)
+- [public](https://pub.orcid.org/v3.0/)
+
+### Scopes
+| Scope           | Request method | Obtain Access Token Through	| Expires In | API  |
+|-----------------|-------------|--------------------------|----------------------------------|-------------|
+| /authenticate     | GET| [3-legged OAuth](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web#authenticating-users-and-using-oauth--openid-connect)| When expired or revoked by user | Public API and Member API   |
+| /activities/update     |POST, PUT, DELETE| [3-legged OAuth](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web#authenticating-users-and-using-oauth--openid-connect)| When expired or revoked by user | Member API   |
+| /person/update     |POST, PUT, DELETE| [3-legged OAuth](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web#authenticating-users-and-using-oauth--openid-connect)| When expired or revoked by user | Member API   |
+| /read-limited     |GET| [3-legged OAuth](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web#authenticating-users-and-using-oauth--openid-connect)| When expired or revoked by user | Member API   |
+| /read-public     |GET| [Client credentials](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web#generate-a-two-step-read-public-access-token) | When revoked by ORCID | Public API and Member API  |
+| /webhook     |PUT, DELETE| [Client credentials](https://github.com/ORCID/ORCID-Source/tree/master/orcid-api-web#generate-a-two-step-read-public-access-token) | When revoked by ORCID | Premium Member API  |
+| openid  | GET | [OpenID Connect 1.0](https://github.com/ORCID/ORCID-Source/blob/master/orcid-web/ORCID_AUTH_WITH_OPENID_CONNECT.md) | When expired or revoked by user | Public API and Member API  |
+
+Multiple scopes can be requested with a single access token by listing the requested scopes with a space between each in the authorization URL.
+
+
+### Calls
+| Action                   | HTTP method | Scope                    | URL                                                      |
+|-------------------------|-------------|--------------------------|----------------------------------------------------------|
+| Read the entire record | GET       | /read-limited or /read-public | https://[HOST]/v3.0/[ORCID]/record |
+| Read an activities section | GET | /read-limited or /read-public | https://[HOST]/v3.0/[ORCID]/[SECTION]s |
+| Read a person section | GET | /read-limited or /read-public | https://[HOST]/v3.0/[ORCID]/[SECTION] |
+| Read a single item   | GET         | /read-limited or /read-public | https://[HOST]/v3.0/[ORCID]/[SECTION]/[PUT-CODE] |
+| Add a person item    | POST        | /person/update       		 | https://[HOST]/v3.0/[ORCID]/[SECTION]            |
+| Update a person item | PUT         | /person/update  				 | https://[HOST]/v3.0/[ORCID]/[SECTION]/[PUT-CODE] |
+| Delete a person item | DELETE      | /person/update				 | https://[HOST]/v3.0/[ORCID]/[SECTION]/[PUT-CODE] |
+| Add an activity    | POST          | /activities/update       | https://[HOST]/[ORCID]/[SECTION]            |
+| Update an activity | PUT           | /activities/update       | https://[HOST]/v3.0/[ORCID]/[SECTION]/[PUT-CODE] |
+| Delete an activity | DELETE        | /activities/update       | https://[HOST]/v3.0/[ORCID]/[SECTION]/[PUT-CODE] |
+| Add multiple works| POST           | /read-limited or /read-public | https://[HOST]/v3.0/[ORCID]/works		             |
+| Read multiple works| GET          | /activities/update       | https://[HOST]/v3.0/[ORCID]/works/[PUT-CODE1],[PUT-CODE2]  |
+| Search records     | GET         | /read-public      	      | https://[HOST]/v3.0/search?q=[SOLR-QUERY]*          	 |
+
+[HOST] is the ORCID environment you are using
+- api.sandbox.orcid.org for the Member API on the ORCID Sandbox
+- pub.sandbox.orcid.org for the Public API on the ORCID Sandbox (/read-public scope only)
+- api.orcid.org for the Member API on the production ORCID Registry
+- pub.orcid.org for the Public API on the production ORCID Registry (/read-public scope only)
+
+[ORCID] is the ORCID iD for the record.
+
+[SECTION] can be one of the following:
+- activities
+- address
+- biography *
+- distinction
+- education
+- email *
+- employment
+- external-identifiers
+- funding
+- invited-position
+- keywords
+- membership
+- other-names
+- peer-review
+- person *
+- personal-details *
+- qualification
+- research-resource
+- researcher-urls
+- service
+- work
+
+**Notes:**
+- biography, email, person and personal-details sections are read only
+- when reading and posting multiple works a maximum of 100 works can be accessed with a single call.
+- When searching by default a maximum of 100 results will be returned. The `rows` parameter can be used to increase the number or results, but only up to 200. The `start` parameter (integer pointing to the zero-based position of the first result to be returned) can be used to page through larger results sets. See [Searching the API tutorial](https://github.com/ORCID/ORCID-Source/blob/master/orcid-api-web/tutorial/search.md)
+
+## OpenID Connect
+In addition to the REST API, ORCID Supports [OpenID Connect](https://github.com/ORCID/ORCID-Source/blob/master/orcid-web/ORCID_AUTH_WITH_OPENID_CONNECT.md) and an [Implicit workflow](https://github.com/ORCID/ORCID-Source/blob/master/orcid-web/ORCID_AUTH_WITH_OPENID_CONNECT.md#implicit-flow).
+
+## Examples
+
+### Read sections
+
+| Item               |Scope               | Example cURL Statement                                         |
+|--------------------|--------------------------|----------------------------------------------------------------|
+| Entire record | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/record'```|
+| Activities summary | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/activities'```|
+| Addresses			 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/address'```|
+| Distinction summary    | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/distinctions'```|
+| Education summary    | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/educations'```|
+| Emails     		 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/email'```|
+| Employment summary   | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/employments'```|
+| External identifiers	| /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/external-identifiers'```|
+| Funding summary    | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/fundings'```|
+| Invited position summary    | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/invited-position'```|
+| Keywords     		 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/keywords'```|
+| Membership summary    		 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/memberships'```|
+| Other names     	 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/other-names'```|
+| Peer review summary| /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/peer-reviews'```|
+| Personal details	 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/personal-details'```|
+| Person			 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/person'```|
+| Qualification summary			 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/qualifications'```|
+| Research-resource summary			 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/research-resources'```|
+| Researcher URLs    | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/researcher-urls'```|
+| Service summary             | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/services'```|
+| Works summary             | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/works'```|
+
+
+### Read Record Items
+| Item               |Scope               | Example cURL Statement                                         |
+|--------------------|--------------------------|----------------------------------------------------------------|
+| Address			 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/address/4556'```|
+| Biography			 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/biography'```|
+| Distinction          | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/distinction/29770'```|
+| Education          | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/education/22423'```|
+| Employment         | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/employment/22411'```|
+| External identifier| /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/external-identifiers/3193'```|
+| Funding            | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/funding/4413'```|
+| Invited position            | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/invited-position/29778'```|
+| Keyword     		 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/keywords/4504'```|
+| Membership     		 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/membership/29779'```|
+| Other names     	 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/other-names/15812'```|
+| Peer review        | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/peer-review/1374'```|
+| Qualification        | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/peer-review/29769'```|
+| Research-resource        | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/research-resource/1000'```|
+| Researcher URL     | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/researcher-urls/41387'```|
+| Service     		 | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/service/29773'```|
+| Work               | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/work/733536'```|
+| Multiple Works     | /read-limited or /read-public|```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/works/733535,733536'```|
+
+When reading multiple works the contents of each work is returned or an error code is returned if there is an issue with a single work.
+
+
+### Add Record Items
+|Item    |Scope       | Example cURL Statement  |
+|---------|----------------|-------------------------|
+| Address	|/person/update           |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/address.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/address```|
+| Distinction  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/distinction-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/distinction' ```|
+| Education  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/education-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/education' ```|
+| Employment |  /activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/employment-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/employment' ```|
+| External identifiers	| /person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/external_identifier.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/external-identifiers```|
+| Funding  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/funding-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/funding'```|
+| Invited position  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/invited-position-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/invited-position'```|
+| Keywords     	|/person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/keyword.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/keywords```|
+| Membership     	|/person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/membership-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/membership ```|
+| Other names  |/person/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/other-name.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/other-names'```|
+| Peer review  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/peer-review-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/peer-review'```|
+| Qualification  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/qualification-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/qualification'```|
+| Research-resource  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/qualification-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/research-resource'```|
+| Researcher URL  |/person/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/researcher-url.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/researcher-urls'```|
+| Service  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/service-item.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/service'```|
+| Work  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/work.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/work'```|
+| Multiple works |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/works.xml' -X POST 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/works'```|
+
+When posting multiple works the contents of each work is returned or an error code is returned if there is an issue with a single work, see [bulk work error sample](https://github.com/ORCID/orcid-model/blob/master/src/main/resources/record_3.0/samples/read_samples/bulk-work-error.xml).
+
+### Update Record Items
+|Item  |Scope  | Example cURL Statement  |
+|------|----------------|---------------------|
+| Address	|/person/update       |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/address.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/address/[PUT-CODE]```|
+| Distinction |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/distinction-item-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/distinction/[PUT-CODE]' ```|
+| Education  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/education-item-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/education/[PUT-CODE]' ```|
+| Employment |  /activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/employment-item-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/employment/[PUT-CODE]' ```|
+| External identifiers	|/person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/external_identifier.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/external-identifiers/[PUT-CODE]```|
+| Funding  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/funding-item-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/funding/[PUT-CODE]'```|
+| Invited position  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/invited-position-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/invited-position/[PUT-CODE]'```|
+| Keywords     	|/person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/keyword.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/keywords/[PUT-CODE]```|
+| Membership  |/activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/membership-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/membership/[PUT-CODE]'```|
+| Other names  |/person/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/other-name.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/other-names/[PUT-CODE]'```|
+| Peer review  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/peer-review-item-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/peer-review/[PUT-CODE]'```|
+| Qualification  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/qualification-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/qualification/[PUT-CODE]'```|
+| Research-resource  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/qualification-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/research-resource/[PUT-CODE]'```|
+| Researcher URL  |/person/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/researcher-url.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/researcher-urls/[PUT-CODE]'```|
+| Service  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/service-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/service/[PUT-CODE]'```|
+| Work  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -d '@[FILE-PATH]/work-updated.xml' -X PUT 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/work/[PUT-CODE]'```|
+
+When updating a record item, include the put code as an attribute in the root element, ex: ```<education:education put-code="14775" xmlns:common="http://www.orcid.org/ns/common" xmlns:education="http://www.orcid.org/ns/education" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.orcid.org/ns/education ../education-3.0.xsd ">```
+
+### Delete Record Items
+|Item  | Scope      | Example cURL Statement  |
+|------|----------------|-------------------------|
+| Address	| /person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/address/[PUT-CODE]```|
+| Distinction  | /activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/distinction/[PUT-CODE]'  ```|
+| Education  | /activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/education/[PUT-CODE]'  ```|
+| Employment |  /activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/employment/[PUT-CODE]' ```|
+| External identifiers	| /person/update    |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/external-identifiers/[PUT-CODE]```|
+| Funding  | /activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/funding/[PUT-CODE]'```|
+| Invited Position  | /activities/update  |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/invited-position/[PUT-CODE]'```|
+| Keywords     	| /person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/keywords/[PUT-CODE]```|
+| Membership     	| /person/update            |```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/membership/[PUT-CODE]```|
+| Other names  | /person/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/researcher-urls/[PUT-CODE]'```|
+| Peer review  | /activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/peer-review/[PUT-CODE]'```|
+| Qualifiation  | /activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/qualification/[PUT-CODE]'```|
+| Research-resource  | /activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/research-resource/[PUT-CODE]'```|
+| Researcher URL  | /person/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/researcher-urls/[PUT-CODE]'```|
+| Service  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/service/[PUT-CODE]'```|
+| Work  |/activities/update|```curl -i -H 'Content-type: application/vnd.orcid+xml' -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'https://api.sandbox.orcid.org/v3.0/0000-0002-9227-8514/work/[PUT-CODE]'```|
+
+### Webhooks
+|Item  | Scope      | Example cURL Statement  |
+|------|----------------|-------------------------|
+| Register a webhook	| /webhook|```curl -v -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X PUT 'http://api.sandbox.orcid.org/0000-0002-9227-8514/webhook/http%3A%2F%2Fencoded.url%2F0000-0002-9227-8514'```|
+| Delete a webhook  	| /webhook |```curl -v -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' -X DELETE 'http://api.sandbox.orcid.org/0000-0002-9227-8514/webhook/http%3A%2F%2Fencoded.url%2F0000-0002-9227-8514'  ```|
+
+### Search
+| Item               | Scope               |  Example cURL Statement                                         |
+|--------------------|--------------------------|-------------------------------------------------------|
+| Search records     | /read-public             | ```curl -i -H "Accept: application/vnd.orcid+xml" -H 'Authorization: Bearer dd91868d-d29a-475e-9acb-bd3fdf2f43f4' 'https://api.sandbox.orcid.org/v3.0/search?q=Simpson'```|