Use the Certificate Center API to retrieve a list of sellers.

Base URL:

https://ccservices.vertexsmb.com/certificate-center/v1/
Sellers endpointSellers description
/sellersGET - Retrieve a list of sellers based on filter criteria, pagination, and sorting parameters.

Retrieve sellers

Retrieve a list of seller records based on filter criteria, pagination, and sorting parameters. By default, sellers are sorted by their code in ascending order.

Request

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

Retrieve taxability drivers request parameter nameRetrieve taxability drivers request formatRetrieve taxability drivers request description
topint64Number of returned records to display per page. Default = 20.
skipint64Number of records to skip before displaying records. Must be 0 or greater. Default = 0.
filterstringLimit the returned records to those including the filter criteria, such as customer name or taxpayer name.
countBooleanIf set to true, returns a count of the total records found. Default = false.
orderBystringOrder 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/sellers \
     --header 'accept: application/json'

Response

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

Retrieve taxability drivers response fieldRetrieve taxability drivers response description
odata.countThe number of seller records retrieved.
valueAn array of objects, one for each seller record retrieved.
UUIDUnique identifier.
codeCode assigned to the seller.
nameSeller name.
addressSeller address.
citySeller city.
stateProvinceSeller state or province.
postalCodeSeller postal code.
countryNote about the seller.
taxpayerTaxpayer associated with this seller. The taxpayer field includes UUID, code, and name.
contactContact associated with this seller. The contact field includes UUID, name, and email.

Example response

{
  "odata.count": 0,
  "value": [
    {
      "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "code": "string",
      "name": "string",
      "address": "string",
      "city": "string",
      "stateProvince": "string",
      "postalCode": "string",
      "country": "string",
      "taxpayer": {
        "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "code": "string",
        "name": "string"
      },
      "contact": {
        "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "email": "[email protected]"
      }
    }
  ]
}