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

# Upsert Screening Packages [Batch]

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

> 🚧 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**

Bulk Upsert information about screening packages

**Use Cases**

- Partner wants to send over multiple screening packages for a client, can be when onboarding a new client, or can be when client adds new packages to their company 
- Partner wants to make bulk changes to screening packages to make them either active or inactive for a client 
- Partner wants to update the prices of a client’s screening packages 
- Partner wants to bulk add services to a packages 
- Partner wants to add a billing code to correlate to a specific BGC package

## Path parameters

- `companyId` string, required

## Headers

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

## Request body

- ScreeningPackageBulkUpsertRequest — Screening Package Upsert Request.
  - `packages` ScreeningPackageBulkUpsertDto[], nullable — The list of screening packages to be upserted.
    - `packageId` string, nullable — The Id of the Screening Package. **Allowable Values:** 36 char max
    - `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 — Partner billing code.
    - `businessUnitExternalId` string, nullable — (Optional) Business Unit ID to associate this package with a package businessUnit. **Allowable Values:** 150 char max
    - `isInternational` boolean — Indicates whether it is international package.

## Response `200`

Returns the deatils of the Bulk upsert

- ScreeningPackageUpsertResponse — Screening Package Upserted Response
  - `upsertResult` UpsertResultDto — Upsert response
    - `inserted` boolean — True if it was inserted, false if it was updated
    - `updated` boolean — True if it was updated, false if it was inserted

## 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.net/paylocity/apis/assessments-api.md) · [All operations](https://skmtc.net/paylocity/apis/assessments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paylocity/assessments-api/revisions/dd22ab229153/schema)