API Endpoint

All API URLs listed in this documentation are relative to https://www.greysheet.com/sapi/. For example, the RetailPricingRequest API call is reachable at https://www.greysheet.com/sapi/json/reply/CpgPricingRequest.

RESTful

The CPG API is a mostly RESTful API. Known caveats:

  • All API calls should be made with HTTP POST.
  • You can consider any non-200 HTTP response code an error
  • All methods are accessed via: https://www.greysheet.com/sapi/OUTPUT_FORMAT/reply/SOME-METHOD

Passing Request Data

Request data is passed to the API by POSTing to the API endpoints with the appropriate parameters. The documentation for each API call will contain more detail on the parameters accepted by the call.
All requests must also have the following headers or they will be returned as unauthorized:

  • x-api-key
  • x-api-token
  • x-user-id
If you wish to obtain a set of API keys, contact us at cdn@greysheet.com

Output Formats

We support multiple output formats. To use any of them, simply replace the file extension in the API URL (OUTPUT_FORMAT above) with one of:

  • json
  • xml
  • csv

Questions? Problems?

Have you run into difficulties or a method just doesn't seem to work right? Contact us at cdn@greysheet.com and we'll be happy to assist you.