Use the Certificate Center API to retrieve a list of taxability drivers.

Base URL:

https://ccservices.vertexsmb.com/certificate-center/v1/

Taxability Driver endpoint	Taxability Driver description
`/taxability-drivers`	GET - Retrieves a list of taxability drivers based on filter criteria, pagination, and sorting parameters.

Retrieve taxability drivers

Retrieve a list of taxability drivers records based on your choice of filter criteria.

Request

All request parameters are optional. Passing a request with no parameters returns all records.

Retrieve taxability drivers request parameter name	Retrieve taxability drivers request parameter format	Retrieve taxability drivers request parameter description
`top`	int64	Number of returned records to display per page. Default = 20.
`skip`	int64	Number of records to skip before displaying records. Must be 0 or greater. Default = 0.
`filter`	string	Limit the returned records to those including the filter criteria, such as customer name or taxpayer name.
`count`	Boolean	If set to true, returns a count of the total records found. Default = false.
`orderBy`	string	Order the results according to any response field by entering it here. Results are in alphabetical or numerical order depending on the field format.

Example request

curl --request GET \
     --url https://vertex-enterprise-group.readme.io/certificate-center/v1/taxability-drivers \
     --header 'accept: application/json'

Response

A response includes any number of taxability driver records. Each taxability driver record can include some or all of these fields.

Retrieve taxability drivers response field	Retrieve taxability drivers response description
`UUID`	Unique identifier.
`code`	Code assigned to the taxability driver.
`name`	Taxability driver name.
`startDate`	Date the taxability driver became active.
`endDate`	Date the taxability driver is no longer active, if any.
`note`	Note about the taxability driver.
`taxpayer`	Taxpayer associated with this taxability driver. The taxpayer field includes UUID, code, and name.

Example response

{
  "odata.count": 0,
  "value": [
    {
      "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "code": "string",
      "name": "string",
      "startDate": "2025-09-17",
      "endDate": "2025-09-17",
      "note": "string",
      "taxpayer": {
        "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "code": "string",
        "name": "string"
      }
    }
  ]
}