---
title: "retrieve a list of Hire openings with targeting"
method: GET
path: "/api/servicereferral/processes/referralCampaigns/{companyUuid}/openings"
tags: ["referralCampaigns"]
---

# retrieve a list of Hire openings with targeting

`GET /api/servicereferral/processes/referralCampaigns/{companyUuid}/openings`

## Path parameters

- `companyUuid` string, required

## Query parameters

- `workerUuid` string, required
- `brandUuid` string
- `page` integer
- `search` string

## Response `200`

status success

- object
  - `data` object
    - `openings` object[]
      - `title` string
      - `apply_url` string, required
      - `targeted` boolean
      - `id` string, required
      - `location` object, required
        - `name` string, required
        - `id` string, required
      - `position` object, required
        - `name` string, required
        - `id` string, required
      - `referralCampaignUuid` string
      - `incentives` object[]
        - `rewardType` 'both' | 'worker' | 'applicant', required
        - `currency` 'USD' | 'GBP' | 'EUR' | 'ARS' | 'AUD' | 'BRL' | 'CAD' | 'CHF' | 'DKK' | 'INR' | 'PHP' | 'NZD' | 'SAR' | 'COP' | 'GTQ', required
        - `cashValue` number, required
        - `numberOfDays` number
        - `payoutCondition` 'daysAfterStart' | 'daysAfterHire' | 'shiftsCompleted'
        - `payoutConditions` object[]
          - `conditions` object[], required
            - `numberOfDays` number, required
            - `payoutCondition` 'daysAfterStart' | 'daysAfterHire' | 'shiftsCompleted', required
          - `attributeConditions` object[]
            - `customAttributeUuid` string, uuid, required
            - `customAttributeName` string
            - `dataType` 'string' | 'number' | 'boolean' | 'date' | 'select', required
            - `value` union, required
              - …
    - `pagination` object
      - `first` integer
      - `last` integer
      - `previous` integer, nullable
      - `current` integer
      - `next` integer, nullable

---

[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/revisions/5f406c0e9462/schema)