Methods

  • get - Search company officers

Resource

{
    "etag": "string",
    "items": [
        {
            "address": {
                "address_line_1": "string",
                "address_line_2": "string",
                "care_of": "string",
                "country": "string",
                "locality": "string",
                "po_box": "string",
                "postal_code": "string",
                "premises": "string",
                "region": "string"
            },
            "address_snippet": "string",
            "appointment_count": "integer",
            "date_of_birth": {
                "month": "integer",
                "year": "integer"
            },
            "description": "string",
            "description_identifiers": [
                "string"
            ],
            "kind": "string",
            "links": {
                "self": "string"
            },
            "matches": {
                "address_snippet": [
                    "integer"
                ],
                "snippet": [
                    "integer"
                ],
                "title": [
                    "integer"
                ]
            },
            "snippet": "string",
            "title": "string"
        }
    ],
    "items_per_page": "integer",
    "kind": "string",
    "start_index": "integer",
    "total_results": "integer"
}

Properties

Name Type Description Additional
etag string

The ETag of the resource

Optional
items[] array

The results of the completed search.

Optional
items[].address object

The service address of the officer.

items[].address.address_line_1 string

The first line of the address.

Optional
items[].address.address_line_2 string

The second line of the address.

Optional
items[].address.care_of string

The care of name.

Optional
items[].address.country string

The country. For example UK.

Optional
items[].address.locality string

The locality. For example London.

Optional
items[].address.po_box string

The post-office box number.

Optional
items[].address.postal_code string

The postal code. For example CF14 3UZ.

Optional
items[].address.premises string

The property name or number.

Optional
items[].address.region string

The region. For example Surrey.

Optional
items[].address_snippet string

A single line address. This will be the address that matched within the indexed document or the primary address otherwise (as returned by the address member).

items[].appointment_count integer

The total number of appointments the officer has.

items[].date_of_birth object

The officer date of birth details.

Optional
items[].date_of_birth.month integer

The month the officer was born in.

items[].date_of_birth.year integer

The year the officer was born in.

items[].description string

The result description.

items[].description_identifiers[] array of string

An array of enumeration types that make up the search description. See search_descriptions_raw.yaml in api-enumerations.

Possible values are:

  • appointment-count
  • born-on
Optional
items[].kind string

Describes the type of result returned.

Possible values are:

  • searchresults#officer
items[].links object

The URL of the search result.

Optional
items[].links.self string

The URL of the resource being returned by the search item.

Optional
items[].matches object

A list of members and arrays of character offset defining substrings that matched the search terms.

Optional
items[].matches.address_snippet[] array of integer

An array of character offset into the address_snippet string. These always occur in pairs and define the start and end of substrings in the member address_snippet that matched the search terms.

Optional
items[].matches.snippet[] array of integer

An array of character offset into the snippet string. These always occur in pairs and define the start and end of substrings in the member snippet that matched the search terms. The first character of the string is index 1.

Optional
items[].matches.title[] array of integer

An array of character offset into the title string. These always occur in pairs and define the start and end of substrings in the member title that matched the search terms. The first character of the string is index 1.

Optional
items[].snippet string

Summary information for the result showing additional details that have matched.

Optional
items[].title string

The title of the search result.

items_per_page integer

The number of search items returned per page.

Optional
kind string

The type of response returned.

Possible values are:

  • search#officers
start_index integer

The index into the entire result set that this result page starts.

Optional
total_results integer

The number of further search results available for the current search.

Optional