# Endpoints

## Retrieve Suggested CCF values for Specific Accounts

> Fetches Suggested CCF values for a specified list of account IDs under a given bookmaker and sub-bookmaker. If there are multiple pages of results, the response may include a lastEvaluatedKey for pagination.

```json
{"openapi":"3.0.1","info":{"title":"Suggested CCF API","version":"2025-10-06T18:32:17Z"},"servers":[{"url":"https://api.insighttechservices.sportradar.com/{basePath}","variables":{"basePath":{"default":"api/sccf"}}}],"security":[{"sccf-api-req-authorizer":[]}],"components":{"securitySchemes":{"sccf-api-req-authorizer":{"type":"apiKey","description":"Bearer authentication header of the form Bearer \\<TOKEN\\>.","name":"Unused","in":"header"}},"schemas":{"SuggestedCcfResponse":{"required":["queryExecutionTime","requestId","responseItem","responseMessage","responseStatus"],"type":"object","properties":{"lastEvaluatedKey":{"type":"string"},"queryExecutionTime":{"type":"integer"},"requestId":{"type":"string"},"responseItem":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItem"},"responseMessage":{"type":"string"},"responseStatus":{"type":"string","enum":["SUCCESSFUL","VALIDATION_FAILED","ERROR","KEY_NOT_FOUND"]}}},"SuggestedCcfResponseResponseItem":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItem"}},"shops":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemShopsItem"}},"terminals":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemTerminalsItem"}}},"additionalProperties":false},"SuggestedCcfResponseResponseItemCustomersItem":{"required":["C"],"type":"object","properties":{"C":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemCustomersItemC":{"required":["id","sCcf","srcId"],"type":"object","properties":{"id":{"type":"string"},"sCcf":{"pattern":"^(\\d{1,2}(\\.\\d{1,2})?|100(\\.00?)?)$","type":"string"},"srcId":{"type":"string"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemShopsItem":{"required":["S"],"type":"object","properties":{"S":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemTerminalsItem":{"required":["T"],"type":"object","properties":{"T":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"ResponseExample":{"required":["queryExecutionTime","requestId","responseItem","responseMessage","responseStatus"],"type":"object","properties":{"lastEvaluatedKey":{"type":"string","enum":["83hdf97f98f"]},"queryExecutionTime":{"type":"integer","enum":[5]},"requestId":{"type":"string","enum":["c81d9e0b-d122-4e5a-b8e1-24c6c5113419"]},"responseItem":{"$ref":"#/components/schemas/ResponseExampleResponseItem"},"responseMessage":{"type":"string","enum":["Number of items found: 1"]},"responseStatus":{"type":"string","enum":["SUCCESSFUL"]}}},"ResponseExampleResponseItem":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/ResponseExampleResponseItemCustomersItem"}}},"additionalProperties":false},"ResponseExampleResponseItemCustomersItem":{"required":["C"],"type":"object","properties":{"C":{"$ref":"#/components/schemas/ResponseExampleResponseItemCustomersItemC"}},"additionalProperties":false},"ResponseExampleResponseItemCustomersItemC":{"required":["id","sCcf","srcId"],"type":"object","properties":{"id":{"type":"string","enum":["abc"]},"sCcf":{"type":"string","enum":["1.3"]},"srcId":{"type":"string","enum":["1234:5678:::abc"]}},"additionalProperties":false},"Unauthorized":{"title":"Unauthorized","type":"object","properties":{"message":{"type":"string","enum":["Authorization error, please contact support."]}}},"Forbidden":{"title":"Forbidden","type":"object","properties":{"message":{"type":"string","enum":["You do not have permission to access this resource."]}}},"Throttled":{"title":"Throttled","type":"object","properties":{"message":{"type":"string","enum":["Request throttled! Try again later."]}}},"InternalError":{"title":"Internal Server Error","type":"object","properties":{"message":{"type":"string","enum":["Internal server error, please contact support."]}}}}},"paths":{"/v1/bookmakers/{bookmaker}/sub-bookmakers/{sub-bookmaker}/source":{"get":{"tags":["Endpoints"],"summary":"Retrieve Suggested CCF values for Specific Accounts","description":"Fetches Suggested CCF values for a specified list of account IDs under a given bookmaker and sub-bookmaker. If there are multiple pages of results, the response may include a lastEvaluatedKey for pagination.","operationId":"Suggested CCF Source","parameters":[{"name":"customer","in":"query","description":"Comma-separated list of customer IDs to retrieve data for. Customers should belong to bookmaker, sub_bookmaker. At least one of the customer/shop/terminal query parameter is mandatory.","schema":{"type":"string"}},{"name":"terminal","in":"query","description":"Comma-separated list of terminal IDs to retrieve data for. Terminals should belong to bookmaker, sub_bookmaker. At least one of the customer/shop/terminal query parameter is mandatory.","schema":{"type":"string"}},{"name":"shop","in":"query","description":"Comma-separated list of shop IDs to retrieve data for. Shops should belong to bookmaker, sub_bookmaker. At least one of the customer/shop/terminal query parameter is mandatory.","schema":{"type":"string"}},{"name":"bookmaker","in":"path","description":"Identifier for the bookmaker. Generated by Sportradar, contact your OAM or CI engineer in case of any issues with obtaining the correct value.","required":true,"schema":{"type":"string"}},{"name":"sub-bookmaker","in":"path","description":"Identifier for the sub-bookmaker. Generated by Sportradar, contact your OAM or CI engineer in case of any issues with obtaining the correct value. Value * retrieves all data for a bookmaker.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestedCcfResponse"}},"application/example":{"schema":{"$ref":"#/components/schemas/ResponseExample"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"429":{"description":"Throttled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Throttled"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}}}}}}
```

## Retrieve All Suggested CCF values

> Fetches Suggested CCF values for all accounts associated with a specific bookmaker and sub-bookmaker. If there are multiple pages of results, the response may include a lastEvaluatedKey for pagination.

```json
{"openapi":"3.0.1","info":{"title":"Suggested CCF API","version":"2025-10-06T18:32:17Z"},"servers":[{"url":"https://api.insighttechservices.sportradar.com/{basePath}","variables":{"basePath":{"default":"api/sccf"}}}],"security":[{"sccf-api-req-authorizer":[]}],"components":{"securitySchemes":{"sccf-api-req-authorizer":{"type":"apiKey","description":"Bearer authentication header of the form Bearer \\<TOKEN\\>.","name":"Unused","in":"header"}},"schemas":{"SuggestedCcfResponse":{"required":["queryExecutionTime","requestId","responseItem","responseMessage","responseStatus"],"type":"object","properties":{"lastEvaluatedKey":{"type":"string"},"queryExecutionTime":{"type":"integer"},"requestId":{"type":"string"},"responseItem":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItem"},"responseMessage":{"type":"string"},"responseStatus":{"type":"string","enum":["SUCCESSFUL","VALIDATION_FAILED","ERROR","KEY_NOT_FOUND"]}}},"SuggestedCcfResponseResponseItem":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItem"}},"shops":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemShopsItem"}},"terminals":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemTerminalsItem"}}},"additionalProperties":false},"SuggestedCcfResponseResponseItemCustomersItem":{"required":["C"],"type":"object","properties":{"C":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemCustomersItemC":{"required":["id","sCcf","srcId"],"type":"object","properties":{"id":{"type":"string"},"sCcf":{"pattern":"^(\\d{1,2}(\\.\\d{1,2})?|100(\\.00?)?)$","type":"string"},"srcId":{"type":"string"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemShopsItem":{"required":["S"],"type":"object","properties":{"S":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemTerminalsItem":{"required":["T"],"type":"object","properties":{"T":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"ResponseExample":{"required":["queryExecutionTime","requestId","responseItem","responseMessage","responseStatus"],"type":"object","properties":{"lastEvaluatedKey":{"type":"string","enum":["83hdf97f98f"]},"queryExecutionTime":{"type":"integer","enum":[5]},"requestId":{"type":"string","enum":["c81d9e0b-d122-4e5a-b8e1-24c6c5113419"]},"responseItem":{"$ref":"#/components/schemas/ResponseExampleResponseItem"},"responseMessage":{"type":"string","enum":["Number of items found: 1"]},"responseStatus":{"type":"string","enum":["SUCCESSFUL"]}}},"ResponseExampleResponseItem":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/ResponseExampleResponseItemCustomersItem"}}},"additionalProperties":false},"ResponseExampleResponseItemCustomersItem":{"required":["C"],"type":"object","properties":{"C":{"$ref":"#/components/schemas/ResponseExampleResponseItemCustomersItemC"}},"additionalProperties":false},"ResponseExampleResponseItemCustomersItemC":{"required":["id","sCcf","srcId"],"type":"object","properties":{"id":{"type":"string","enum":["abc"]},"sCcf":{"type":"string","enum":["1.3"]},"srcId":{"type":"string","enum":["1234:5678:::abc"]}},"additionalProperties":false},"Unauthorized":{"title":"Unauthorized","type":"object","properties":{"message":{"type":"string","enum":["Authorization error, please contact support."]}}},"Forbidden":{"title":"Forbidden","type":"object","properties":{"message":{"type":"string","enum":["You do not have permission to access this resource."]}}},"Throttled":{"title":"Throttled","type":"object","properties":{"message":{"type":"string","enum":["Request throttled! Try again later."]}}},"InternalError":{"title":"Internal Server Error","type":"object","properties":{"message":{"type":"string","enum":["Internal server error, please contact support."]}}}}},"paths":{"/v1/bookmakers/{bookmaker}/sub-bookmakers/{sub-bookmaker}/list":{"get":{"tags":["Endpoints"],"summary":"Retrieve All Suggested CCF values","description":"Fetches Suggested CCF values for all accounts associated with a specific bookmaker and sub-bookmaker. If there are multiple pages of results, the response may include a lastEvaluatedKey for pagination.","operationId":"Suggested CCF List","parameters":[{"name":"startKey","in":"query","description":"The response will start from a provided startKey, which is the same as lastEvaluatedKey from a previous call","schema":{"type":"string"}},{"name":"type","in":"query","description":"Get data only for certain type. Allowed values are customer, shop or terminal","schema":{"type":"string"}},{"name":"bookmaker","in":"path","description":"Identifier for the bookmaker. Generated by Sportradar, contact your OAM or CI engineer in case of any issues with obtaining the correct value.","required":true,"schema":{"type":"string"}},{"name":"sub-bookmaker","in":"path","description":"Identifier for the sub-bookmaker. Generated by Sportradar, contact your OAM or CI engineer in case of any issues with obtaining the correct value. Value * retrieves all data for a bookmaker.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestedCcfResponse"}},"application/example":{"schema":{"$ref":"#/components/schemas/ResponseExample"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"429":{"description":"Throttled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Throttled"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}}}}}}
```

## Retrieve Suggested CCF values in a Range

> Fetches Suggested CCF values for accounts under a bookmaker and sub-bookmaker whose values fall within a specified range. If there are multiple pages of results, the response may include a lastEvaluatedKey for pagination.

```json
{"openapi":"3.0.1","info":{"title":"Suggested CCF API","version":"2025-10-06T18:32:17Z"},"servers":[{"url":"https://api.insighttechservices.sportradar.com/{basePath}","variables":{"basePath":{"default":"api/sccf"}}}],"security":[{"sccf-api-req-authorizer":[]}],"components":{"securitySchemes":{"sccf-api-req-authorizer":{"type":"apiKey","description":"Bearer authentication header of the form Bearer \\<TOKEN\\>.","name":"Unused","in":"header"}},"schemas":{"SuggestedCcfResponse":{"required":["queryExecutionTime","requestId","responseItem","responseMessage","responseStatus"],"type":"object","properties":{"lastEvaluatedKey":{"type":"string"},"queryExecutionTime":{"type":"integer"},"requestId":{"type":"string"},"responseItem":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItem"},"responseMessage":{"type":"string"},"responseStatus":{"type":"string","enum":["SUCCESSFUL","VALIDATION_FAILED","ERROR","KEY_NOT_FOUND"]}}},"SuggestedCcfResponseResponseItem":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItem"}},"shops":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemShopsItem"}},"terminals":{"type":"array","items":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemTerminalsItem"}}},"additionalProperties":false},"SuggestedCcfResponseResponseItemCustomersItem":{"required":["C"],"type":"object","properties":{"C":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemCustomersItemC":{"required":["id","sCcf","srcId"],"type":"object","properties":{"id":{"type":"string"},"sCcf":{"pattern":"^(\\d{1,2}(\\.\\d{1,2})?|100(\\.00?)?)$","type":"string"},"srcId":{"type":"string"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemShopsItem":{"required":["S"],"type":"object","properties":{"S":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"SuggestedCcfResponseResponseItemTerminalsItem":{"required":["T"],"type":"object","properties":{"T":{"$ref":"#/components/schemas/SuggestedCcfResponseResponseItemCustomersItemC"}},"additionalProperties":false},"ResponseExample":{"required":["queryExecutionTime","requestId","responseItem","responseMessage","responseStatus"],"type":"object","properties":{"lastEvaluatedKey":{"type":"string","enum":["83hdf97f98f"]},"queryExecutionTime":{"type":"integer","enum":[5]},"requestId":{"type":"string","enum":["c81d9e0b-d122-4e5a-b8e1-24c6c5113419"]},"responseItem":{"$ref":"#/components/schemas/ResponseExampleResponseItem"},"responseMessage":{"type":"string","enum":["Number of items found: 1"]},"responseStatus":{"type":"string","enum":["SUCCESSFUL"]}}},"ResponseExampleResponseItem":{"type":"object","properties":{"customers":{"type":"array","items":{"$ref":"#/components/schemas/ResponseExampleResponseItemCustomersItem"}}},"additionalProperties":false},"ResponseExampleResponseItemCustomersItem":{"required":["C"],"type":"object","properties":{"C":{"$ref":"#/components/schemas/ResponseExampleResponseItemCustomersItemC"}},"additionalProperties":false},"ResponseExampleResponseItemCustomersItemC":{"required":["id","sCcf","srcId"],"type":"object","properties":{"id":{"type":"string","enum":["abc"]},"sCcf":{"type":"string","enum":["1.3"]},"srcId":{"type":"string","enum":["1234:5678:::abc"]}},"additionalProperties":false},"Unauthorized":{"title":"Unauthorized","type":"object","properties":{"message":{"type":"string","enum":["Authorization error, please contact support."]}}},"Forbidden":{"title":"Forbidden","type":"object","properties":{"message":{"type":"string","enum":["You do not have permission to access this resource."]}}},"Throttled":{"title":"Throttled","type":"object","properties":{"message":{"type":"string","enum":["Request throttled! Try again later."]}}},"InternalError":{"title":"Internal Server Error","type":"object","properties":{"message":{"type":"string","enum":["Internal server error, please contact support."]}}}}},"paths":{"/v1/bookmakers/{bookmaker}/sub-bookmakers/{sub-bookmaker}/range":{"get":{"tags":["Endpoints"],"summary":"Retrieve Suggested CCF values in a Range","description":"Fetches Suggested CCF values for accounts under a bookmaker and sub-bookmaker whose values fall within a specified range. If there are multiple pages of results, the response may include a lastEvaluatedKey for pagination.","operationId":"Suggested CCF Range","parameters":[{"name":"higher","in":"query","description":"Higher threshold of the range to retrieve data for. At least one of the lower/higher query parameter is mandatory.","schema":{"type":"string"}},{"name":"lower","in":"query","description":"Lower threshold of the range to retrieve data for. At least one of the lower/higher query parameter is mandatory.","schema":{"type":"string"}},{"name":"startKey","in":"query","description":"The response will start from a provided startKey, which is the same as lastEvaluatedKey from a previous call","schema":{"type":"string"}},{"name":"type","in":"query","description":"Get data only for certain type. Allowed values are customer, shop or terminal","schema":{"type":"string"}},{"name":"bookmaker","in":"path","description":"Identifier for the bookmaker. Generated by Sportradar, contact your OAM or CI engineer in case of any issues with obtaining the correct value.","required":true,"schema":{"type":"string"}},{"name":"sub-bookmaker","in":"path","description":"Identifier for the sub-bookmaker. Generated by Sportradar, contact your OAM or CI engineer in case of any issues with obtaining the correct value. Value * retrieves all data for a bookmaker.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestedCcfResponse"}},"application/example":{"schema":{"$ref":"#/components/schemas/ResponseExample"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthorized"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Forbidden"}}}},"429":{"description":"Throttled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Throttled"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalError"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportradar.com/itservices/models/automated-player-profiling-sccf-api/endpoints.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.