Last reviewed: 2019-08-12

Note: The term Remove used in in the APIs is exactly the same as the Delete function. Calling any API with the Remove term will result in the associated data being deleted from the database. There is no recovery function for these Remove calls.

XML Schema

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="organization">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="organization-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="user">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="user-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="pendingUser">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="pendingUser-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="role">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="role-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="mandatetemplate">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="mandatetemplate-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="mandate">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="mandate-type"></xs:extension>
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="mandatelist">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="givenmandatelist" type="mandatelist-type" />
                <xs:element name="receivedmandatelist" type="mandatelist-type" />
                <xs:any namespace="##any" processContents="skip" />
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="givenmandatelist">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="mandatelist-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="receivedmandatelist">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="mandatelist-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="entitylist">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="entitylist-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="idlist">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="idlist-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="mandateidlist">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="givenmandateidlist" type="idlist-type" />
                <xs:element name="receivedmandateidlist"
                    type="idlist-type" />
                <xs:any namespace="##any" processContents="skip" />
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <xs:element name="roleinvitation">
        <xs:complexType>
            <xs:complexContent>
                <xs:extension base="roleinvitation-type" />
            </xs:complexContent>
        </xs:complexType>
    </xs:element>
    <xs:element name="error">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="code" type="xs:string"
                    minOccurs="0" maxOccurs="1" />
                <xs:element name="message" type="xs:string"
                    minOccurs="0" maxOccurs="1" />
            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- Type definitions -->
    <xs:complexType name="organization-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" />
            <xs:element name="virtual" type="xs:string" />
            <xs:element name="friendlyName" type="xs:string" />
            <xs:element name="technicalname" type="xs:string" />
            <xs:element name="organizationClass" type="xs:string" />
            <xs:element name="customattribute" type="customattribute-type"
                minOccurs="0" maxOccurs="unbounded" />
            <xs:element name="memberships" type="memberships-type" />
            <xs:element name="members" type="members-type" />
            <xs:element name="roles" type="roles-type" />
            <xs:element name="applicationCount" type="xs:string" />
            <xs:element name="pendingOrganizations" type="pendingOrganizations-type" />
            <xs:element name="givenmandates" type="mandates-type" />
            <xs:element name="receivedmandates" type="mandates-type" />
            <xs:any namespace="##any" processContents="skip"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="user-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" />
            <xs:element name="organization" type="xs:string" />
            <xs:element name="organizationFriendlyName" type="xs:string" />
            <xs:element name="status" type="xs:string" />
            <xs:element name="attributes" type="attributes-type" />
            <xs:element name="roleassignments" type="roleassignments-type" />
            <xs:element name="groupassignments" type="groupassignments-type" />
            <xs:element name="authentication" type="authentication-type" />
            <xs:element name="givenmandates" type="mandates-type" />
            <xs:element name="receivedmandates" type="mandates-type" />
            <xs:any namespace="##any" processContents="skip"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="attributes-type">
        <xs:sequence>
            <xs:element name="uid" type="xs:string" />
            <xs:element name="firstname" type="xs:string" />
            <xs:element name="surname" type="xs:string" />
            <xs:element name="email" type="xs:string" />
            <xs:element name="mobile" type="xs:string" />
            <xs:element name="hetu" type="xs:string" />
            <xs:element name="cn" type="xs:string" />
            <xs:element name="organization" type="xs:string" />
            <xs:element name="customattribute" type="customattribute-type"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="customattribute-type">
        <xs:sequence>
            <xs:element name="value" type="xs:string"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
        <xs:attribute name="name" type="xs:string" use="optional" />
    </xs:complexType>
    <xs:complexType name="memberships-type">
        <xs:choice>
            <xs:sequence>
                <xs:element name="id" type="xs:string"
                    minOccurs="0" maxOccurs="unbounded" />
            </xs:sequence>
            <xs:sequence>
                <xs:element name="organization" type="organization-type"
                    minOccurs="0" maxOccurs="unbounded" />
            </xs:sequence>
        </xs:choice>
    </xs:complexType>
    <xs:complexType name="members-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" minOccurs="1"
                maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="roles-type">
        <xs:sequence>
            <xs:element name="role" type="role-type"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="role-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" />
            <xs:element name="roleassignments" type="roleassignments-type"
                minOccurs="0" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="roleassignments-type">
        <xs:sequence>
            <xs:element name="roleassignment" type="roleassignment-type"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="roleassignment-type">
        <xs:choice>
            <xs:element name="role" type="role-type" />
            <xs:element name="userid" type="xs:string" />
            <xs:element name="user" type="user-type" />
        </xs:choice>
    </xs:complexType>
    <xs:complexType name="pendingOrganizations-type">
        <xs:sequence>
            <xs:element name="count" type="xs:string" />
            <xs:element name="newest" type="xs:string" />
            <xs:element name="oldest" type="xs:string" />
            <xs:element name="url" type="xs:string" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="groupassignments-type">
        <xs:sequence>
            <xs:element name="groupassignment" type="groupassignment-type"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="groupassignment-type">
        <xs:sequence>
            <xs:element name="group" type="group-type" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="group-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="authentication-type">
        <xs:sequence>
            <xs:element name="password" type="xs:string"
                minOccurs="0" maxOccurs="1" />
            <xs:element name="sms.activated" type="xs:string"
                minOccurs="0" maxOccurs="1" />
            <xs:element name="otp.activated" type="xs:string"
                minOccurs="0" maxOccurs="1" />
            <xs:element name="otp.state" type="xs:string"
                minOccurs="0" maxOccurs="1" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="idlist-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="entitylist-type">
        <xs:sequence>
            <xs:element ref="organization" minOccurs="0"
                maxOccurs="unbounded" />
            <xs:element ref="user" minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="mandatelist-type">
        <xs:sequence>
            <xs:choice>
                <xs:element ref="mandate" minOccurs="0"
                    maxOccurs="unbounded" />
                <xs:element name="id" type="xs:string"
                    minOccurs="0" maxOccurs="unbounded" />
            </xs:choice>
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="error-type">
        <xs:sequence>
            <xs:element name="code" type="xs:string"
                minOccurs="0" maxOccurs="1" />
            <xs:element name="message" type="xs:string"
                minOccurs="0" maxOccurs="1" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="delegations-type">
        <xs:sequence>
            <xs:element name="userid" type="xs:string"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="mandates-type">
        <xs:sequence>
            <xs:element name="mandate" type="mandate-type"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="mandate-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" />
            <xs:element name="name" type="xs:string" />
            <xs:element name="type" type="xs:string" />
            <xs:element name="mandater" type="xs:string" />
            <xs:element name="mandatee" type="xs:string" />
            <xs:element name="roles" type="roles-type" />
            <xs:element name="delegations" type="delegations-type" />
            <xs:any namespace="##any" minOccurs="0" maxOccurs="unbounded"
                processContents="skip" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="mandatetemplates-type">
        <xs:sequence>
            <xs:element name="mandatetemplate" type="mandatetemplate-type"
                minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="mandatetemplate-type">
        <xs:sequence>
            <xs:element name="id" type="xs:string" />
            <xs:element name="name" type="xs:string" />
            <xs:element name="type" type="xs:string" />
            <xs:element name="mandater" type="xs:string" />
            <xs:element name="roles" type="roles-type" />
            <xs:any namespace="##any" minOccurs="0" maxOccurs="unbounded"
                processContents="skip" />
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="roleinvitation-type">
        <xs:sequence>
            <xs:element name="user" type="user-type"></xs:element>
            <xs:element name="roles" type="roles-type"></xs:element>
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="pendingUser-type">
        <xs:sequence>
            <xs:element name="userid" type="xs:string"></xs:element>
            <xs:element name="pendinguserid" type="xs:string"></xs:element>
            <xs:element name="registrationwf" type="xs:string"></xs:element>
        </xs:sequence>
    </xs:complexType>
</xs:schema>

Modification Operations

MOD014 Create Mandate

Description

Create a new mandate.

Target Type

Collection

Request URL

Request URL defines the constant mandate collection.

Example

https://HOSTNAME/customerid-rest/services/mandates/

Request Method

POST

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Description
mandateType	ORGTOORG PERTOORG ORGTOPER PERTOPER		X	Defines the type of the mandate.
roles	List of role entity names	X	X	At least one role has to be defined. Multiple roles are separated with ',' character.
mandater	Entity Name		X
mandatee	Entity Name		X
name	String			If not defined the name will be generated by the system.

Curl Example

curl --insecure -X POST -u restuser:secret "https://localhost:7443/customerid-rest/services/mandates/?mandateType=ORGTOORG&roles=6666666-6/TestRole&mandater=6666666-6&mandatee=7777777-7"

Response Document

<idlist>
 <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
</idlist>

MOD015 Update Mandate

Description

Update the mandate.

Target Type

Entity

Request URL

Request URL defines the mandate to be updated.

Example

https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME

Request Method

PUT

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Default	Description
roles	List of role entity names	X	X		At least one role has to be defined.

Curl Example

curl --insecure -X PUT -u restuser:secret "https://localhost:7443/customerid-rest/services/mandate/7777777-7XXXXXXXXXXXXXXXXXXXX?roles=6666666-6/TestRole2"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
 </idlist>

MOD016 Delegate Mandate

Description

Delegate a mandate to a user. Assign all the roles defined in the mandate to the user.

Target Type

Collection

Request URL

Request URL defines the mandate to be delegated.

Example

https://HOSTNAME/customerid-rest/services/delegations/MANDATENAME

Request Method

PUT

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Default	Description
delegate	Entity Name		X

Curl Example

curl --insecure -X PUT -u restuser:secret "https://localhost:7443/customerid-rest/services/delegations/7777777-7XXXXXXXXXXXXXXXXXXXX?delegate=7777777-7/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
 </idlist>

MOD017 Remove Mandate Delegation

Description

Remove a mandate delegation.

Target Type

Entity

Request URL

Request URL defines the mandate.

Example

https://HOSTNAME/customerid-rest/services/delegations/MANDATENAME

Request Method

DELETE

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Default	Description
delegate	Entity Name				If string does not exist then removes the role delegation from all users

Curl Example

curl --insecure -X DELETE -u restuser:secret "https://localhost:7443/customerid-rest/services/delegations/7777777-7XXXXXXXXXXXXXXXXXXXX"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
 </idlist>

MOD018 Delegate Mandate Role

Description

Delegate a mandate role to a user.

Please note: Singular Mandate Role delagations are not supported by conventional SSO authentication flow, but they must be separately resolved by a backchannel query to CustomerID REST API.

Target Type

Entity

Request URL

Request URL defines the mandate to be delegated.

Example

https://HOSTNAME/customerid-rest/services/roledelegations/MANDATENAME

Request Method

PUT

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Default	Description
role	Entity Name		X
delegate	Entity Name		X

Curl Example

curl --insecure -X PUT -u restuser:secret "https://localhost:7443/customerid-rest/services/roledelegations/7777777-7XXXXXXXXXXXXXXXXXXXX?delegate=7777777-7/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&role=1234567-8/TestRole"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
 </idlist>

MOD019 Remove Mandate Role Delegation

Description

Remove a mandate role delegation.

Target Type

Entity

Request URL

Request URL defines the mandate.

Example

https://HOSTNAME/customerid-rest/services/roledelegations/MANDATENAME

Request Method

DELETE

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Default	Description
role	Entity Name		X
delegate	Entity Name				If empty string then removes the role delegation from all users

Curl Example

curl --insecure -X DELETE -u restuser:secret "https://localhost:7443/customerid-rest/services/roledelegations/7777777-7XXXXXXXXXXXXXXXXXXXX?role=1234567-8/TestRole"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
 </idlist>

MOD020 Remove Mandate

Description

Remove the mandate.

Target Type

Entity

Request URL

Request URL defines the mandate to be removed.

Example

https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME

Request Method

DELETE

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X DELETE -u restuser:secret "https://localhost:7443/customerid-rest/services/mandate/7777777-7XXXXXXXXXXXXXXXXXXXX"

Response Document

<?xml version="1.0"
 encoding="UTF-8"?>
 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
 </idlist>

MOD021 Create Mandate Template

Description

Create a new mandate template.

Target Type

Collection

Request URL

Request URL defines the constant mandate collection.

Example

https://HOSTNAME/customerid-rest/services/mandatetemplates/

Request Method

POST

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Description
mandaterType	ORGTO PERTO		X	Defines the type of the mandater.
mandater	Entity Name		X
roles	List of role entity names	X	X	At least one role has to be defined.
name	String			If not defined the name will be generated by the system.

Curl Examples

curl --insecure -X POST -u restuser:secret "https://localhost:7443/customerid-rest/services/mandatetemplates/?mandaterType=ORGTO&roles=6666666-6/TestRole&mandater=6666666-6&name=TestTemplate" 
curl --insecure -X POST -u restuser:secret "https://localhost:7443/customerid-rest/services/mandatetemplates/?mandaterType=PERTO&roles=6666666-6/TestRole&mandater=5555555-5/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&name=TestTemplate"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME</id>
 </idlist>

MOD022 Update Mandate Template

Description

Update the mandate template.

Target Type

Entity

Request URL

Request URL defines the mandate to be updated.

Example

https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME

Request Method

PUT

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Default	Description
roles	List of role entity names	X			If the parameter is left out of the REST call, then no changes will be made to the mandate template role set. If you want to remove all roles from the mandate template then include this parameter but leave it empty.
name	String

Curl Example

curl --insecure -X PUT -u restuser:secret "https://localhost:7443/customerid-rest/services/mandatetemplate/TestTemplate?name=TestTemplate2"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME</id>
 </idlist>

MOD023 Assign Mandate Template

Description

Assign the mandate template to a mandatee.

Target Type

Entity

Request URL

Request URL defines the mandate to be assigned.

Example

https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME

Request Method

POST

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Default	Description
mandateeType	TOORG TOPER		X
mandatee	Entity Name		X

Curl Example

curl --insecure -X POST -u restuser:secret "https://localhost:7443/customerid-rest/services/mandatetemplate/TestTemplate2?mandatee=6666666-6&mandateeType=TOORG"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME</id>
 </idlist>

MOD024 Remove Mandate Template

Description

Remove the mandate template.

Target Type

Entity

Request URL

Request URL defines the mandate to be removed.

Example

https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME

Request Method

DELETE

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X DELETE -u restuser:secret "https://localhost:7443/customerid-rest/services/mandatetemplate/TestTemplate2"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME</id>
 </idlist>

MOD025 Create Role Invitation

Description

Creates a new role invitation with one role for either an existing user or for a pending user.

Target Type

Collection

Request URL

Request URL defines the collection where the role invitation is to be created.

Example

https://HOSTNAME/customerid-rest/services/roleinvitations/

Request Method

POST

Request URL Parameters

Name	Accepted Values	Mandatory	Description
user	User ID	X	The user ID of the user who the role is going to be assigned for.
role	Entity Name	X	The role that is going to be assigned to the user.
message	String		The message that should be added to emails related to this role invitation.

Curl Example

curl --insecure -X POST -u restuser:secret "https://localhost:7443/customerid-rest/services/roleinvitations/?user=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&role=6666666-6/TestRole"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/roleinvitation/ROLEINVITATIONID</id>
 </idlist>

Or when roleinvite.receiver.approval = false

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <idlist>
 <id>null</id>
 </idlist>

MOD026 Create Pending User

Description

Creates a new pending user and sends an email to the user with a link to a registration.

Target Type

Collection

Request URL

Request URL defines the collection where the pending user is to be created.

Example

https://HOSTNAME/customerid-rest/services/pendingusers/

Request Method

POST

Request URL Parameters

Name	Accepted Values	Multivalued	Mandatory	Description
registration	String		X	The name of the registration that is used when the user registers to the system.
email	String		X	Email-address
login	String			User login value
firstname	String			First name of the user.
surname	String			Surname of the user.
mobile	String			Mobile phone number.
ssn	String			Social Security Number (henkilötunnus).
userpassword	String			User password.
locale	String			Locale definition. It is used when selecting the right language for email notifications.
"custom attribute"	String	X		User's custom attribute and a value (multiple values are separated with comma). For example, age=45

Curl Example

curl --insecure -X POST -u restuser:secret "https://localhost:7443/customerid-rest/services/pendingusers/?registration=consumer&email=leena.laine@example.org"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/pendinguser/USERID</id>
 </idlist>

Request Operations

REQ007b List Mandates

Description

List all mandates.

Target Type

Collection

Request URL

https://HOSTNAME/customerid-rest/services/mandates/

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/mandates/"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME1</id>
  <id>https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME2</id>
 </idlist>

REQ008b Query Mandate

Description

Query information about the specified mandate.

Target Type

Entity

Request URL

Request URL defines the queried mandate.

Example

https://HOSTNAME/customerid-rest/services/mandate/MANDATENAME

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/mandate/7777777-7XXXXXXXXXXXXXXXXXXXX"

Response Document

 <mandate>
  <id>https://HOSTNAME/customerid-rest/services/mandate/testmandate</id>
  <name>Test Mandate</name>
  <type>OrgToPer</type>
  <mandater>https://HOSTNAME/eidm2/services/org1/</mandater>
  <mandatee>https://HOSTNAME/eidm2/services/org1/org2/TestUser</mandatee>
  <roles>
   <role>
    <id>https://HOSTNAME/eidm2/services/org1/org2/OrganizationMainUser</id>
   </role>
   <role>
    <id>https://HOSTNAME/eidm2/services/role/org1/org2/OrganizationUser</id>
   </role>
  </roles>
  <delegations>
   <userid>https://HOSTNAME/eidm2/services/user/org1/org2/TestUser2</userid>
  </delegations>
 </mandate>

REQ009 List Mandate Templates

Description

List all mandate templates.

Target Type

Collection

Request URL

https://HOSTNAME/customerid-rest/services/mandatetemplates/

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/mandatetemplates/"

Response Document

 <idlist>
  <id>https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME1</id>
  <id>https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME2</id>
 </idlist>

REQ010 Query Mandate Template

Description

Query information about the specified mandate template.

Target Type

Entity

Request URL

Request URL defines the queried mandate template.

Example

https://HOSTNAME/customerid-rest/services/mandatetemplate/MANDATETEMPLATENAME

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/mandatetemplate/XXXXXXXXXXXXXXXXXXXX"

Response Document

 <mandatetemplate>
  <id>https://HOSTNAME/customerid-rest/services/mandatetemplates/mandatetemplate1</id>
 <name>Test Mandate Template</name>
 <type>OrgTo</type>
 <mandater>https://HOSTNAME/eidm2/services/org1/</mandater>
 <roles>
   <role>
    <id>https://HOSTNAME/eidm2/services/org1/org2/OrganizationMainUser</id>
   </role>
   <role>
    <id>https://HOSTNAME/eidm2/services/org1/org2/OrganizationUser</id>
   </role>
  </roles>
 </mandatetemplate>

REQ011b List Role Invitations (for organization)

Description

List role invitations in an organization.

Target Type

Collection

Request URL

Request URL defines the organization from where role invitations are to be listed.

Examples

https://HOSTNAME/customerid-rest/services/roleinvitations/
https://HOSTNAME/customerid-rest/services/roleinvitations/ORGANIZATION/
https://HOSTNAME/cusotmerid-rest/services/roleinvitations/ORGANIZATION/SUBORG/

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/roleinvitations/6666666-6/"

Response Document

 <idlist>
  <Id>https://HOSTNAME/customerid-rest/services/roleinvitation/ROLEINVITATIONID1</Id>
  <Id>https://HOSTNAME/customerid-rest/services/roleinvitation/ROLEINVITATIONID2</Id>
  <Id>https://HOSTNAME/customerid-rest/services/roleinvitation/ROLEINVITATIONID3</Id>
 </idlist>

REQ012 Query Role Invitation

Description

Query information about the specified role invitation.

Target Type

Entity

Request URL

Request URL defines the queried role invitation.

Example

https://HOSTNAME/customerid-rest/services/roleinvitation/ROLEINVITATIONID1

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/roleinvitation/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

Response Document

 <roleinvitation>
  <roles>
   <role><Id>https://HOSTNAME/customerid-rest/services/role/ROLEID1</Id></Role>
  </Roles>
  <user><Id>https://HOSTNAME/customerid-rest/services/user/YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY</Id></user>
 </roleinvitation>

REQ013 List Registrations (previously was List Pending Users)

Description

List all registrations.

Target Type

Collection

Request URL

Request URL defines that we want to list all registrations (pending users).

Example

https://HOSTNAME/customerid-rest/services/pendingusers

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/pendingusers"

Response Document

 <idlist>
  <Id>https://HOSTNAME/customerid-rest/services/pendinguser/USERID1</Id>
  <Id>https://HOSTNAME/customerid-rest/services/pendinguser/USERID2</Id>
  <Id>https://HOSTNAME/customerid-rest/services/pendinguser/USERID3</Id>
 </idlist>

REQ014 List Registration (previously was List Pending User)

Description

Query information about the specified registration (pending user) based on the workflow handle (REGISTRATIONID) of the registration (pending user).

Target Type

Collection

Request URL

Request URL defines the workflow handle of the queried registration (pending user).

Examples

https://HOSTNAME/customerid-rest/services/pendingusers/
https://HOSTNAME/customerid-rest/services/pendingusers/REGISTRATIONID1

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/pendingusers/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

Response Document

 <idlist>
  <Id>https://HOSTNAME/customerid-rest/services/pendinguser/YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY</Id>
 </idlist>

REQ015 Query Registration (previously was Query Pending User)

Description

Query information about the specified registration (pending user) based on the user ID of the pending user related to the registration.

Target Type

Entity

Request URL

Request URL defines the user id of the pending user related to the queried registration.

Example

https://HOSTNAME/customerid-rest/services/pendinguser/USERID1

Request Method

GET

Request URL Parameters

No request specific request URL parameters.

Curl Example

curl --insecure -X GET -u restuser:secret "https://localhost:7443/customerid-rest/services/pendinguser/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"

Response Document

 <pendingUser>
  <userid>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</userid>
  <pendinguserid>YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYY</pendinguserid>
  <registrationwf>person</registrationwf>
 </pendingUser>

Browser not supported