--- updatedAt: 2026-05-11T22:22:56.000Z agentTools: siteIndex: https://developer.paylocity.com/llms.txt projectIndex: https://developer.paylocity.com/integrations/llms.txt --- # Get Company Billing Codes > 🚧 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 # OpenAPI definition ```json { "openapi": "3.0.4", "info": { "title": "Background Check API", "version": "v1" }, "servers": [ { "url": "dc1demogwext.paylocity.com" } ], "paths": { "/compliance/v1/companies/{companyId}/clientOnboarding/partner/billing": { "get": { "tags": [ "Client Onboarding" ], "summary": "Get Company Billing Codes", "description": "> 🚧 Partner Restricted\n> 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.\n\n**Summary Description**\n\nThis endpoint returns billing codes for the companyId querying\n\n**Use Cases**\n\n- Partner needs to confirm all billing codes have been added into Paylocity for a client\n- Partner needs to confirm the status of billing codes that have been added for a client", "x-explorer-enabled": false, "operationId": "ComplianceClientOnboardingPartnerBillingGet", "parameters": [ { "name": "companyId", "in": "path", "description": "The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.\n **Allowable Values:**\n 9 char max", "required": true, "schema": { "type": "string" }, "example": "A12345" }, { "name": "testMode", "in": "header", "description": "If true all responses are mocked and generated randomly", "schema": { "type": "boolean" }, "example": false }, { "name": "includeTotalCount", "in": "query", "description": "If true it will add X-Pcty-Total-Count header with total count for this specific query.", "schema": { "type": "boolean" }, "example": true }, { "name": "offset", "in": "query", "description": "Pagination offset.", "schema": { "type": "integer", "format": "int32", "default": 0 }, "example": 0 }, { "name": "limit", "in": "query", "description": "Pagination limit. Max value 100.", "schema": { "type": "integer", "format": "int32", "default": 50 }, "example": 50 }, { "name": "Authorization", "in": "header", "description": "Authorization token. Ex. Bearer ...", "required": true, "schema": { "type": "string" }, "example": "Bearer " } ], "responses": { "200": { "description": "Returns the billing codes for the companyId", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetBillingCodesResponse" } } } }, "400": { "description": "Bad Request Error - Returns the details of the error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericErrorResponse" }, "examples": { "UnsupportedXmlContentType": { "summary": "The API only supports JSON, but XML was provided.", "value": { "correlationId": "unsupported-media-type-xml-correlation-id", "value": { "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." }, "count": 1, "values": [ { "fields": "Content-Type: application/xml", "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." } ] } }, "MissingContentTypeHeader": { "summary": "The Content-Type header is missing or empty.", "value": { "correlationId": "unsupported-media-type-missing-header-correlation-id", "value": { "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." }, "count": 1, "values": [ { "fields": "Content-Type", "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." } ] } } } } } }, "401": { "description": "Unauthorized" }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenericErrorResponse" }, "examples": { "UnsupportedXmlContentType": { "summary": "The API only supports JSON, but XML was provided.", "value": { "correlationId": "unsupported-media-type-xml-correlation-id", "value": { "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." }, "count": 1, "values": [ { "fields": "Content-Type: application/xml", "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." } ] } }, "MissingContentTypeHeader": { "summary": "The Content-Type header is missing or empty.", "value": { "correlationId": "unsupported-media-type-missing-header-correlation-id", "value": { "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." }, "count": 1, "values": [ { "fields": "Content-Type", "code": "UNSUPPORTED_MEDIA_TYPE", "message": "The request content type is not supported." } ] } } } } } }, "415": { "description": "Unsupported Media Type - Returns the details of the error" } } } } }, "components": { "schemas": { "BillingCodeDto": { "type": "object", "properties": { "billingCode": { "type": "string", "description": "Billing code associated with the screening order. This billing code is created on the partner side for a specific company.\n **Allowable Values:**\n 150 char max", "nullable": true }, "isActive": { "type": "boolean", "description": "(Optional, if not provided – TRUE) A Boolean value indicating if the package is active.\n **Allowable Values:**\n true, false" }, "businessUnitId": { "type": "string", "description": "(Optional) Business Unit ID to associate this billing code with a package businessUnit.\n **Allowable Values:**\n 150 char max", "nullable": true } }, "additionalProperties": false, "description": "Billing code DTO payload." }, "ErrorDto": { "type": "object", "properties": { "code": { "type": "string", "description": "Error code associated with the error.", "nullable": true }, "message": { "type": "string", "description": "Descriptive message detailing the error.", "nullable": true } }, "additionalProperties": false }, "GenericErrorResponse": { "type": "object", "properties": { "correlationId": { "type": "string", "description": "A unique identifier used for tracing and correlation purposes.", "nullable": true }, "value": { "$ref": "#/components/schemas/ErrorDto" }, "count": { "type": "integer", "description": "Gets the count of items in the Values list.", "format": "int32", "nullable": true, "readOnly": true }, "values": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationErrorDto" }, "description": "A list of items.", "nullable": true } }, "additionalProperties": false }, "GetBillingCodesResponse": { "type": "object", "properties": { "billingCodes": { "type": "array", "items": { "$ref": "#/components/schemas/BillingCodeDto" }, "nullable": true } }, "additionalProperties": false }, "ValidationErrorDto": { "type": "object", "properties": { "code": { "type": "string", "description": "Error code associated with the error.", "nullable": true }, "message": { "type": "string", "description": "Descriptive message detailing the error.", "nullable": true }, "fields": { "type": "string", "description": "A string detailing the fields involved in the validation error.", "nullable": true } }, "additionalProperties": false } }, "securitySchemes": { "Bearer": { "type": "apiKey", "description": "CC JWT Authorization header using the bearer scheme", "name": "Authorization", "in": "header" } } }, "security": [ { "Bearer": [] } ] } ```