Responses

The PredictHQ API will respond to successful requests with either a collection of records or a single record. This section describes the standard format for each record type. Refer to the Resources section for a description of the results for each endpoint.


Headers

Content Negotiation

The PredictHQ API will always respond with the Content-Type header set to the format requested via the Accept header. Requests for a format not supported by the API will be rejected with the 406 Not Acceptable status code.


Collections

When requesting a collection of records, the JSON object will always contain the following properties:

Property Description
count The total number of results.
previous A URL to the previous page, or null if this is the first page.
next A URL to the next page, or null if this is the last page.
results An array of records.

Result Limit

Additionally, the following field will be provided by the Events endpoint if your subscription has a result limit:

Property Description
overflow Boolean flag that indicates if the search has more results than your subscription allows you to view.

Records

When requesting a single record, it will be returned as a JSON object. Refer to the Resources section for a description of possible records.