Coruson API

<back to all web services

GetLists

Coruson Custom Lists

Requires Authentication
The following routes are available for this service:
GET/api/listsQuery for Coruson Lists
GetLists Parameters:
NameParameterData TypeRequiredDescription
ListIdqueryGuidNoFilter by ListId.
NamequerystringNoFilter by the name of the List.
DescriptionquerystringNoFilter by the description of the List.
IsSystemqueryBooleanFilterYesFilter Lists depending on if they were created by Coruson or by a user.

Allowable Values

  • All
  • True
  • False
IsActivequeryBooleanFilterYesFilter by the List's status.

Allowable Values

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

Allowable Values

  • Default
  • Name
OrderByDescqueryListOrderYesProperty to order by in Descending order.

Allowable Values

  • Default
  • Name
ThenByqueryListOrderYesSecond 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
ThenByDescqueryListOrderYesSecond 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
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
GetListsResponse Parameters:
NameParameterData TypeRequiredDescription
ListsformList<List>No
GetResponseBase Parameters:
NameParameterData TypeRequiredDescription
TotalResultsformintNo
SkipformintNo
TakeformintNo
LinksformList<Link>No
ResponseBase Parameters:
NameParameterData TypeRequiredDescription
StatusDescriptionformstringNo
ResponseStatusformResponseStatusNo
Link Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
RequestUrlformstringNo
MethodformstringNo
List Parameters:
NameParameterData TypeRequiredDescription
ListIdformGuidNo
NameformstringNo
DescriptionformstringNo
IsSystemformboolNo
IsActiveformboolNo
ListItemsformList<ListItem>No
ListItem Parameters:
NameParameterData TypeRequiredDescription
ListItemIdformGuidNo
NameformstringNo
DescriptionformstringNo
CodeformstringNo
ParentIdformGuid?No
ParentNameformstringNo
FullHierarchyformstringNo
ListIdformGuidNo
ListformstringNo
IsActiveformboolNo

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

HTTP + CSV

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

                    POST /csv/reply/GetLists HTTP/1.1 
Host: platform.gaelenlighten.com 
Content-Type: text/csv
Content-Length: length

{"ListId":"00000000-0000-0000-0000-000000000000","Skip":0,"Version":0,"Name":"String","Take":0,"Description":"String","IsSystem":"All","IsActive":"All","OrderBy":"Default","OrderByDesc":"Default","ThenBy":"Default","ThenByDesc":"Default"}
                    
HTTP/1.1 200 OK
Content-Type: text/csv
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"}],"Lists":[{"Name":"String","Description":"String","IsSystem":false,"IsActive":false,"ListItems":[{"Name":"String","Description":"String","Code":"String","ParentId":"00000000-0000-0000-0000-000000000000","ParentName":"String","FullHierarchy":"String","List":"String","IsActive":false}]}]}