> For the complete documentation index, see [llms.txt](https://fusionauth.io/docs/llms.txt)

# Retrieve a User Consent

API documentation for the FusionAuth Retrieve a User Consent API.

# Retrieve a User Consent

This API is used to retrieve a single User Consent by unique Id or all of User's Consents by user Id.

## Request

[!API Key Authentication](https://fusionauth.io/docs/apis/authentication.md#api-key-authentication)

Retrieve all of a User's Consents

GET/api/user/consent?userId={userId}

OpenAPI Spec

[!API Key Authentication](https://fusionauth.io/docs/apis/authentication.md#api-key-authentication)

Retrieve a User Consent by Id

GET/api/user/consent/{userConsentId}

OpenAPI Spec

### Request Parameters

`userId`UUIDoptional

The unique Id of the User to retrieve User Consents for.

`userConsentId`UUIDoptional

The unique Id of the User Consent to retrieve.

## Response

The response for this API contains either a single User Consent or all of a User's Consents. When you call this API with an Id the response will contain a single Consent. When you call this API with the `userId` query parameter, the response will contain all of the User's Consents. Both response types are defined below along with an example JSON response.

*Response Codes*

| Code | Description |
| --- | --- |
| 200 | The request was successful. The response will contain a JSON body. |
| 400 | The request was invalid and/or malformed. The response will contain an [Errors](https://fusionauth.io/docs/apis/errors.md) JSON Object with the specific errors. This status will also be returned if a paid FusionAuth license is required and is not present. |
| 401 | You did not supply a valid Authorization header. The header was omitted or your API key was not valid. The response will be empty. See [Authentication](https://fusionauth.io/docs/apis/authentication.md). |
| 404 | The object you requested doesn't exist. The response will be empty. |
| 500 | There was an internal error. A stack trace is provided and logged in the FusionAuth log files. The response will be empty. |
| 503 | The search index is not available or encountered an exception so the request cannot be completed. The response will contain a JSON body. |

#### Response Body

`userConsent.consent`Object

The Consent object represented by the **consentId** field.

`userConsent.consentId`UUID

The Id of the Consent being granted to the User.

`userConsent.giverUserId`UUID

The Id of the User giving consent. When providing self-consent the **giverUserId** will be the same as the **userId**.

`userConsent.id`UUID

The unique Id of the User consent.

`userConsent.insertInstant`Long

The [instant](https://fusionauth.io/docs/reference/data-types.md#instants) when the User consent was granted.

`userConsent.lastUpdateInstant`Long

The [instant](https://fusionauth.io/docs/reference/data-types.md#instants) when the User consent was last updated.

`userConsent.status`String

The current status of the User consent. Possible values are:

*   `Active`
*   `Revoked`

`userConsent.userId`UUID

The Id of the User receiving consent. When providing self-consent the **giverUserId** will be the same as the **userId**.

`userConsent.values`Array<String>

The consent values to be associated with this User consent.

*Example Response JSON*

```json
{
  "userConsent": {
    "consent": {
      "consentEmailTemplateId": "61cba163-2d53-4d2d-ad7f-801c27f0c277",
      "countryMinimumAgeForSelfConsent": {
        "de": 21
      },
      "defaultMinimumAgeForSelfConsent": 18,
      "emailPlus": {
        "enabled": true,
        "emailTemplateId": "9cd65fca-5aa0-4861-899b-8712d8ec963f",
        "maximumTimeToSendEmailInHours": 48,
        "minimumTimeToSendEmailInHours": 24
      },
      "id": "d512b9b8-876f-4b5e-81f0-3e180b6ea485",
      "multipleValuesAllowed": false,
      "name": "Patient Consent",
      "values": [
        "Written",
        "Verbal"
      ]
    },
    "consentId": "d512b9b8-876f-4b5e-81f0-3e180b6ea485",
    "giverUserId": "605e88b7-a2fb-40b8-9c94-0123c0f6a70c",
    "id": "674b5cd8-482a-43c9-986e-f9764bbee01d",
    "insertInstant": 1562180786558,
    "lastUpdateInstant": 1562180786558,
    "status": "Active",
    "userId": "841d8b33-bf4d-488d-9f2f-2f50d769c3d2",
    "values": [
      "Written"
    ]
  }
}
```

#### Response Body

`userConsents[x].consent`Object

The Consent object represented by the **consentId** field.

`userConsents[x].consentId`UUID

The Id of the Consent being granted to the User.

`userConsents[x].giverUserId`UUID

The Id of the User giving consent. When providing self-consent the **giverUserId** will be the same as the **userId**.

`userConsents[x].id`UUID

The unique Id of the User consent.

`userConsents[x].insertInstant`Long

The [instant](https://fusionauth.io/docs/reference/data-types.md#instants) when the User consent was granted.

`userConsents[x].lastUpdateInstant`Long

The [instant](https://fusionauth.io/docs/reference/data-types.md#instants) when the User consent was last updated.

`userConsents[x].status`String

The current status of the User consent. Possible values are:

*   `Active`
*   `Revoked`

`userConsents[x].userId`UUID

The Id of the User receiving consent. When providing self-consent the **giverUserId** will be the same as the **userId**.

`userConsents[x].values`Array<String>

The consent values to be associated with this User consent.

*Example Response JSON*

```json
{
  "userConsents": [
    {
      "consent": {
        "consentEmailTemplateId": "61cba163-2d53-4d2d-ad7f-801c27f0c277",
        "countryMinimumAgeForSelfConsent": {
          "de": 21
        },
        "defaultMinimumAgeForSelfConsent": 18,
        "emailPlus": {
          "enabled": true,
          "emailTemplateId": "9cd65fca-5aa0-4861-899b-8712d8ec963f",
          "maximumTimeToSendEmailInHours": 48,
          "minimumTimeToSendEmailInHours": 24
        },
        "id": "d512b9b8-876f-4b5e-81f0-3e180b6ea485",
        "multipleValuesAllowed": false,
        "name": "Patient Consent",
        "values": [
          "Written",
          "Verbal"
        ]
      },
      "consentId": "d512b9b8-876f-4b5e-81f0-3e180b6ea485",
      "giverUserId": "605e88b7-a2fb-40b8-9c94-0123c0f6a70c",
      "id": "674b5cd8-482a-43c9-986e-f9764bbee01d",
      "insertInstant": 1562180786558,
      "lastUpdateInstant": 1562180786558,
      "status": "Active",
      "userId": "841d8b33-bf4d-488d-9f2f-2f50d769c3d2",
      "values": [
        "Written"
      ]
    }
  ]
}
```