---
title: "find many openings"
method: GET
path: "/api/serviceworkforce/openings"
tags: ["openings"]
---

# find many openings

`GET /api/serviceworkforce/openings`

Find many openings (with filtering, projection, pagination and limiting). You can use filters in the query parameters (properly URL encoded) to restrict the search results:
- To restrict the search to specific values for a given field name, you can use the following syntax: filter[where][fieldName][eq]=value. Note that you can also nest the filter object to filter on multiple fields, like so: filter[where][and][0][fieldName1][eq]=value1&filter[where][and][1][fieldName2][eq]=value2. You can also use operators like gt, gte, lt, lte, ne, in, nin, etc.
- To limit the number of results returned by the query, use the following syntax: filter[limit]=25&filter[skip]=25
- To only return specific fields, use the projection query parameter. Usage is as follows: filter[fields][fieldName1]=true&filter[fields][fieldName2]=true.

## Query parameters

- `filter` ParametersFilter
  - `where` ParametersFilterWhere
  - `fields` ParametersFilterFields
  - `limit` number
  - `skip` number
  - `order` string[]
  - `collate` ParametersFilterCollation
    - `locale` string
    - `strength` number
    - `caseLevel` boolean
    - `numericOrdering` boolean

## Response `200`

One or many opening documents found. Wrapped in a JsonAPI root response with collection of documents as data.

- object
  - `data` Opening[]
    - `uuid` string, uuid — Unique identifier
    - `createdAt` string, date-time — Creation timestamp
    - `createdBy` string, uuid — Creator UUID
    - `lastUpdatedAt` string, date-time — Last update timestamp
    - `lastUpdatedBy` string, uuid — Last updater UUID
    - `lastUpdatedByAudience` string — Audience of last updater
    - `lastUpdatedByAudienceUuid` string, uuid — Audience UUID of last updater
    - `lastUpdatedByImpersonatedBy` string, uuid — Impersonator UUID
    - `lastUpdatedByCompanyUuid` string, uuid — Company UUID of last updater
    - `lastUpdatedByEnterpriseUuid` string, uuid — Enterprise UUID of last updater
    - `title` string, required
    - `active` boolean — Whether the opening is currently active
    - `is_private` boolean — Whether the opening is private or public
    - `companyUuid` string, uuid
    - `externalOpening` object, required — Metadata storage of the opening data from an external source
      - `source` 'hire' | 'hire-go' | 'workday', required
      - `externalIdentifier` string, uuid, required — External identifier from Hire (funnel UUID)
      - `externalCreatedAt` string, date-time — Creation timestamp from the external source
    - `jobUuid` string, uuid — Reference to WX job UUID
    - `locationUuid` string, uuid — Reference to WX location UUID
    - `locationGroupUuid` string, uuid — Reference to WX location group UUID
    - `ownerUuid` string, uuid — Reference to WX employer UUID (opening owner)
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `500` — default error response

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)