---
title: "Get Company Billing Codes"
method: GET
path: "/compliance/v1/companies/{companyId}/clientOnboarding/partner/billing"
tags: ["Client Onboarding"]
---

# Get Company Billing Codes

`GET /compliance/v1/companies/{companyId}/clientOnboarding/partner/billing`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/compliance/v1/companies/{companyId}/clientOnboarding/partner/billing`
- 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**

This endpoint returns billing codes for the companyId querying

**Use Cases**

- Partner needs to confirm all billing codes have been added into Paylocity for a client
- Partner needs to confirm the status of billing codes that have been added for a client

## Path parameters

- `companyId` string, required

## Query parameters

- `includeTotalCount` boolean
- `offset` integer
- `limit` integer

## Headers

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

## Response `200`

Returns the billing codes for the companyId

- GetBillingCodesResponse
  - `billingCodes` BillingCodeDto[], nullable
    - `billingCode` string, nullable: Billing code associated with the screening order. This billing code is created on the partner side for a specific company. **Allowable Values:** 150 char max
    - `isActive` boolean: (Optional, if not provided – TRUE) A Boolean value indicating if the billing code is active. **Allowable Values:** true, false
    - `businessUnitId` string, nullable: (Optional, deprecated) Single Business Unit ID to associate this billing code with. Prefer `businessUnitIds` (plural), which supports reusing a billing code across several business units. On read this returns the first associated Business Unit ID (or null). On write it is treated as a single-element list; when `businessUnitIds` is also provided, the plural field takes precedence. **Allowable Values:** 150 char max
    - `businessUnitIds` string[], nullable: (Optional) Business Unit IDs to associate this billing code with. A billing code can be reused across several business units. An empty or absent list means the billing code is global (usable everywhere). These associations determine the effective business units of any screening package attached to this billing code: when a package has a billing code, the package's business unit is derived from the billing code and any business unit set directly on the package is ignored. **Allowable Values:** each value 150 char max

## Other responses

- `400`: Bad Request Error - Returns the details of the error
- `401`: Unauthorized
- `404`: Not Found
- `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)