20.03.04 Clients

The Task Object

Object PropertyRequiredObject TypeDescriptionMax Character Length
ClientNameYesStringName Of Client200
AccountClientIdNoIntegerUnique Client Id Of Client10
ClientCodeNoStringClient Code Of Client4000
EMailAddressNoStringEmail Address Of Client50
Address1NoStringAddress 1 Of Client20
Address2NoStringAddress 2 Of Client20
CountryIdNoShortCountry Id Of Client3
StateNoStringState Of Client10
CityNoStringCity Of Client10
ZipCodeNoStringZipCode Of Client10
Telephone1NoStringTelephone 1 Of Client15
Telephone2NoStringTelephone 2 Of Client15
FaxNoStringFax No Of Client15
DefaultBillingRateNoDoubleDefault Billing Rate Of Client10
WebsiteNoStringWebsite Of Client50
NotesNoStringNotes Of Client100
IsDisabledNoBooleanDisabled Status Of Client2000
CustomField1NoStringCustomField 1 Of Client2000
CustomField2NoStringCustomField 2 Of Client2000
CustomField3NoStringCustomField 3 Of Client2000
CustomField4NoStringCustomField 4 Of Client2000
CustomField5NoStringCustomField 5 Of Client2000
CustomField6NoStringCustomField 6 Of Client2000
CustomField7NoStringCustomField 7 Of Client2000
CustomField8NoStringCustomField 8 Of Client2000
CustomField9NoStringCustomField 9 Of Client2000
CustomField11NoStringCustomField 10 Of Client2000
CustomField10NoStringCustomField 11 Of Client2000
CustomField12NoStringCustomField 12 Of Client2000
CustomField13NoStringCustomField 13 Of Client2000
CustomField14NoStringCustomField 14 Of Client2000
CustomField15NoStringCustomField 15 Of Client2000
FixedCostNoFloatFixed Cost Of Client10
FixedBidBillingModeNoStringFixed Bid Billing Mode Of Client18

List All Clients

Returns a list of your all Clients in your UNItekTIME account.
GET /API/Clients

Example Request

curl "https://demo.unitektime.com/api/clients" \
      -H "APIKey: {Your API Key}" \
      -H "AuthToken: {Your Authentication Token}" \
      -H "Content-Type: application/json" \
      -H "User-Agent: MyApp (yourname@example.com)"

Example Response

[
    {
        "AccountClientId": 00001,
        "ClientName": "Barth Gross Electric Company Inc",
        "ClientCode": "BGE",
        "EMailAddress": "info@barthgross.com",
        "Address1": "110 West 26th Street",
        "Address2": null,
        "State": "NY",
        "City": "New York",
        "Country": "United States"
        "ZipCode": 10001,
        "Telephone1": "+1 (212) 645-7452",
        "Telephone2": null,
        "Fax": null,
        "Website": "http://www.example.com",
        "Notes": null,
        "CreatedOn": "2017-12-27T13:57:34.78+00:00",
        "ModifiedOn": "2017-12-27T13:57:34.78+00:00",
        "CustomField1": null,
        "CustomField2": null,
        "CustomField3": null,
        "CustomField4": null,
        "CustomField5": null,
        "CustomField6": null,
        "CustomField7": null,
        "CustomField8": null,
        "CustomField9": null,
        "CustomField11": null,
        "CustomField10": null,
        "CustomField12": null,
        "CustomField13": null,
        "CustomField14": null,
        "CustomField15": null
    },
    {
        "AccountClientId": 00002,
        "ClientName": "Clutch Design Inc.",
        "ClientCode": "CLUTCH",
        "EMailAddress": "info@clutchdesign.com",
        "Address1": "320 Wilshire Blvd",
        "Address2": null,
        "State": "CA",
        "City": "Santa Monica",
        "Country": "United States"
        "ZipCode": 90401,
        "Telephone1": "+1 (310) 899-0522",
        "Telephone2": null,
        "Fax": null,
        "Website": "http://www.example.com",
        "Notes": null,
        "CreatedOn": "2017-12-27T13:57:34.78+00:00",
        "ModifiedOn": "2017-12-27T13:57:34.78+00:00",
        "CustomField1": null,
        "CustomField2": null,
        "CustomField3": null,
        "CustomField4": null,
        "CustomField5": null,
        "CustomField6": null,
        "CustomField7": null,
        "CustomField8": null,
        "CustomField9": null,
        "CustomField11": null,
        "CustomField10": null,
        "CustomField12": null,
        "CustomField13": null,
        "CustomField14": null,
        "CustomField15": null
    }
]

Retrieve a Client

Retrieves the client with the given ID. Returns a client object and a 200 OK response code if a valid identifier was provided.
GET /API/Clients/{CLIENT_ID}

Example Request

curl "https://demo.unitektime.com/api/clients/00001" \
      -H "APIKey: {Your API Key}" \
      -H "AuthToken: {Your Authentication Token}" \
      -H "Content-Type: application/json" \
      -H "User-Agent: MyApp (yourname@example.com)"

Example Response

[
    {
        "AccountClientId": 00001,
        "ClientName": "Barth Gross Electric Company Inc",
        "ClientCode": "BGE",
        "EMailAddress": "info@barthgross.com",
        "Address1": "110 West 26th Street",
        "Address2": null,
        "State": "NY",
        "City": "New York",
        "Country": "United States"
        "ZipCode": 10001,
        "Telephone1": "+1 (212) 645-7452",
        "Telephone2": null,
        "Fax": null,
        "Website": "http://www.example.com",
        "Notes": null,
        "CreatedOn": "2017-12-27T13:57:34.78+00:00",
        "ModifiedOn": "2017-12-27T13:57:34.78+00:00",
        "CustomField1": null,
        "CustomField2": null,
        "CustomField3": null,
        "CustomField4": null,
        "CustomField5": null,
        "CustomField6": null,
        "CustomField7": null,
        "CustomField8": null,
        "CustomField9": null,
        "CustomField11": null,
        "CustomField10": null,
        "CustomField12": null,
        "CustomField13": null,
        "CustomField14": null,
        "CustomField15": null
    }
]

Create a Client

Creates a new client. Returns Response message and a 201 Created response code if the call succeeded.
POST /API/Clients
Object PropertyRequiredObject TypeDescriptionMax Character Length
ClientNameYesStringName of Client200

Example Request

curl "https://demo.unitektime.com/api/clients" \
      -H "APIKey: {Your API Key}" \
      -H "AuthToken: {Your Authentication Token}" \
      -H "User-Agent: MyApp (yourname@example.com)" \
      -X POST \
      -H "Content-Type: application/json" \
      -d "{'clientname':'LEGO'}"

Example Response

[
    {
        "id": "00003",
        "message": "Client Added Successfully"
    }
]

Update a Client

Updates the specific client by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Returns Response message and a 200 OK response code if the call succeeded.
POST /API/Clients/{CLIENT_id}

Example Request

curl "https://demo.unitektime.com/api/clients/00003" \
      -H "APIKey: {Your API Key}" \
      -H "AuthToken: {Your Authentication Token}" \
      -H "User-Agent: MyApp (yourname@example.com)" \
      -X POST \
      -H "Content-Type: application/json" \
      -d "{'clientcode':'LEGO'}"

Example Response

[
    {
        "id": "00003",
        "message": "Client Updated Successfully"
    }
]

Delete a Client

Delete a client. Returns a 200 OK response code if the call succeeded.
DELETE /API/Clients/{CLIENT_ID}

Example Request

curl "https://demo.unitektime.com/api/clients/00003" \
      -H "APIKey: {Your API Key}" \
      -H "AuthToken: {Your Authentication Token}" \
      -H "User-Agent: MyApp (yourname@example.com)" \
      -X DELETE \
      -H "Content-Type: application/json"

Example Response

bc.[ { “id”: “00003”, “message”: “Client Deleted Successfully” }
]