API: Data Points

The New Constructs Data Point dataset provides immediate access to the list of available data points that are used in our models.

API: All Data Points

Returns a list of all available data points that can used and the endpoints they are available in.

Endpoint
URL
Method
/datapoint
GET
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
name
The name of the datapoint which can be used in other API calls.
LEASES_PAYMENTS
description
A brief description of the datapoint.
Total of all future operating lease payments.
endpoints
A list of endpoints in which the datapoint appears.
Model Data, Adjusted Fundamentals
Sample Call:
Check out Python examples and more in our GitHub repo.
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/datapoint'
Success Response: 

{
  "statusCode": 200,
  "headers": {"Content-Type": "application/json"},
  "body": {
    "results": [
      {
        "name": "LEASES_PAYMENTS",
        "description": "Total of all future operating lease payments.",
        "endpoints": "Model Data, Adjusted Fundamentals.",
      },
      ...
    ]
  }
}

API: Single Data Point

Returns detailed information about a single data point.

Endpoint
URL
Method
/datapoint/:name
GET
URL Parameters
Name
Description
Example
:name
Name of data point to look up
Header Parameters
Name
Value
x-api-key
[New Constructs-provided API key]
Content-Type
application/json
Return Values
Name
Description
Example
name
The name of the datapoint which can be used in other API calls.
LEASES_PAYMENTS
description
A brief description of the datapoint.
Total of all future operating lease payments.
endpoints
A list of endpoints in which the datapoint appears.
Model Data, Adjusted Fundamentals
Sample Call:
Check out Python examples and more in our GitHub repo.
curl -i -H 'x-api-key: [New Constructs-provided API key]' -H "Content-Type: application/json" 'https://api.newconstructs.com/v1/datapoint/LEASES_PAYMENTS'
Success Response: 

{
  "statusCode": 200,
  "headers": {"Content-Type": "application/json"},
  "body": {
    "results": {
        "name": "LEASES_PAYMENTS",
        "description": "Total of all future operating lease payments.",
        "endpoints": "Model Data, Adjusted Fundamentals.",
    }
  }
}

API: Datapoint Errors

Error
Message
Error Code
DataPointNotFound
The requested datapoint was not found.
404