# Regulations

## Supported Regulations

The Didomi API and SDK currently provide consent notices for the regulations outlined in the following table:

<table><thead><tr><th width="380.3333333333333">Regulation</th><th width="141">Regulation ID</th><th>Default Country/Region</th></tr></thead><tbody><tr><td>General Data Protection Regulation (GDPR)</td><td><code>gdpr</code></td><td>AD, AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GF, GG, GI, GP, GR, HR, HU, IE, IS, IT, JE, LI, LT, LU, LV, MC, MF, MQ, MT, NL, NO, PL, PT, RE, RO, SE, SI, SK, SM, VA, YT</td></tr><tr><td>California Privacy Rights Act (CPRA)</td><td><code>cpra</code></td><td>US_CA</td></tr><tr><td>Colorado Privacy Act (CPA)</td><td><code>cpa</code></td><td>US_CO</td></tr><tr><td>Connecticut Data Privacy Act (CTDPA)</td><td><code>ctdpa</code></td><td>US_CT</td></tr><tr><td>Virginia Consumer Data Protection Act (VCDPA)</td><td><code>vcdpa</code></td><td>US_VA</td></tr></tbody></table>

`Regulation ID` refers to the internal identifier or acronym utilized within the SDK configuration objects.

`Default Country/Region` column lists geo-location codes (based on ISO country/region standards) which are employed to automatically determine the display of a specific regulation based on the visitor's location.

For further information on using the API to handle multi-regulation notices and their associated configuration objects, please refer to the [Multi-Regulation Configurations](/api-and-platform/widgets/consent-notices/multi-reg-configurations.md) guide.

## Compliance API

The Compliance API is designed to inform you about the various privacy regulations supported by Didomi.

It offers detailed insights into each privacy law, including its status, full name, and the legal frameworks it supports.

Additionally, the API provides information about the countries and regions where each regulation is applicable, making it a comprehensive resource for understanding global compliance requirements.

### Regulations available

| Regulation                                    | ID      |
| --------------------------------------------- | ------- |
| General Data Protection Regulation (GDPR)     | `gdpr`  |
| California Privacy Rights Act (CPRA)          | `cpra`  |
| Colorado Privacy Act (CPA)                    | `cpa`   |
| Connecticut Data Privacy Act (CTDPA)          | `ctdpa` |
| Virginia Consumer Data Protection Act (VCDPA) | `vcdpa` |

### Get available regulations and related information

To retrieve the regulations supported by Didomi, send a GET request on `/compliance/v1/regulations?$search[releaseStatus]=stable`.

{% hint style="danger" %}
Consents must only be collected for regulations that are supported.
{% endhint %}

```json
GET https://api.didomi.io/compliance/v1/regulations?$search[releaseStatus]=stable
```

#### Response

```json
{
    "data": [
				{
            "id": "gdpr",
            "archived": false,
	    "geos": [
		{
                    "country": {
                        "id": "FR",
                        "name": "France"
                    },
                    "region": {
                        "id": "*",
                        "name": "All"
                    }
                },
	        ...
	    ],
	    "name": "General Data Protection Regulation",
            "frameworks": [
                "iab"
            ],
            "platforms": [
                "amp",
                "app",
                "ctv",
                "web"
            ],
            "regulation_type": "optin",
            "release_status": "stable",
				},
        {
            "id": "cpa",
            "archived": false,
	    "geos": [
                {
                    "country": {
                        "id": "US",
                        "name": "United States"
                    },
                    "region": {
                        "id": "CO",
                        "name": "Colorado"
                    }
                }
            ],
            "name": "Colorado Privacy Act",
	    "release_status": "beta"
        },
	...
    ]
}
```

### Regulation schema

The full schema of Regulations is as follows.

```json

{
   /**
    * A unique identifier
    */      
    "id": "String",
    
   /**
    * Whether this regulation is archived or not
    */      
    "archived": Boolean,
    
   /**
    * Regulations geolocations that the regulation 
    * is associated with (jurisdiction)
    */      
    "geos": [
        {
            "country": {
            
               /**
                * Contains the 2-letter ISO 3166-1 
                * alpha-2 country codes
                */              
                "id": "String",
                
               /**
                * Country name
                */                  
                "name": "String"
            },
            "region": {
            
                /**
                 * Contains a code (up to three characters) 
                 * that represent the viewer's region. 
                 * The region is the first-level subdivision 
                 * (the broadest or least specific) 
                 * of the ISO 3166-2 code.
                 */              
                "id": "String",
                
                /**
                 * Region name that corresponds to the code
                 */                  
                "name": "String"
            }
        }
    ],
    
   /**
    * The name of the regulation
    */      
    "name": "String",
    
   /**
    * The frameworks supported by the regulation
    */      
    "frameworks": [],
    
   /**
    * The platforms supported by the regulation
    * Are supported: amp, app, ctv, web
    */      
    "platforms": [
        "String"
    ],
    
   /**
    * The regulation type associated with the group
    * Possible values: disclose, mixed, optin, optout
    */      
    "regulation_type": "String",
    
   /**
    * The release status of the regulation. 
    * Only regulations in a stable status 
    * are intended to be used in production.
    * Possible status: stable, release-candidate, beta, alpha
    */      
    "release_status": "String",
    
   /**
    * User rights linked to the regulation
    */      
    "user_rights": []
},

```


---

# 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://developers.didomi.io/api-and-platform/data-manager/regulations.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.