Get All Owners

Gets a list of owners in the agency database. Specify at least one filter criteria.

Resource Information

Scopeowners

Deprecated scope name:   get_owners

App TypeAll
Authorization TypeAccess token
URI /v4/owners?fullName={fullName}&firstName={firstName}&lastName={lastName}&parcelId={parcelId}&email={email}&city={city}&state={state}&country={country}&limit={limit}&offset={offset}&fields={fields}&lang={lang}
HTTP MethodGET
Automation Version(s)7.3.2

Request Information

Field or ParameterTypeRequiredValuesDescriptionAutomation Version
citystringNoThe name of the city.7.3.2
countrystringNo Get All Address Countries The name of the country.7.3.2
emailstringNoThe contact's email address.7.3.2
fieldsstringNoComma-delimited names of fields to be returned in the response. Note: Field names are case-sensitive and only first-level fields are supported. Invalid field names are ignored.7.3.2
firstNamestringNoThe contact's first name. This field is only active when the Contact Type selected is Individual.7.3.2
fullNamestringNoThe contact's full name. This field is only active when the Contact Type selected is Individual.7.3.2
langStringNoIndicates the language applied.7.3.2
lastNamestringNoThe last name (surname). 7.3.2
limitlongNoIndicates the number of items that are returned in each page.7.3.2
offsetlongNoIndicates the offset start of each page by the number specified.7.3.2
parcelIdstringNoThe unique Id generated for a parcel.7.3.2
statestringNo Get All Address States The state corresponding to the address on record.7.3.2

Example

Sample Request Head

GET https://apis.accela.com//v4/owners?fullName=ADOBE%20HOUSE%20LLC

Notes

The following sample request uses the ISLANDTON agency in the TEST environment on the Accela Developer Sandbox. Click the "Send to Hurl.It" link below to submit the sample request. Replace YOUR-ACCESS-TOKEN before submitting the request.

curl
   -H 'Content-type: application/json'
   -H 'Accept: application/json'
   -H 'Authorization: YOUR-ACCESS-TOKEN'
   -X GET https://apis.accela.com//v4/owners?fullName=ADOBE%20HOUSE%20LLC

Response Information

FieldTypeDescriptionAutomation Version
result[]result{}7.3.2
result.addressresult.address{}The address of the subject.7.3.2
result.address.addressLine1stringThe first line of the address. 7.3.2
result.address.addressLine2stringThe second line of the address.7.3.2
result.address.addressLine3stringThe third line of the address.7.3.2
result.address.citystringThe name of the city.7.3.2
result.address.countryresult.address.country{}The name of the country.7.3.2
result.address.country.textstringThe localized display text.7.3.2
result.address.country.valuestringThe value for the specified parameter.7.3.2
result.address.postalCodestringThe postal ZIP code for the address.7.3.2
result.address.stateresult.address.state{}The state corresponding to the address on record.7.3.2
result.address.state.textstringThe localized display text.7.3.2
result.address.state.valuestringThe value for the specified parameter.7.3.2
result.emailstringThe contact's email address.7.3.2
result.faxstringThe fax number for the contact.7.3.2
result.firstNamestringThe contact's first name. This field is only active when the Contact Type selected is Individual.7.3.2
result.fullNamestringThe contact's full name. This field is only active when the Contact Type selected is Individual.7.3.2
result.idlongThe unique identifier for the object, assigned by the Civic Platform server and provided in a response.7.3.2
result.isPrimarystringIndicates whether or not to designate the owner as the primary owner.7.3.2
result.lastNamestringThe last name (surname). 7.3.2
result.mailAddressresult.mailAddress{}Contains the fields that define an owner's address.7.3.2
result.mailAddress.addressLine1stringThe first line of the address. 7.3.2
result.mailAddress.addressLine2stringThe second line of the address.7.3.2
result.mailAddress.addressLine3stringThe third line of the address.7.3.2
result.mailAddress.citystringThe name of the city.7.3.2
result.mailAddress.countryresult.mailAddress.country{}The name of the country.7.3.2
result.mailAddress.country.textstringThe localized display text.7.3.2
result.mailAddress.country.valuestringThe value for the specified parameter.7.3.2
result.mailAddress.postalCodestringThe postal ZIP code for the address.7.3.2
result.mailAddress.stateresult.mailAddress.state{}The state corresponding to the address on record.7.3.2
result.mailAddress.state.textstringThe localized display text.7.3.2
result.mailAddress.state.valuestringThe value for the specified parameter.7.3.2
result.middleNamestringThe middle name. 7.3.2
result.parcelIdstringThe unique Id generated for a parcel.7.3.2
result.phonestringThe telephone number of the owner. 7.3.2
result.phoneCountryCodestringThe country code for the assoicated phone number.7.3.2
result.recordIdresult.recordId{}The unique ID associated with a record.7.3.2
result.recordId.customIdstringAn ID based on a different numbering convention from the numbering convention used by the record ID (xxxxx-xx-xxxxx). Accela Automation auto-generates and applies an alternate ID value when you submit a new application.7.3.2
result.recordId.idstringThe unique identifier for the object, assigned by the Civic Platform server and provided in a response.7.3.2
result.recordId.serviceProviderCodestringThe unique agency identifier, the system assigns, on the Accela Civic Platform.7.3.2
result.recordId.trackingIdlongThe application tracking number (IVR tracking number).7.3.2
result.recordId.valuestringThe value for the specified parameter.7.3.2
result.statusresult.status{}The owner status.7.3.2
result.status.textstringThe localized display text.7.3.2
result.status.valuestringThe value for the specified parameter.7.3.2
result.structureNamestringThe name of the full or partial structure or establishment.7.3.2
result.structureTypestringThe type of structure or establishment7.3.2
result.taxIdstringThe owner's tax ID number.7.3.2
result.titlestringThe individual's business title. 7.3.2
statusintegerThe record status.7.3.3

Example

Sample Response Body

{
  "status": 200,
  "result": [
    {
      "parcelId": "137061038",
      "id": 1864428,
      "fullName": "ADOBE HOUSE LLC",
      "isPrimary": "Y",
      "mailAddress": {
        "city": "NOVATO ",
        "postalCode": "94945",
        "addressLine2": "1202 GRANT AVE",
        "state": {
          "value": "CA",
          "text": "CA"
        }
      },
      "address": {
        "city": "NOVATO ",
        "state": {
          "value": "CA",
          "text": "CA"
        }
      },
      "status": {
        "value": "A",
        "text": "Active"
      }
    }
  ],
  "page": {
    "offset": 0,
    "limit": 25,
    "hasmore": false
  }
}