Coruson API

<back to all web services

GetClauses

Coruson Standards

Requires Authentication
The following routes are available for this service:
GET/api/standards/clausesQuery for Coruson Standard Clauses
GetClauses Parameters:
NameParameterData TypeRequiredDescription
ClauseIdqueryGuidNoFilter by the ClauseId.
NamequerystringNoFilter by the name of the Clause.
DescriptionquerystringNoFilter by the description of the Clause.
CodequerystringNoFilter by the code of the Clause.
ParentIdqueryGuidNoFilter by the parent Clause Id of the Clause.
ParentNamequerystringNoFilter by the name of of the parent the Clause(s) belong to.
FullHierarchyquerystringNoFilter clauses by providing their full hierarchy. Format should be: {Root}\\\\..\\\\..\\\\{Parent}.
IsAppliedqueryBooleanFilterYesGet all Clauses based on their 'Applied' status. By default Clauses of both Applied states will be returned.

Allowable Values

  • All
  • True
  • False
AppliedDetailsquerystringNoFilter by the applied details of the Clause.
StandardIdqueryGuidNoFilter by the Id of the Standard the Clause(s) belongs to.
StandardquerystringNoFilter by the name of the Standard the Clause(s) belongs to.
IsActivequeryBooleanFilterYesInclude all archived Standard Clauses. By default they will be filtered out.

Allowable Values

  • All
  • True
  • False
OrderByqueryClauseOrderYesProperty to order by in Ascending order. Default is 'Name'.

Allowable Values

  • Default
  • Name
  • Standard
  • ParentName
  • AppliedStatus
OrderByDescqueryClauseOrderYesProperty to order by in Descending order.

Allowable Values

  • Default
  • Name
  • Standard
  • ParentName
  • AppliedStatus
ThenByqueryClauseOrderYesSecond Property to order by in Ascending order. NOTE: If this value is the same as either the OrderBy or OrderByDesc values, then it will be ignored.

Allowable Values

  • Default
  • Name
  • Standard
  • ParentName
  • AppliedStatus
ThenByDescqueryClauseOrderYesSecond Property to order by in Descending order. NOTE: If this value is the same as either the OrderBy or OrderByDesc values, then it will be ignored.

Allowable Values

  • Default
  • Name
  • Standard
  • ParentName
  • AppliedStatus
PagingRequestBase<T> Parameters:
NameParameterData TypeRequiredDescription
SkipformIntegerNoNumber of items to skip before returning results. Minimum suitable value is 0 and is also the default value.
TakeformIntegerNoNumber of items to return per page. Must be a number in the range 1-100. Default value is 100.
OrderByformEnumNoOrder By
OrderByDescformEnumNoOrder By Descending
ThenByformEnumNoThen By
ThenByDescformEnumNoThen By Descending
RequestBase Parameters:
NameParameterData TypeRequiredDescription
VersionformintNo
GetClausesResponse Parameters:
NameParameterData TypeRequiredDescription
ClausesformList<Clause>No
GetResponseBase Parameters:
NameParameterData TypeRequiredDescription
TotalResultsformintNo
SkipformintNo
TakeformintNo
LinksformList<Link>No
ResponseBase Parameters:
NameParameterData TypeRequiredDescription
StatusDescriptionformstringNo
ResponseStatusformResponseStatusNo
Link Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
RequestUrlformstringNo
MethodformstringNo
Clause Parameters:
NameParameterData TypeRequiredDescription
ClauseIdformGuidNo
NameformstringNo
DescriptionformstringNo
CodeformstringNo
ParentIdformGuid?No
ParentNameformstringNo
FullHierarchyformstringNo
IsAppliedformboolNo
AppliedDetailsformstringNo
StandardIdformGuidNo
StandardformstringNo
IsActiveformboolNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

                    POST /json/reply/GetClauses HTTP/1.1 
Host: platform.gaelenlighten.com 
Content-Type: application/json
Content-Length: length

{"ClauseId":"00000000-0000-0000-0000-000000000000","Skip":0,"Version":0,"Name":"String","Take":0,"Description":"String","Code":"String","ParentId":"00000000-0000-0000-0000-000000000000","ParentName":"String","FullHierarchy":"String","IsApplied":"All","AppliedDetails":"String","StandardId":"00000000-0000-0000-0000-000000000000","Standard":"String","IsActive":"All","OrderBy":"Default","OrderByDesc":"Default","ThenBy":"Default","ThenByDesc":"Default"}
                    
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"TotalResults":0,"StatusDescription":"String","Skip":0,"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}},"Take":0,"Links":[{"Name":"String","RequestUrl":"String","Method":"String"}],"Clauses":[{"Name":"String","Description":"String","Code":"String","ParentId":"00000000-0000-0000-0000-000000000000","ParentName":"String","FullHierarchy":"String","IsApplied":false,"AppliedDetails":"String","Standard":"String","IsActive":false}]}