Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Anchor
Sites
Sites
Sites

Returns a list of all sites configured in Crittah.

...

 
FieldValue typeMandatoryDescriptionExample
IDSitestring 
Unique identifier of the site.7090fad1-c4da-4488-9ceb-55ee9847edcc
Sitestring 
Name of siteMelbourne
Descriptionstring
description of siteThis is a description of the site

...

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfSiteObj xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <SiteObj>
      <IDSite>d8eca573-9815-4bba-8ad5-235edde649ed</IDSite>
      <Site>ACT</Site>
      <Description>Canberra</Description>
   </SiteObj>
   <SiteObj>
      <IDSite>9b4d7590-1a69-47f9-bd37-8f0ab0655c32</IDSite>
      <Site>ADL</Site>
      <Description>Adelaide</Description>
   </SiteObj>
   <SiteObj>
      <IDSite>c374d0a9-b075-4084-bb3e-1d4d8d0610ab</IDSite>
      <Site>GC</Site>
      <Description>Gold Coast</Description>
   </SiteObj>
</ArrayOfSiteObj>

...

Anchor
LeadSourceTypes
LeadSourceTypes
Lead Sources

Returns a list of all customer types lead sources configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/types/customerleadsources
GETReturns data defining customer types

...

FieldValue typeMandatoryDescriptionExample
IDTypestring 
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
TypeNamestring 
Name of typeVIPPhone
Descriptionstring 
description of typeVery important customerLead generated by phone.

Get customer types

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/types/customerleadsources

JSON Rsponse:

Code Block
[ 
  {
    "IDType": "4d819963-731c-41fd-9378-fd7a10199b78",
    "TypeName": "AssociatesPhone",
    "Description": "AssociatesLead generated by phone"
  },
  {
    "IDType": "81c3c93e-fed4-4491-81d2-b9c8e6de5fac",
    "TypeName": "Bulk deliveryWeb",
    "Description": "BulkWeb deliveryLead"
  },
  {
    "IDType": "101f4545-d10c-4bd5-a8b5-325258968649",
    "TypeName": "GeneralReferral",
    "Description": "General CustomerReferral from existing customer"
  },
  {
    "IDType": "eac9f42e-8fd9-4b03-97fe-fd870c75aab1",
    "TypeName": "Receiver",
    "Description": "Receiver"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfTypeCrittah xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <TypeCrittah>
      <IDType>81c3c93e-fed4-4491-81d2-b9c8e6de5fac</IDType>
      <TypeName>Bulk delivery<<TypeName>Web</TypeName>
      <Description>Bulk<Description>Web delivery<Lead</Description>
   </TypeCrittah>
   <TypeCrittah>
      <IDType>101f4545-d10c-4bd5-a8b5-325258968649</IDType>
      <TypeName>General<<TypeName>Referral</TypeName>
      <Description>General<<Description>Referral from existing customer</Description>
   </TypeCrittah>

  <TypeCrittah>
      <IDType>eac9f42e-8fd9-4b03-97fe-fd870c75aab1</IDType>
      <TypeName>Receiver</TypeName>
      <Description>Receiver</Description>
   </TypeCrittah>
</ArrayOfTypeCrittah>

...

</ArrayOfTypeCrittah>

Anchor
CustomerTypes
CustomerTypes
Customer Types

Returns a list of all contact customer types configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/types/contactcustomer
GETReturns data defining contact customer types

Data fields

FieldValue typeMandatoryDescriptionExample
IDTypestring 
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
TypeNamestring 
Name of typeVIP
Descriptionstring 
description of typeVery important customer

Get

...

customer types

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/types/contactcustomer

JSON Rsponse:

Code Block
[ 
  {
    "IDType": "7e56478b4d819963-70ab731c-4b8c41fd-aa0d9378-c4729f98ccb2fd7a10199b78",
    "TypeName": "AccountsAssociates",
    "Description": "AccountsAssociates"
  },
  {
    "IDType": "2e55483881c3c93e-1291fed4-46054491-8e6481d2-dc97104a216eb9c8e6de5fac",
    "TypeName": "CEOBulk delivery",
    "Description": "CEOBulk delivery"
  },
  {
    "IDType": "cbc1ad16101f4545-01cdd10c-424a4bd5-900ca8b5-45ccc8f630c3325258968649",
    "TypeName": "General",
    "Description": "General Customer"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8",
  {
    "IDType": "eac9f42e-8fd9-4b03-97fe-fd870c75aab1",
    "TypeName": "Receiver",
    "Description": "Receiver"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfTypeCrittah xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <TypeCrittah>
      <IDType>7e56478b<IDType>81c3c93e-70abfed4-4b8c4491-aa0d81d2-c4729f98ccb2<b9c8e6de5fac</IDType>
      <TypeName>Accounts<<TypeName>Bulk delivery</TypeName>
      <Description>Accounts<<Description>Bulk delivery</Description>
   </TypeCrittah>
   <TypeCrittah>
      <IDType>2e554838<IDType>101f4545-1291d10c-46054bd5-8e64a8b5-dc97104a216e<325258968649</IDType>
      <TypeName>CEO<<TypeName>General</TypeName>
      <Description>CEO<<Description>General</Description>
   </TypeCrittah>
   <TypeCrittah>
      <IDType>cbc1ad16<IDType>eac9f42e-01cd8fd9-424a4b03-900c97fe-45ccc8f630c3<fd870c75aab1</IDType>
      <TypeName>General<<TypeName>Receiver</TypeName>
      <Description>General<<Description>Receiver</Description>
   </TypeCrittah>
</ArrayOfTypeCrittah>

...

Anchor
ContactTypes
ContactTypes
Contact Types

Returns a list of all job contact types configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/types/jobcontact
GETReturns data defining job contact types

Data fields

FieldValue typeMandatoryDescriptionExample
IDJobTypeIDTypestring 
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
IDWorkFlowTypeNamestring ID of the workflow used for the specific job type.jdk0fad1-c4da-4488-ereb-55ee9847edcc
Namestring Name of jobAdHoc
Descrstring Description of jobAdHoc job used for last minute work
Colourstring HEX colour used to colour code the job#hhjkgf

...


Name of typeVIP
Descriptionstring
description of typeVery important customer

Get contact types

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/types/jobcontact

JSON Rsponse:

Code Block
[
  {
    "IDJobTypeIDType": "49b86bf87e56478b-a61070ab-45944b8c-baeaaa0d-30b76c21974dc4729f98ccb2",
    "IDWorkFlowTypeName": "7381887c-3fd5-49b0-896c-06b692efbb59Accounts",
    "NameDescription": "AdHocAccounts"
  },
  {
    "DescrIDType": "A non scheduled job."2e554838-1291-4605-8e64-dc97104a216e",
    "TypeName": "CEO",
    "ColourDescription": "#f5c9cbCEO"
  },
  {
    "IDJobTypeIDType": "023850a1cbc1ad16-ac5601cd-47f5424a-a90a900c-8ec48c34630545ccc8f630c3",
    "IDWorkFlowTypeName": "7381887c-3fd5-49b0-896c-06b692efbb59General",
    "NameDescription": "Drop OffGeneral",
  }
 "Descr": "Scheduled and non scheduled delivery items to customer. ",]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfTypeCrittah xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <TypeCrittah>
     "Colour": "#faf59b" <IDType>7e56478b-70ab-4b8c-aa0d-c4729f98ccb2</IDType>
   },   {<TypeName>Accounts</TypeName>
    "IDJobType": "bd176be9-8c1b-4cd3-9b54-5ad51b2de3f4",
 <Description>Accounts</Description>
   "IDWorkFlow": "7381887c-3fd5-49b0-896c-06b692efbb59",</TypeCrittah>
   <TypeCrittah>
 "Name": "Pickup",     "Descr": "A scheduled collection. ",<IDType>2e554838-1291-4605-8e64-dc97104a216e</IDType>
      <TypeName>CEO</TypeName>
     "Colour": "#99CCFF" <Description>CEO</Description>
  } ]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfJobTypeObj xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <JobTypeObj></TypeCrittah>
   <TypeCrittah>
      <IDType>cbc1ad16-01cd-424a-900c-45ccc8f630c3</IDType>
      <TypeName>General</TypeName>
       <IDJobType>49b86bf8-a610-4594-baea-30b76c21974d</IDJobType><Description>General</Description>
      <IDWorkFlow>7381887c-3fd5-49b0-896c-06b692efbb59</IDWorkFlow>
      <Name>AdHoc</Name>
      <Descr>A non scheduled collection.</Descr>
      <Colour>#f5c9cb</Colour>
   </JobTypeObj>
   <JobTypeObj>
      <IDJobType>023850a1-ac56-47f5-a90a-8ec48c346305</IDJobType>
      <IDWorkFlow>7381887c-3fd5-49b0-896c-06b692efbb59</IDWorkFlow>
      <Name>Drop Off</Name>
      <Descr>Scheduled and non scheduled delivery.</Descr>
      <Colour>#faf59b</Colour>
   </JobTypeObj>
   <JobTypeObj>
      <IDJobType>bd176be9-8c1b-4cd3-9b54-5ad51b2de3f4</IDJobType>
      <IDWorkFlow>7381887c-3fd5-49b0-896c-06b692efbb59</IDWorkFlow>
      <Name>Pickup</Name>
      <Descr>A scheduled collection.</Descr>
      <Colour>#99CCFF</Colour>
   </JobTypeObj>
</ArrayOfJobTypeObj>

Note Types

...

</TypeCrittah>
</ArrayOfTypeCrittah>

Anchor
JobTypes
JobTypes
Job Types 

Returns a list of all job types configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/types/job
GETReturns data defining job types

Data fields

FieldValue typeMandatoryDescriptionExample
IDJobTypestring
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
IDWorkFlowstring
ID of the workflow used for the specific job type.jdk0fad1-c4da-4488-ereb-55ee9847edcc
Namestring
Name of jobAdHoc
Descrstring
Description of jobAdHoc job used for last minute work
Colourstring
HEX colour used to colour code the job#hhjkgf

Get job types

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/types/job

JSON Rsponse:

Code Block
[
  {
    "IDJobType": "49b86bf8-a610-4594-baea-30b76c21974d",
    "IDWorkFlow": "7381887c-3fd5-49b0-896c-06b692efbb59",
    "Name": "AdHoc",
    "Descr": "A non scheduled job.",
    "Colour": "#f5c9cb"
  },
  {
    "IDJobType": "023850a1-ac56-47f5-a90a-8ec48c346305",
    "IDWorkFlow": "7381887c-3fd5-49b0-896c-06b692efbb59",
    "Name": "Drop Off",
    "Descr": "Scheduled and non scheduled delivery items to customer. ",
    "Colour": "#faf59b"
  },
  {
    "IDJobType": "bd176be9-8c1b-4cd3-9b54-5ad51b2de3f4",
    "IDWorkFlow": "7381887c-3fd5-49b0-896c-06b692efbb59",
    "Name": "Pickup",
    "Descr": "A scheduled collection. ",
    "Colour": "#99CCFF"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfJobTypeObj xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <JobTypeObj>
      <IDJobType>49b86bf8-a610-4594-baea-30b76c21974d</IDJobType>
      <IDWorkFlow>7381887c-3fd5-49b0-896c-06b692efbb59</IDWorkFlow>
      <Name>AdHoc</Name>
      <Descr>A non scheduled collection.</Descr>
      <Colour>#f5c9cb</Colour>
   </JobTypeObj>
   <JobTypeObj>
      <IDJobType>023850a1-ac56-47f5-a90a-8ec48c346305</IDJobType>
      <IDWorkFlow>7381887c-3fd5-49b0-896c-06b692efbb59</IDWorkFlow>
      <Name>Drop Off</Name>
      <Descr>Scheduled and non scheduled delivery.</Descr>
      <Colour>#faf59b</Colour>
   </JobTypeObj>
   <JobTypeObj>
      <IDJobType>bd176be9-8c1b-4cd3-9b54-5ad51b2de3f4</IDJobType>
      <IDWorkFlow>7381887c-3fd5-49b0-896c-06b692efbb59</IDWorkFlow>
      <Name>Pickup</Name>
      <Descr>A scheduled collection.</Descr>
      <Colour>#99CCFF</Colour>
   </JobTypeObj>
</ArrayOfJobTypeObj>

Anchor
NoteTypes
NoteTypes
Note Types

Returns a list of all note types configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/types/note
GETReturns data defining contact types

Data fields

FieldValue typeMandatoryDescriptionExample
IDTypestring
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
TypeNamestring
Name of typeGeneral
Descriptionstring
description of typeGeneral note type

Get note types

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/types/note

JSON Rsponse:

Code Block
[
  {
    "IDType": "22fcd267-1958-4a27-8e9c-09139ea3f8a8",
    "TypeName": "Delivery",
    "Description": "Delivery Details"
  },
  {
    "IDType": "77d5d244-eb29-4b5b-8b14-87d92b4215ea",
    "TypeName": "General",
    "Description": "General Note"
  },
  {
    "IDType": "2b11efc3-2a43-4c03-92ac-923e77f821a2",
    "TypeName": "Important",
    "Description": "Important Note"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfTypeCrittah xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <TypeCrittah>
      <IDType>22fcd267-1958-4a27-8e9c-09139ea3f8a8</IDType>
      <TypeName>Delivery</TypeName>
      <Description>Delivery Details</Description>
   </TypeCrittah>
   <TypeCrittah>
      <IDType>77d5d244-eb29-4b5b-8b14-87d92b4215ea</IDType>
      <TypeName>General</TypeName>
      <Description>GeneralNote</Description>
   </TypeCrittah>
   <TypeCrittah>
      <IDType>2b11efc3-2a43-4c03-92ac-923e77f821a2</IDType>
      <TypeName>Important</TypeName>
      <Description>Important Note</Description>
   </TypeCrittah>
</ArrayOfTypeCrittah>

Anchor
ClosedReasons
ClosedReasons
Closed Reasons

Returns a list of all closed reasons configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/closedreasons
GETReturns data defining contact types

Data fields

FieldValue typeMandatoryDescriptionExample
IDTypestring
Unique identifier of the closed reason7090fad1-c4da-4488-9ceb-55ee9847edcc
TypeNamestring
Name of closed reasonsVIP
Descriptionstring
description of closed reasonVery important customer

Get closed reasons

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/closedreasons

JSON Rsponse:

Code Block
[
    {
        "IDType": "24501b6f-dbeb-4344-a565-419bd2df26fe",
        "TypeName": "No longer needed",
        "Description": "No longer needed"
    },
 {
        "IDType": "24501b6f-dbeb-4344-a565-419bd2df26fe",
        "TypeName": "customer cancelled",
        "Description": "customer cancelled"
    }
]

Anchor
ContactStatuses
ContactStatuses
Contact Status

Returns a list of all contact statuses configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/typesstatuses/notecontact
GETReturns data defining contact typesstatus

Data fields

 
FieldValue typeMandatoryDescriptionExample
IDTypeIDStatusstring 
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
TypeNameStatusNamestring 
Name of typestatusGeneralActive
Descriptionstring
description of typestatusGeneral note typeAcitve

Get

...

contact status

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/typesstatuses/notecontact

JSON Rsponse:

Code Block
[
  {
    "IDTypeIDStatus": "22fcd267926a4185-19586cb3-4a274a2a-8e9ca8ec-09139ea3f8a81fadc1cf4caa",
    "TypeNameStatusName": "DeliveryActive",
    "Description": "Delivery DetailsActive"
  },
  {
    "IDTypeIDStatus": "77d5d244e9fafb7c-eb296830-4b5b4a97-8b14b795-87d92b4215ea4601f5157134",
    "TypeNameStatusName": "General",
    "Description": "General Note"
  },
  {
    "IDTypeIDStatus": "2b11efc35ca214d1-2a434f29-4c03462f-92ac9e77-923e77f821a2561ede9ee415",
    "TypeNameStatusName": "ImportantInactive",
    "Description": "Important NoteInactive"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfTypeCrittah<ArrayOfStatus xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <TypeCrittah><Status>
      <IDType>22fcd267<IDStatus>926a4185-19586cb3-4a274a2a-8e9ca8ec-09139ea3f8a8<1fadc1cf4caa</IDType>IDStatus>
      <TypeName>Delivery<<StatusName>Active</TypeName>StatusName>
      <Description>Delivery Details<<Description>Active</Description>
   </TypeCrittah>Status>
   <TypeCrittah><Status>
      <IDType>77d5d244<IDStatus>e9fafb7c-eb296830-4b5b4a97-8b14b795-87d92b4215ea<4601f5157134</IDType>IDStatus>
      <TypeName>General<<StatusName>General</TypeName>StatusName>
      <Description>GeneralNote<<Description>General</Description>
   </TypeCrittah>Status>
   <TypeCrittah><Status>
      <IDType>2b11efc3<IDStatus>5ca214d1-2a434f29-4c03462f-92ac9e77-923e77f821a2<561ede9ee415</IDType>IDStatus>
      <TypeName>Important<<StatusName>Inactive</TypeName>StatusName>
      <Description>Important Note<<Description>Inactive</Description>
   </TypeCrittah>Status>
</ArrayOfTypeCrittah>

...

ArrayOfStatus>

Anchor
CustomerStatuses
CustomerStatuses
Customer Status

Returns a list of all contact customer statuses configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/statuses/contactcustomer
GETReturns data defining contact customer status

Data fields

 
FieldValue typeMandatoryDescriptionExample
IDStatusstring 
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
StatusNamestring 
Name of statusActive
Descriptionstring
description of statusAcitve

Get

...

customer status

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/statuses/contactcustomer

JSON Rsponse:

Code Block
[
  {
    "IDStatus": "926a4185-6cb3-4a2a-a8ec-1fadc1cf4caa",
    "StatusName": "Active",
    "Description": "Active"
  },
  {
    "IDStatus": "e9fafb7c-6830-4a97-b795-4601f5157134",
    "StatusName": "General",
    "Description": "General"
  },
  {
    "IDStatus": "5ca214d1-4f29-462f-9e77-561ede9ee415",
    "StatusName": "Inactive",
    "Description": "Inactive"
  }
]

...

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfStatus xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <Status>
      <IDStatus>926a4185-6cb3-4a2a-a8ec-1fadc1cf4caa</IDStatus>
      <StatusName>Active</StatusName>
      <Description>Active</Description>
   </Status>
   <Status>
      <IDStatus>e9fafb7c-6830-4a97-b795-4601f5157134</IDStatus>
      <StatusName>General</StatusName>
      <Description>General</Description>
   </Status>
   <Status>
      <IDStatus>5ca214d1-4f29-462f-9e77-561ede9ee415</IDStatus>
      <StatusName>Inactive</StatusName>
      <Description>Inactive</Description>
   </Status>
</ArrayOfStatus>

...

Anchor
Users
Users
Users

Returns a list of all customer statuses users configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/statuses/customerusers
GETReturns data defining customer statusof all users

Data fields

FieldValue typeMandatoryDescriptionExample
IDStatusIDUserstring 
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edccStatusName55ee9847edcc
Salutationstring
Salutation of the userMr
FirstNamestring Name of statusActive
DescriptionFirst name of the userJohn
LastNamestring description of statusAcitve

...


Last name of the userSmith

Get users

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/statuses/customerusers

JSON Rsponse:

Code Block
[
  {
    "IDStatusIDUser": "926a41853f4c7e0b-6cb33e6b-4a2a4a3b-a8ec-1fadc1cf4caa",
    "StatusName": "Active",
    "Description": "Active"
  }
  {b998-0103e1b2b1b6",
    "IDStatusSalutation": "e9fafb7c-6830-4a97-b795-4601f5157134Mr",
    "StatusNameFirstName": "GeneralPeter",
    "DescriptionLastName": "GeneralIsraelski"
  },
  {
    "IDStatusIDUser": "5ca214d1e5d2471f-4f29a154-462f4423-9e77-561ede9ee4159615-0177bcefe532",
    "Salutation": "Mr",
    "StatusNameFirstName": "InactiveAaron",
    "DescriptionLastName": "InactiveDavis"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfStatus xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <Status>
      <IDStatus>926a4185-6cb3-4a2a-a8ec-1fadc1cf4caa</IDStatus>
      <StatusName>Active</StatusName>
      <Description>Active</Description>
   </Status>
   <Status>
      <IDStatus>e9fafb7c-6830-4a97-b795-4601f5157134</IDStatus>
      <StatusName>General</StatusName>
      <Description>General</Description>
   </Status>
   <Status>
      <IDStatus>5ca214d1-4f29-462f-9e77-561ede9ee415</IDStatus>
      <StatusName>Inactive</StatusName>
      <Description>Inactive</Description>
   </Status>
</ArrayOfStatus>

...

Anchor
JobStatuses
JobStatuses
Job Statuses

Returns a list of all users job statuses configured in Crittah.

MethodResult
URIhttps://[CompanyID].crittah.com/ws/apiv2/[json or xml]/users]/statuses/jobtype/[IDJobType]
GETReturns data defining customer statusjob statuses

Data fields

FieldValue typeMandatoryDescriptionExample
IDUserstring IDJobTypestring
Unique ID for the job type. This is required to return the statuses for s specifc job typ7090fad1-c4da-4488-9ceb-55ee9847edcc
IDStatusstring
Unique identifier of the type7090fad1-c4da-4488-9ceb-55ee9847edcc
SalutationStatusNamestring 
Salutation of the userMr
FirstNameDescriptionstring 
First name of the userJohn
LastNamestring Last name of the userSmith

...

Get job type statuses

To obtain the status for a given job type you need to specify the job type ID in the call. Each job type can have a specific workflow so the statuses for each job can differ.

Sample cURL call:

Code Block
curl -H "Content-Type: application/json"  \
-H "API-AppID: 7090fad1-c4da-4488-9ceb-55ee9847edcc" \
-H "Api-Username: jsmith" \
-H "API-Password: abc123" \
http://[CompanyID].crittah.com/ws/apiv2/json/users/statuses/jobtype/BD176BE9-8C1B-4CD3-9B54-5AD51B2DE3F4

JSON Rsponse:

Code Block
[
  {
    "IDStatus": "1aabdc9c-ba61-4aa4-93d1-11f21c47807b",
    "StatusName": "In-Progress",
    "IDUserDescription": "3f4c7e0b-3e6b-4a3b-b998-0103e1b2b1b6",
Job has is in progress"
  },
  {
    "SalutationIDStatus": "Mrf24909a7-b645-4260-95d6-175753f9d643",
    "FirstNameStatusName": "PeterComplete",
    "LastNameDescription": "IsraelskiJob Completed"
  },
  {
    "IDUserIDStatus": "e5d2471fcbe9cc90-a1545465-442346d8-96159e10-0177bcefe53234671a4c420f",
    "SalutationStatusName": "Mr",
    "FirstName": "AaronClosed",
    "LastNameDescription": "DavisJob Closed"
  }
]

XML Response: 

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<ArrayOfStatus<ArrayOfJobStatus xmlns="http://schemas.datacontract.org/2004/07/Spinifex.lib.objects" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
   <Status><JobStatus>
      <IDStatus>926a4185<IDStatus>1aabdc9c-6cb3ba61-4a2a4aa4-a8ec93d1-1fadc1cf4caa<11f21c47807b</IDStatus>
      <StatusName>Active<<StatusName>In-Progress</StatusName>
      <Description>Job has is in <Description>Active<progress</Description>
   </Status>JobStatus>
   <Status><JobStatus>
      <IDStatus>e9fafb7c<IDStatus>f24909a7-6830b645-4a974260-b79595d6-4601f5157134<175753f9d643</IDStatus>
      <StatusName>General<<StatusName>Complete</StatusName>
      <Description>General<<Description>Job Completed</Description>
   </Status>JobStatus>
   <Status><JobStatus>
      <IDStatus>5ca214d1<IDStatus>cbe9cc90-4f295465-462f46d8-9e779e10-561ede9ee415<34671a4c420f</IDStatus>
      <StatusName>Inactive<<StatusName>Closed</StatusName>
      <Description>Inactive<<Description>Job Closed</Description>
   </Status>JobStatus>
</ArrayOfStatus>ArrayOfJobStatus>