Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Returns the latest modified companies.

Resource URL

/companies/newest

Parameters

Table of allowed paramaters.

_pageunsigned intThe page of the list to display. For example, 5 will display the fifth page. Each page contains 10 resources.
_limitunsigned intThe maximum number of resources to return. Default is 10 and maximum is 50.
_offsetunsigned intThe position in the list of resources to return from. For example, if you had 20 resources and requested an offset of 10. Resources 10 to 19 would be returned. Offset cannot be used in conjunction with _page.
_fieldspartial stringAllows you to specify optional fields and linked objects to include in the response.

Handling the response

Below is a table of available response fields and objects that are returned within the response object of the returned object. The optional fields and objects can be requested in the _fields paramater; see included examples. Underlined values are default.

idunsigned int 
namestring 
websitestring 
standingstring 
statusunsigned int or object 
phonestring 
faxstring 
date_createdunsigned int 
date_modifiedunsigned int 
commentsstring 
contactunsigned int or object 

Fields that can be object indicate the field can be requested as a resource. For example.

GET /companies/newest.json?_fields=contact

would return the contacts id. Where as,

GET /companies/newest.json?_fields=contact()

would return the contact's object, including any optional fields or objects within the parenthesis.

Sample Response

GET /companies/newest.json?_fields=contact(),standing&_limit=2
{
   "response" : [
      {
         "name" : "ADTOA",
         "contact" : {
            "email" : "rpepper@ihug.com.au",
            "firstname" : "Ronald",
            "id" : "1",
            "mobile" : "0425 239 666",
            "surname" : "Pepper IHUG"
         },
         "standing" : "active",
         "id" : "1"
      },
      {
         "name" : "Balgownie Veterinary Hospital",
         "contact" : {
            "email" : "mark@balgownievet.com.au",
            "firstname" : "Mark",
            "id" : "2",
            "mobile" : "",
            "surname" : "Allison"
         },
         "standing" : "active",
         "id" : "2"
      }
   ],
   "meta" : {
      "more_info" : "/public_api/docs/status/ok",
      "status" : "ok",
      "message" : "Everything executed as expected."
   }
}
  • No labels