GET
/
api
/
v1
/
suppliers
/
{supplier_name}
/
date-ranges
Check Available Date Ranges
curl --request GET \
  --url https://api.example.com/api/v1/suppliers/{supplier_name}/date-ranges
{
  "error": "Bad Request",
  "message": "Invalid supplier name"
}

​
Overview

This endpoint returns the available date ranges for a particular supplier. Use this to determine what time periods have data available before making data requests.
Authorization Required - You must include a valid Bearer token in the Authorization header. Contact sales@rulebook.company to obtain API access.

​
Path Parameters

​
supplier_name
string
required
The name or code of the supplier (e.g., NYSE, NASDAQ, CBOE)

​
Request

curl -X GET https://api.rulebook.company/v1/suppliers/NYSE/date-ranges \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response

​
supplier
string
Name of the supplier
​
date_ranges
array
Array of available date range objects

​
Example Response

{
  "success": true,
  "data": {
    "supplier": "NYSE",
    "date_ranges": [
      {
        "start_date": "2024-01-01T00:00:00Z",
        "end_date": "2024-12-31T23:59:59Z",
        "data_types": [
          "fees_and_rebates",
          "market_data_fees",
          "participant_fees"
        ]
      },
      {
        "start_date": "2025-01-01T00:00:00Z",
        "end_date": "2025-12-31T23:59:59Z",
        "data_types": [
          "fees_and_rebates",
          "legal_regulatory_fees",
          "market_data_fees",
          "participant_fees",
          "port_fees"
        ]
      }
    ]
  }
}

​
Error Responses

{
  "error": "Bad Request",
  "message": "Invalid supplier name"
}