Policy Center REST API

Policy Center Solution (PCS) REST API Overview

Starting point and URLs collection

REST API base URL: https:///p/api/services/restful/


Example: https://demo.igpolicy.net/p/api/services/restful/3.1

REST API objects URLs collection: https:///p/api/services/restful///
Example: https://demo.igpolicy.net/p/api/services/restful/3.1/recordclass/fe68b798-04cf-4202-99b3-2352e47022d7

  • Policy Center client domain name (often something like company.igpolicy.net)
  • is a current version of Policy Center product, e.g. 3.1;
  • is an Policy Center retention object type, e.g. recordclass;
  • is an unique object identifier within Policy Center;

Global Parameters

The following parameters are available for every API:

  • fetch - can take true/ false values (default is false), indicates show only object reference or shows full list of object fields with values in output accordingly;
  • start - can take any positive integer value, indicates the position from what objects will be displayed in output;
  • pagesize - can take value from 1 to 100 (default is 20), indicates the amount of objects in result output;
  • responseFormat - API response format can be either XML or JSON
  • withEmpty – Note: this parameter can be used only when &responseFormat=json. By default empty metadata fields will not be included into API response. But if this parameter is set to 1 or ‘true’ – empty fields will not be stripped out from API response (Example https://pcs-api-hpe.igpolicy.net/p/api/services/restful/3.1/recordclass/94fe26b7-b584-ca35-cdb1-6198a965c282?responseFormat=json&withEmpty=true)

Differences between "reference" objects and "full" objects

Many APIs return a "reference" object instead of returning a "full" object. References are the same type as a regular object, but the only piece of data filled out is the "ref" attribute in XML.

For instance:

You can use the ref URL to get full information about the object.

Responses

Object read requests will return an XML or JSON document representing that object. In an XML response, all object fields will be included in the object output, even empty fields. With a JSON response, only non-empty fields will be included in the response, unless the “withEmpty” parameter is set.

If there is an error retrieving an object, the return element “Status” will indicate this with value "Error," and “Message” element will describe the error(s). Warnings can effectively be ignored, but the presence of errors indicates that the requested operation has failed.

RecordClass

A group of related records that are used and arranged in accordance with a filing system. These records are normally kept together because they relate to a particular subject or function, result from the same activity, have a particular form, or have some relationship arising from their creation, receipt, use, or disposition. They can be evaluated as a unit for retention scheduling purposes.

REST URLs Collection

Operation HTTP Method Encoding URL
List GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/recordclass
Read GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/recordclass/

Parameters:

Name Description Required
mappings To return all object mappings, you should set mappings=true. The API will return all object mapping references, unless fetch=true is set, in which case you will get object mapping data instead of just references. All mappings will be sorted by mapped object type.  
guid RecordClass object id  

Examples:

REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/recordclass
RESPONSE:


Success
Results from 1 to 20
1
20
593
1474571044




















REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/recordclass/fbf31bf3-fd6c-aabd-4030-fede030e9b2b
RESPONSE:


1474571044
fbf31bf3-fd6c-aabd-4030-fede030e9b2b
CR
Create Compliant Products


2

1
2
3

Enabled











2011-10-27


REST URL: https://demo.igpolicy.net.com/p/api/services/restful/3.1/recordclass?start=20&pagesize=2&fetch=false
RESPONSE:


Success
Results from 20 to 21
20
2
593
1474571044


REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/recordclass?fetch=true&mappings=true&start=5&pagesize=1
RESPONSE:


Success
Results from 5 to 5
5
1
593
1474571044

0d90882b-b75a-ec34-01af-d1843d4925be
CR-PRO
Product Management
Activities involved in creating compliant products and p/api/services including necessary approvals thereof.

3

FTS
STS
TTS

Enabled











2011-10-27



c8848026-e6a2-9b65-b9bd-7d44911c1299
00018401






de6cb1a5-5bcc-9ab5-f2fc-df6510082c65
00000968
BAE-001-00000968







DataOwner

REST URLs Collection

Operation HTTP Method Encoding URL
List GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/dataowner
Read GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/dataowner/

Parameters:

Name Description Required
guid DataOwner object id  

Examples:

REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/dataowner
RESPONSE:


Success
Results from 1 to 20
1
20
33
1474571044




















REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/dataowner/cfcf2086-6419-0c7c-90d5-3a75cb058017
RESPONSE:


1474571044
cfcf2086-6419-0c7c-90d5-3a75cb058017
001

0
Corportate HQ
Organizational Unit
Group

Enabled
2012-11-27

DataSource

REST URLs Collection

Operation HTTP Method Encoding URL
List GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/datasource
Read GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/datasource/

Parameters:

Name Description Required
guid DataSource object id  

Examples:

REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/datasource
RESPONSE:


Success
Results from 1 to 5
1
20
5
1474571044





REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/datasource/e66bd933-68f6-da32-57c8-a6041f9a51ae
RESPONSE:


e66bd933-68f6-da32-57c8-a6041f9a51ae
1474571044
00001
Business Analysis Database
Business Analysis Database Description

Online Repositories
Backup


Global



Enabled
2012-11-27

Hold
Online
2012-11-27
2012-11-27

Citations

A record within the Citation Library that represents a legal or business obligation to retain a record. There are several types of citations.

  • GRS Citation: Digital copies of citations delivered from the GRS database. Only a limited number of fields can be edited on a GRS citation.
  • Local Citation: Citations created locally within PCS and not part of a GRS subscription.

REST URLs Collection

Operation HTTP Method Encoding URL
List GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/citation
Read GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/citation/

Parameters:

Name Description Required
guid Citation object id  

Examples:

REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/legalsource
RESPONSE:


Success
Results from 1 to 20
1
20
5125
1474571044




















REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/citation/ed273e79-55d2-cd3d-ba2b-9c26feaf1582
RESPONSE:


1474571044
ed273e79-55d2-cd3d-ba2b-9c26feaf1582
GLOBAL-ALL-0036
Global
AA_1


n.a.

Retention is not regulated per Group Taxonomy but by legal requirement and policy applicable in Business Division and Location.
Enabled


Active


Legacy




n.a.
n.a

years
n.a.

years
Undefined

years

N.A.







manually added

REST URL: https://demo.igpolicy.net.com/p/api/services/restful/3.1/citation?start=17&pagesize=3&fetch=false
RESPONSE:


Success
Results from 17 to 19
17
3
5125
1474571044



Rule

REST URLs Collection

Operation HTTP Method Encoding URL
List GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/rule
Read GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/rule/

Parameters:

Name Description Required
mappings To get information about all object mappings you should include mappings=true argument into your request string. So all object mappings will be included as a reference to mapped object. All mappings will be also sorted by mapped object type.  
guid Rule object id  

Examples:

REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/rule
RESPONSE:


Success
Results from 1 to 20
1
20
365
1474571044




















REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/rule/fb64420e-848d-2957-6bc4-9f1a216ca4e6
RESPONSE:


1474571044
fb64420e-848d-2957-6bc4-9f1a216ca4e6
rr-AT-ALL-0001
AT
AT End of employment 30 year(s)

End of employment
30 year(s)

years



Enabled

UBS Legacy

REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/rule?start=1&pagesize=2&fetch=true
RESPONSE:


Success
Results from 1 to 2
1
2
365
1474571044

fb64420e-848d-2957-6bc4-9f1a216ca4e6
AT-ALL-0001
AT
AT End of employment 30 year(s)

End of employment
30 year(s)

years



Enabled

Fontis Legacy



8e2ce550-a639-f5f5-7bf9-ecac2eb5095c
AT-ALL-0002
AT
AT End of year of creation/ receipt 10 year(s)

End of year of creation/ receipt
10 year(s)

years



Enabled

Fontis Legacy


REST URL: https://demo.igpolicy.net/p/api/services/restful/3.1/rule/fbdc0ff5-ad7f-419b-a23d-5703653e62b3?mappings=true
RESPONSE:


fbdc0ff5-ad7f-419b-a23d-5703653e62b3
1474571044
rr-AT-ALL-0004
AT
Rule
Send to historical Archiv
Control check
5 years
5
years
10 years
7 years
Delete it before the read
Enabled
2012-12-18
Big boss




Changes

The changes API is intended to provide information about changes made between published versions of the API snapshot set in Policy Center.

Parameters:

Name Description Required
type

String determines the type of change you want the API to return. Possible values are update, delete, create, and replace.

Update shows modified items, delete shows items that were deleted, create shows items created, and replace shows items where a rule tied to a specific jurisdiction and mapped to a record class is replaced by a mapping to a new rule in the same jurisdiction

NO
SnapshotTimeStamp Unix timestamp. API will use this parameter only to compare with currently published snapshot. If sent SnapshotTimeStamp is equal to currently published SnapshotTimeStamp API will return ZERO changes. Otherwise—and it doesn’t matter how much snapshots have been published since SnapshotTimeStamp—API will return only list of most recent changes (changes which has happen during last API snapshot publishing). YES

Example Request:

https://demo.igpolicy.net/p/api/services/restful/3.1/changes

Example Response:


Success
Results from 1 to 1
1
20
4
1474417625







Example Request:

https://demo.igpolicy.net/p/api/services/restful/3.1/changes?fetch=true

Example Response:


Success
Results from 1 to 1
1
20
4
1474417625


c95671c2-77bc-5ac4-8513-87da5d94f00d
AD-ALL-0002
AD
Test Rule

The date the record is created
6 Years
6
years



Enabled





Disabled





Example Request:

https://demo.igpolicy.net/p/api/services/restful/3.1/changes?type=replace

Example Response:


Success
Results from 1 to 1
1
20
1
1474417625




Mappings

The mappings API is intended to provide information about mapping objects—that is, the object that ties together a record class and a retention rule in Policy Center.

Mappings between Record Class and Rule have additional tag based on Record Class code and Mapping code (Box code).

example:

AA-01-001 - Record Class code
12345678 - Mapping code (Box code)
AA-01-001-12345678 - Classification Code

REST URLs Collection

Operation HTTP Method Encoding URL
List GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/
Read GET XML https://demo.igpolicy.net/p/api/services/restful/3.1/ /

Parameters:

Name Description Required
guid Mapping object id  
mapping_type Mapping object type, e.g. “maprctorule”  

Example Request:

https://demo.igpolicy.net/p/api/services/restful/3.1/maprctorule

Example Response:


Success
Results from 1 to 20
1
20
794
1474571044




















Example Request for mapping between Record Class and Rule:

https://demo.igpolicy.net/p/api/services/restful/3.1/maprctorule/1e1c4f60-264f-3c06-6e95-7f5ab7ecd41c

Example Response:


1474417625
1e1c4f60-264f-3c06-6e95-7f5ab7ecd41c
00000930
COE-004-00000930



Example Request for mapping between Record Class and Source:

https://demo.igpolicy.net/p/api/services/restful/3.1/maprctosource/f27e49a6-45b7-99de-4c2c-2d497cea624d

Example Response:


1474041256
f27e49a6-45b7-99de-4c2c-2d497cea624d
00000008



1

Run the Browser Test