---
title: "Get Screening Packages"
method: GET
path: "/compliance/v1/companies/{companyId}/backgroundCheck/screeningPackages"
tags: ["Screening Package"]
---

# Get Screening Packages

`GET /compliance/v1/companies/{companyId}/backgroundCheck/screeningPackages`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/compliance/v1/companies/{companyId}/backgroundCheck/screeningPackages`
- Auth: API key in header `Authorization`

> 🚧 Partner Restricted
> All background check API endpoints are restricted to background check providers that have signed a Paylocity technology partnership agreement. [Please reach out to our team](https://www.paylocity.com/contact/partner-form/) if you would like to discuss partnership opportunities.

**Summary Description**

Returns the screening packages for the companyId

**Use Cases**

- Partner needs to confirm that package information with Paylocity is correct and calls for the package information for a specific company ID

## Path parameters

- `companyId` string, required

## Headers

- `testMode` boolean
- `Authorization` string, required

## Response `200`

Returns the screening packages

- ScreeningPackagesResponse
  - `count` integer: Gets the count of items in the Values list.
  - `values` ScreeningPackageDto[], nullable: A list of items.
    - `isActive` boolean: A Boolean value indicating if the package is active. **Allowable Values:** true, false
    - `packageSummary` string, nullable: A detailed description of the background check package and what is included in the package. **Allowable Values:** 250 char max
    - `packageName` string, nullable: The name of the specific background check package that the users will see. **Allowable Values:** 250 char max
    - `services` ServiceDto[], nullable: An array of objects representing the underlying services that are included in the background check package.
      - `serviceName` string, nullable: The name of the specific service within a background check package that the users will see. **Allowable Values:** 150 char max
      - `serviceSummary` string, nullable: A detailed description of the underlying service in a package. **Allowable Values:** 250 char max
    - `price` PriceDto: An object representing the price of the package.
      - `value` number, double: The value amount, or cost, for the package.
      - `currency` string, nullable: The currency of the price. **Allowable Values:** USD, EUR, GBP, CAD
    - `billingCode` string, nullable: Billing code created by a client that can be associated with an order (optional). **Allowable Values:** 150 char max
    - `businessUnitId` string, nullable: (Optional) Business Unit ID for this package. On write this field is only honored in BU-only mode (package without a billing code); if the package has a billing code, the package's business unit is derived from that billing code and this field is ignored. On read it reflects the effective business unit (derived from the billing code when one is present). **Allowable Values:** 150 char max
    - `isInternational` boolean: Indicates whether it is international package.
    - `packageId` string, nullable: The Id of the Screening Package.
    - `createdAt` string, nullable: The date when the Screening Package was created.
    - `updatedAt` string, nullable: The date when the Screening Package was updated.
    - `partnerName` string, nullable: Related Partner name.

## Other responses

- `400`: Bad Request Error - Returns the details of the error
- `401`: Unauthorized
- `415`: Unsupported Media Type - Returns the details of the error

---

[API](https://skmtc.dev/paylocity/apis/background-check-api.md) - [All operations](https://skmtc.dev/paylocity/apis/background-check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/background-check-api/revisions/8d585de5e05e?raw)