Skip to main content
Consent records

List consent history of the individual

GET/v4/service/consent/individual/record/consent-record/history

Lists the consent changes of the individual over all data agreements, newest first, one page at a time. Each entry has a log line that says the new value, the purpose and the organisation in words. Use it to show the individual what they changed and when. The entries stay after "Delete all consent records of the individual".

Authorizations

  • Authorizationstringheaderrequired

    Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.

    Scope:consent-records:read

Query parameters

  • offsetinteger

    Number of records to skip for pagination. A negative or unreadable value falls back to 0.

    At least 0.

    Default:0

  • limitinteger

    Maximum number of records to return per page.

    Default:10

Headers

  • X-ConsentBB-IndividualIdstring

    ID of the individual, or its externalId. Mandatory with an API key: without it the answer is 400 ("IndividualId is not present in request header"), and an unknown individual gets 400 too. With an individual token, leave it out: the server takes the individual from the token. Send it only on the routes that list it: with an API key that has resource scopes (for example consent-records:read), another route answers 400 to a request with this header.

    Example:"6af081b138e8f33dcf799628"

Response

application/json

One page of history entries.

  • consentRecordHistoryobject[]
  • paginationobject