{"openapi":"3.0.0","info":{"description":"## Overview\n\nThis API provides third parties with details of a consent that they have been granted by an end user.\nThird parties can use this API to check the status and expiry time of a consent.","title":"Consent Details Service","version":"1.0.19","x-ibm-name":"premium-consent-details-service"},"servers":[{"url":"https://api.rabobank.nl/openapi/oauth2-premium","description":"Production server"},{"url":"https://api-sandbox.rabobank.nl/openapi/sandbox/oauth2-premium","description":"Sandbox server"}],"paths":{"/v1/consents/{consentId}":{"get":{"parameters":[{"description":"The Consent Id can be found in the metadata field of the /token endpoint in the oauth api.","example":"bdf7e270-aae6-4a72-877d-95f2c7803db8","in":"path","name":"consentId","required":true,"schema":{"type":"string"}},{"description":"ClientId as provided by the Rabobank developer portal.","example":"616281c5-daca-439c-872f-816ed8302a49","in":"header","name":"X-IBM-Client-Id","required":true,"schema":{"type":"string"}},{"description":"ID of the request, unique to the call, as determined by the initiating party. Format is UUID v4.","example":"594d27d0-26d7-47dc-9d62-c307616220b6","in":"header","name":"X-Request-ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Consent"}}},"description":"Successfully retrieved consent details"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tppMessages"}}},"description":"Unauthorized"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/tppMessages"}}},"description":"Consent Not Found"},"500":{"description":"Internal Server Error"}},"description":"Returns the scope and products associated with the consent object","operationId":"getConsentByConsentId","summary":"Get consent details"}}},"components":{"schemas":{"AccountReference":{"description":"Details of consented products","properties":{"currency":{"description":"Currency code, as per ISO 4217.","example":"EUR","type":"string"},"iban":{"description":"An International Bank Account Number, as per ISO 13616.","example":"NL01RABO0123456789","type":"string"},"status":{"description":"status of the consent.","example":"valid","type":"string","x-extensible-enum":["valid","expired","revokedByPsu","terminatedByTpp","received","rejected"]},"validUntil":{"description":"Date at which this consent expires, as per section 5.6 of RFC 3339.","example":"9999-12-31","type":"string"}},"required":["currency","iban","status","validUntil"],"type":"object"},"Consent":{"description":"Consent details object","properties":{"access":{"additionalProperties":{"items":{"$ref":"#/components/schemas/AccountReference"},"type":"array"},"description":"An associative array relating scopes (field names) to consented products (values).","example":{"bai.accountinformation.read":[{"currency":"EUR","iban":"NL64RABO0125607016","status":"valid","validUntil":"9999-12-31"},{"currency":"EUR","iban":"NL64RABO0125607017","status":"revokedByPsu","validUntil":"9999-12-31"}]},"type":"object"},"consentId":{"description":"consent Id.","example":"011b375e-d866-4b43-9847-4812cccbab29","type":"string"}},"required":["access","consentId"],"type":"object"},"messageCodeText":{"example":"CERTIFICATE_INVALID","type":"string","x-extensible-enum":["CERTIFICATE_INVALID","SIGNATURE_INVALID","FORMAT_ERROR","SERVICE_BLOCKED","CONSENT_UNKNOWN","CONSENT_INVALID","CONSENT_EXPIRED"]},"tppMessageCategory":{"description":"Category of the message","example":"ERROR","type":"string","x-extensible-enum":["ERROR","WARNING"]},"tppMessageGeneric":{"properties":{"category":{"$ref":"#/components/schemas/tppMessageCategory"},"code":{"$ref":"#/components/schemas/messageCodeText"},"path":{"example":"/consent","type":"string"},"text":{"$ref":"#/components/schemas/tppMessageText"}},"required":["category","code"],"type":"object"},"tppMessageText":{"description":"Additional text.","example":"Header X-Request-ID is required","maxLength":512,"type":"string"},"tppMessages":{"description":"Messages on operational issues.","properties":{"tppMessages":{"items":{"$ref":"#/components/schemas/tppMessageGeneric"},"type":"array"}},"type":"object"}},"securitySchemes":{"clientId":{"description":"ClientId as provided by the Rabobank developer portal.","in":"header","name":"X-IBM-Client-Id","type":"apiKey"}}},"security":[{"clientId":[]}],"x-readme":{"explorer-enabled":false,"proxy-enabled":false}}