> For the complete documentation index, see [llms.txt](https://docs.terragon.io/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.terragon.io/documents/terragon-api-document/responsiblegaming.md).

# ResponsibleGaming

Responsible gaming controls

## Get betting limits

> Retrieve betting limits for the current player

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"ResponsibleGaming","description":"Responsible gaming controls"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BettingLimit":{"type":"object","properties":{"id":{"type":"integer","description":"Betting limit ID"},"player_id":{"type":"integer","description":"Player ID"},"limit_type":{"type":"string","enum":["deposit","loss","wager"],"description":"Type of limit"},"period_type":{"type":"string","enum":["daily","weekly","monthly"],"description":"Period for the limit"},"amount":{"type":"number","format":"float","description":"Limit amount"},"currency_code":{"type":"string","description":"Currency code"},"created_at":{"type":"string","format":"date-time","description":"Betting limit creation timestamp"}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/betting-limits":{"get":{"tags":["ResponsibleGaming"],"summary":"Get betting limits","description":"Retrieve betting limits for the current player","operationId":"getBettingLimits","responses":{"200":{"description":"Betting limits retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BettingLimit"}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Set betting limit

> Set a new betting limit for the current player

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"ResponsibleGaming","description":"Responsible gaming controls"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"BettingLimit":{"type":"object","properties":{"id":{"type":"integer","description":"Betting limit ID"},"player_id":{"type":"integer","description":"Player ID"},"limit_type":{"type":"string","enum":["deposit","loss","wager"],"description":"Type of limit"},"period_type":{"type":"string","enum":["daily","weekly","monthly"],"description":"Period for the limit"},"amount":{"type":"number","format":"float","description":"Limit amount"},"currency_code":{"type":"string","description":"Currency code"},"created_at":{"type":"string","format":"date-time","description":"Betting limit creation timestamp"}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string","description":"Error message"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Validation errors by field"}}}}},"paths":{"/v1/betting-limits":{"post":{"tags":["ResponsibleGaming"],"summary":"Set betting limit","description":"Set a new betting limit for the current player","operationId":"setBettingLimit","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["limit_type","period_type","amount","currency_code"],"properties":{"limit_type":{"type":"string","enum":["deposit","loss","wager"],"description":"Type of limit"},"period_type":{"type":"string","enum":["daily","weekly","monthly"],"description":"Period for the limit"},"amount":{"type":"number","format":"float","description":"Limit amount"},"currency_code":{"type":"string","description":"Currency code"}}}}}},"responses":{"201":{"description":"Betting limit set successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BettingLimit"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}}}}}
```

## Remove betting limit

> Remove a betting limit for the current player

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"ResponsibleGaming","description":"Responsible gaming controls"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/betting-limits/{id}":{"delete":{"tags":["ResponsibleGaming"],"summary":"Remove betting limit","description":"Remove a betting limit for the current player","operationId":"removeBettingLimit","parameters":[{"name":"id","in":"path","required":true,"description":"Betting limit ID","schema":{"type":"integer"}}],"responses":{"204":{"description":"Betting limit removed successfully"},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Betting limit not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Set self-exclusion

> Set a self-exclusion period for the current player

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"ResponsibleGaming","description":"Responsible gaming controls"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SelfExclusion":{"type":"object","properties":{"id":{"type":"integer","description":"Self-exclusion ID"},"player_id":{"type":"integer","description":"Player ID"},"period_type":{"type":"string","enum":["24_hours","7_days","30_days","90_days","6_months","permanent"],"description":"Exclusion period"},"reason":{"type":"string","description":"Reason for self-exclusion"},"started_at":{"type":"string","format":"date-time","description":"Exclusion start timestamp"},"ends_at":{"type":"string","format":"date-time","description":"Exclusion end timestamp"},"is_active":{"type":"boolean","description":"Whether the exclusion is currently active"},"created_at":{"type":"string","format":"date-time","description":"Self-exclusion creation timestamp"}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}},"ValidationError":{"type":"object","properties":{"message":{"type":"string","description":"Error message"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Validation errors by field"}}}}},"paths":{"/v1/exclusives":{"post":{"tags":["ResponsibleGaming"],"summary":"Set self-exclusion","description":"Set a self-exclusion period for the current player","operationId":"setSelfExclusion","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["period_type"],"properties":{"period_type":{"type":"string","enum":["24_hours","7_days","30_days","90_days","6_months","permanent"],"description":"Exclusion period"},"reason":{"type":"string","description":"Reason for self-exclusion"}}}}}},"responses":{"201":{"description":"Self-exclusion set successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelfExclusion"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"}}}}}}}}}
```

## Get exclusion period types

> Retrieve available self-exclusion period types

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"ResponsibleGaming","description":"Responsible gaming controls"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/exclusives/period-types":{"get":{"tags":["ResponsibleGaming"],"summary":"Get exclusion period types","description":"Retrieve available self-exclusion period types","operationId":"getExclusionPeriodTypes","responses":{"200":{"description":"Exclusion period types retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Period type ID"},"name":{"type":"string","description":"Period type name"},"description":{"type":"string","description":"Period type description"}}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```