GET
/
fee-schedule-results
/
versions
/
{version_id}
Get fee schedule results by version
curl --request GET \
  --url https://api.rulebook.company/api/v1/fee-schedule-results/versions/{version_id} \
  --header 'x-rulebook-api-access-key: <api-key>'
{
  "message": "You are not authorized to perform this action. Invalid API key.",
  "data": [],
  "query_time": null,
  "success": false,
  "disable_jsonable_encoder": false,
  "status_code": 401
}

​
Overview

Returns all fee schedule results belonging to a specific extraction version. Each version represents a single extraction run against a fee schedule document. Use this to retrieve the complete set of fees from that version. Results are access-scoped — you can only retrieve versions for exchanges associated with your API key.
Authorization Required - Include your API key in the x-rulebook-api-access-key header. Contact sales@rulebook.company to obtain access.
You can find version_id values in the response of the List Fee Schedule Results or Get Fee Schedule Result endpoints.

​
Path Parameters

​
version_id
string (uuid)
required
Fee extraction version identifier. Obtain this from the version_id field in fee schedule results.

​
Query Parameters

​
page_size
integer
default:"20"
Records per page (1–100)
​
page_number
integer
default:"0"
Page number (0-indexed)

​
Request

curl -X GET "https://api.rulebook.company/api/v1/fee-schedule-results/versions/f7e8d9c0-b1a2-3456-7890-abcdef123456" \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

​
With Pagination

curl -X GET "https://api.rulebook.company/api/v1/fee-schedule-results/versions/f7e8d9c0-b1a2-3456-7890-abcdef123456?page_size=50&page_number=0" \
  -H "x-rulebook-api-access-key: YOUR_API_KEY"

​
Response

​
success
boolean
Whether the request was successful
​
message
string
Human-readable status message
​
data
array
Array of fee schedule result objects (same schema as the list endpoint)
​
total_records
integer
Total records in this version
​
page_size
integer
Records per page
​
total_pages
integer
Total number of pages
​
current_page
integer
Current page number (0-indexed)
​
query_time
number
Query execution time in seconds

​
Example Response

{
  "message": "Operation completed successfully.",
  "data": [
    {
      "id": "eb3708ab-b06a-4818-abbb-1689c53130c7",
      "exchange_name": "Nasdaq",
      "fee_type": "OPTION",
      "fee_category": "Market Data Fees",
      "fee_charge_type": "Monthly Internal Distributor Fee for ITTO",
      "fee_amount": "$1,648",
      "fee_action": "Other",
      "fee_action_details": "Data Feed Distribution",
      "fee_basis": "per firm",
      "fee_notes": "Effective from 1/1/27",
      "fee_reference": null,
      "fee_participant": "All",
      "fee_participant_details": null,
      "fee_monthly_volume": null,
      "fee_monthly_volume_criteria": null,
      "fee_symbol_classification": "All",
      "fee_symbol_type": "Both",
      "fee_trade_type": null,
      "fee_symbol": "All",
      "fee_excluded_symbols": null,
      "fee_conditions": null,
      "fee_exclusions": null,
      "fee_extra_info": null,
      "version_id": "3996c6d1-4b89-4d1d-8abb-a8fd485c224d",
      "scraped_time": "2026-02-16T07:03:33.109403+00:00",
      "created_on": "2026-02-18T08:28:53.411953"
    },
    {
      "id": "0a34cf73-e89e-45ef-b6bc-2614d4975363",
      "exchange_name": "Nasdaq",
      "fee_type": "OPTION",
      "fee_category": "Fees And Rebates",
      "fee_charge_type": "Rebate to Add Liquidity in Non-Penny Symbols",
      "fee_amount": "($0.10)",
      "fee_action": "Make",
      "fee_action_details": null,
      "fee_basis": null,
      "fee_notes": null,
      "fee_reference": "12",
      "fee_participant": "Customer",
      "fee_participant_details": null,
      "fee_monthly_volume": "Tiers 2, 3, 4, or 5",
      "fee_monthly_volume_criteria": "Qualifies for Customer or Professional Penny Symbol Rebate to Add Liquidity Tiers 2, 3, 4, or 5 in a month",
      "fee_symbol_classification": "All",
      "fee_symbol_type": "Non Penny",
      "fee_trade_type": null,
      "fee_symbol": "All",
      "fee_excluded_symbols": null,
      "fee_conditions": "A Participant that qualifies for Customer or Professional Penny Symbol Rebate to Add Liquidity Tiers 2, 3, 4, or 5 in a month",
      "fee_exclusions": null,
      "fee_extra_info": null,
      "version_id": "3996c6d1-4b89-4d1d-8abb-a8fd485c224d",
      "scraped_time": "2026-02-16T07:03:33.109403+00:00",
      "created_on": "2026-02-18T08:28:53.411953"
    }
  ],
  "query_time": 0.426,
  "success": true,
  "disable_jsonable_encoder": false,
  "total_records": 187,
  "page_size": 2,
  "total_pages": 94,
  "current_page": 0
}

​
Error Responses

{
  "message": "You are not authorized to perform this action. Invalid API key.",
  "data": [],
  "query_time": null,
  "success": false,
  "disable_jsonable_encoder": false,
  "status_code": 401
}

Authorizations

​
x-rulebook-api-access-key
string
header
required

API access key provided by Rulebook Company. Contact sales@rulebook.company to obtain one.

Path Parameters

​
version_id
string<uuid>
required

Fee extraction version identifier (from the version_id field in fee schedule results)

Query Parameters

​
page_size
integer
default:20

Number of records per page (1-100)

Required range: 1 <= x <= 100
​
page_number
integer
default:0

Page number (0-indexed)

Required range: x >= 0

Response

Paginated fee schedule results for the specified version

​
success
boolean
Example:

true

​
message
string
Example:

"Operation completed successfully."

​
data
object[]
​
total_records
integer

Total records in this version

Example:

85

​
page_size
integer

Records per page

Example:

20

​
total_pages
integer

Total number of pages

Example:

5

​
current_page
integer

Current page (0-indexed)

Example:

0

​
query_time
number

Query execution time in seconds

Example:

0.089