DEVELOPER GUIDE
Stable
Common Headers
Overview
In addition to the standard Content-Type, Accept, and Authorization headers, Pitchpoint supports several X-PPS-* request headers that apply across all products and API calls. These headers are optional, but are useful for tracking, billing attribution, and delegated access.
X-PPS-UserAlias
Use this header to pass your own internal identifier for the end user or system making the request (for example, an internal username, loan officer ID, or system name).
The value you send is stored with the order and echoed back on your billing records, so you can reconcile Pitchpoint invoices against your own internal users or systems without having to create a Pitchpoint account per user.
X-PPS-UserAlias: jsmith
This header is for informational/billing purposes only. It does not affect authentication or authorization.
X-PPS-Authorization-Alias
Use this header to act on behalf of another user. This is intended for integrations where a single service account needs to submit orders as if they were placed by a different, specific user.
X-PPS-Authorization-Alias: jsmith@company.com
The credentials in the Authorization header must belong to a user who has been granted permission to act as the aliased user. If that permission has not been set up on your account, requests with this header will be rejected. Contact your Pitchpoint Account Representative if you need this permission configured.
X-PPS-CorrelationID
This value is returned on every response, and can be used to track the request across the entire Pitchpoint Solutions stack. If you run into issues with a request, send the Pitchpoint Solutions support team this X-PPS-CorrelationID value along with the approximate date/time the request occurred.
X-PPS-CorrelationID: 8f14e45f-ceea-467e-adf5-b9a1b4b1c8f0
Please be aware that this value is different from the CorrelationID field in the request body. The body’s CorrelationID is a business identifier used to identify particular verifications, while X-PPS-CorrelationID exists purely so support can trace a request’s path through the system.