We’ve made the difficult decision to sunset Hire by Google on September 1, 2020. Learn more.

Method: tenants.jobs.list

List the jobs in Hire.

HTTP request

GET https://hire.googleapis.com/v1alpha1/{parent=tenants/*}/jobs

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The name of the tenant to list jobs on. We accept "my_tenant" as a valid tenant if the account only has access to one tenant. A valid parent would be "tenants/my_tenant".

Query parameters

Parameters
pageSize

number

Optional. The maximum number of items to return. Acceptable values are 1 to 100. Defaults to 100.

pageToken

string

Optional. Pagination token returned in a previous request.

filter

string

Optional. Supported dimensions for querying are as follows:

  • state=[Job.State]

Attempts to query with an unrecognized filter dimension will result in an INVALID_ARGUMENT error. Sample Query:

  • state=OPEN

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response containing a list of jobs for a specific request.

JSON representation
{
  "jobs": [
    {
      object (Job)
    }
  ],
  "nextPageToken": string
}
Fields
jobs[]

object (Job)

The list of jobs matching the provided filter.

nextPageToken

string

Token used to access the next page of this result. Omitted if no further results are available. Token can be used up to 6 hours after the original ListJobsRequest. Note that in some rare cases token might become invalid before.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/hire.job.readonly
  • https://www.googleapis.com/auth/hire.job.readwrite

For more information, see the OAuth 2.0 Overview.