---
title: "Search offers by criteria"
method: GET
path: "/offers"
tags: ["offers"]
deprecated: true
---

# Search offers by criteria

`GET /offers`

## Request

- Base URL: `https://api.smartrecruiters.com/v1`
- URL: `https://api.smartrecruiters.com/v1/offers`
- Auth: API key in header `X-SmartToken`

> **Deprecated.**

Enables you to get a list of existing offers. The number of offers returned as part of the list can be modified using the offset and limit parameters. These results will be sorted using lastUpdateDate.

## Query parameters

- `limit` integer
- `offset` integer
- `status` string
- `q` string
- `postingId` string

## Response `default`

List of found offers

- ApiListResultApiOffer
  - `limit` integer
  - `offset` integer
  - `totalFound` integer
  - `content` ApiOffer[]
    - `id` string
    - `createDate` string, date-time
    - `lastUpdateDate` string, date-time
    - `catalogId` string, required
    - `name` string, required
    - `description` string, required
    - `category` string
    - `terms` ApiTerms, required
      - `type` 'REFERENCE_CHECK' | 'BEHAVIORAL_ASSESSMENT' | 'BACKGROUND_CHECK' | 'VIDEO_INTERVIEW' | 'SKILLS_TEST' | 'INLINE_ASSESSMENT'
      - `price` Money, required
        - `amount` number, required
        - `currencyCode` string
      - `postingPeriod` integer
      - `costPerClick` Money
        - `amount` number, required
        - `currencyCode` string
      - `existingContract` object
    - `status` 'ACTIVE' | 'INACTIVE' | 'UNDER_REVIEW' | 'REJECTED'
    - `targetMarket` ApiTargetMarket
      - `industries` ApiIndustry[]
        - `id` string
        - `label` string
      - `functions` ApiFunction[]
        - `id` string
        - `label` string
      - `experienceLevels` ApiExperienceLevel[]
        - `id` string
        - `label` string
      - `locations` ApiLocation[]
        - `country` string
        - `region` string
        - `city` string
    - `availability` ApiAvailability
      - `expirationDate` string, date-time
      - `industries` ApiIndustry[]
        - `id` string
        - `label` string
      - `locations` ApiLocation[]
        - `country` string
        - `region` string
        - `city` string
      - `companies` string[]
      - `specialOffer` string

---

[API](https://skmtc.dev/smartrecruiters/apis/partners-public-api-deprecated.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/partners-public-api-deprecated/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/partners-public-api-deprecated/revisions/9293aa623cb4?raw)