openapi: 3.2.0 info: contact: email: contact@dsb.gov.au name: Data Standards Body url: https://dsb.gov.au/ description: Specifications for admin endpoints applicable to all data holders (except secondary data holders). license: name: MIT License url: https://opensource.org/licenses/MIT title: CDR Admin Data Holder Admin API version: 1.36.0 servers: - description: MTLS url: https://mtls.dh.example.com/cds-au/v1 tags: - description: Data Holder Admin endpoints name: Data Holder Admin x-shortName: Admin paths: /admin/register/metadata: post: description: Indicate that a critical update to the metadata for Accredited Data Recipients has been made and should be obtained. operationId: metadataUpdate parameters: - description: Version of the API endpoint requested by the client. Must be set to a positive integer. The endpoint should respond with the highest supported version between [_x-min-v_](#request-headers) and [_x-v_](#request-headers). If the value of [_x-min-v_](#request-headers) is equal to or higher than the value of [_x-v_](#request-headers) then the [_x-min-v_](#request-headers) header should be treated as absent. If all versions requested are not supported then the endpoint should respond with a `406 Not Acceptable`. See [HTTP Headers](#request-headers). explode: false in: header name: x-v required: true schema: type: string style: simple - description: Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The endpoint should respond with the highest supported version between [_x-min-v_](#request-headers) and [_x-v_](#request-headers). If all versions requested are not supported then the endpoint should respond with a `406 Not Acceptable`. explode: false in: header name: x-min-v required: false schema: type: string style: simple requestBody: $ref: '#/components/requestBodies/RequestMetaDataUpdate' responses: '200': content: application/json: schema: {} description: Successful response headers: x-v: $ref: '#/components/headers/XV' '400': content: application/json: schema: $ref: '#/components/schemas/ResponseErrorListV2' description: The following error codes **MUST** be supported:
'406': content: application/json: schema: $ref: '#/components/schemas/ResponseErrorListV2' description: The following error codes **MUST** be supported:
summary: Metadata Update tags: - Data Holder Admin x-scopes: - admin:metadata:update x-restricted-access: REGISTER x-version: '1' /admin/metrics: get: description: 'This endpoint allows the ACCC to obtain operational statistics from the Data Holder (at the Data Holder Brand level) on the operation of their CDR compliant implementation. The statistics obtainable from this endpoint are determined by the non-functional requirements for the CDR regime. This endpoint is not required to be implemented by the Australian Energy Market Operator, the Australian Energy Regulator or the Department of State administered by the Minister of Victoria administering the National Electricity (Victoria) Act 2005 (Vic). NOTE: This version **MUST** be implemented by **May 13th 2024** Obsolete versions: [v1](includes/obsolete/get-metrics-v1.html) [v2](includes/obsolete/get-metrics-v2.html). Deprecated versions: - [v3](includes/obsolete/get-metrics-v3.html) - Implementation not required for Data Holders going live on, or after, 1st November 2023. Other Data Holders **MAY** retire this version from the earlier of **13th May 2024** or from the time the ACCC announce that they no longer call this version - [v4](includes/obsolete/get-metrics-v4.html) - This version, or v5, **MUST** be implemented by **November 1st 2023**. If the Data Holder supports `private_key_jwt` client authentication they **MUST** validate the scope.' operationId: getMetrics parameters: - description: The period of metrics to be requested. Values can be `CURRENT` (meaning metrics for current period, dependent on the metric type), `HISTORIC` (meaning metrics for previous period, depending on the metric type) or `ALL`. If absent the default is `ALL`. explode: true in: query name: period required: false schema: default: ALL enum: - CURRENT - HISTORIC - ALL type: string style: form - description: Version of the API endpoint requested by the client. Must be set to a positive integer. The endpoint should respond with the highest supported version between [_x-min-v_](#request-headers) and [_x-v_](#request-headers). If the value of [_x-min-v_](#request-headers) is equal to or higher than the value of [_x-v_](#request-headers) then the [_x-min-v_](#request-headers) header should be treated as absent. If all versions requested are not supported then the endpoint should respond with a `406 Not Acceptable`. See [HTTP Headers](#request-headers). explode: false in: header name: x-v required: true schema: type: string style: simple - description: Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The endpoint should respond with the highest supported version between [_x-min-v_](#request-headers) and [_x-v_](#request-headers). If all versions requested are not supported then the endpoint should respond with a `406 Not Acceptable`. explode: false in: header name: x-min-v required: false schema: type: string style: simple responses: '200': content: application/json: schema: $ref: '#/components/schemas/ResponseMetricsListV5' description: Successful response headers: x-v: $ref: '#/components/headers/XV' '400': content: application/json: schema: $ref: '#/components/schemas/ResponseErrorListV2' description: The following error codes **MUST** be supported:
'406': content: application/json: schema: $ref: '#/components/schemas/ResponseErrorListV2' description: The following error codes **MUST** be supported:
summary: Get Metrics tags: - Data Holder Admin x-scopes: - admin:metrics.basic:read x-restricted-access: REGISTER x-version: '5' components: schemas: InvocationMetricsV3_highPriority: description: API call counts for the high priority tier. properties: currentDay: description: API call counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: API call counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AvailabilityMetricsV2_unauthenticated: description: Availability metrics for the unauthenticated aspects of the CDR regime. properties: currentMonth: description: Percentage availability of the CDR platform so far for the current calendar month. `0.0` means 0%. `1.0` means 100%. Must be a positive value or zero. type: string x-cds-type: RateString previousMonths: description: Percentage availability of the CDR platform for previous calendar months. The first element indicates the last month and so on. A maximum of twelve entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: type: string x-cds-type: RateString type: array type: object x-conditional: - currentMonth - previousMonths PeakTPSMetricsV2_aggregate: description: Aggregate peak transactions per second, over time, for all endpoints. properties: currentDay: description: Peak TPS for current day. Must be a positive value or zero. type: number previousDays: description: Peak TPS for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. Values must be a positive or zero. items: type: number type: array type: object x-conditional: - currentDay - previousDays RejectionMetricsV3_authenticated: description: Rejection counts for all authenticated endpoints. properties: currentDay: description: Number of calls rejected for current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of calls rejected for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AverageResponseMetricsV2_unattended: description: Average response time for the unattended tier. properties: currentDay: description: Average response time for current day. type: number previousDays: description: Average response time for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: number type: array type: object x-conditional: - currentDay - previousDays InvocationMetricsV3: description: Number of API calls in each performance tier, over time. properties: unauthenticated: $ref: '#/components/schemas/InvocationMetricsV3_unauthenticated' highPriority: $ref: '#/components/schemas/InvocationMetricsV3_highPriority' lowPriority: $ref: '#/components/schemas/InvocationMetricsV3_lowPriority' unattended: $ref: '#/components/schemas/InvocationMetricsV3_unattended' largePayload: $ref: '#/components/schemas/InvocationMetricsV3_largePayload' secondary: $ref: '#/components/schemas/InvocationMetricsV3_secondary' largeSecondary: $ref: '#/components/schemas/InvocationMetricsV3_largeSecondary' required: - highPriority - largePayload - lowPriority - unattended - unauthenticated type: object x-conditional: - secondary - largeSecondary AverageTPSMetricsV2_authenticated: description: Average transactions per second, over time, for authenticated endpoints. properties: currentDay: description: Average TPS for current day. Must be a positive value or zero. type: number previousDays: description: Average TPS for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. Values must be a positive or zero. items: type: number type: array type: object x-conditional: - currentDay - previousDays SecondaryHolderMetricsV2_rejections: description: Number of calls rejected due to traffic thresholds, over time. properties: currentDay: description: Number of rejections for current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of rejections for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays InvocationMetricsV3_lowPriority: description: API call counts for the low priority tier. properties: currentDay: description: API call counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: API call counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AverageResponseMetricsV2_secondary_secondary: description: Average response time as measured for the secondary data holder. properties: currentDay: description: Average response time for current day. type: number previousDays: description: Average response time for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: number type: array type: object x-conditional: - currentDay - previousDays AvailabilityMetricsV2_authenticated: description: Availability metrics for the authenticated aspects of the CDR regime. properties: currentMonth: description: Percentage availability of the CDR platform so far for the current calendar month. `0.0` means 0%. `1.0` means 100%. Must be a positive value or zero. type: string x-cds-type: RateString previousMonths: description: Percentage availability of the CDR platform for previous calendar months. The first element indicates the last month and so on. A maximum of twelve entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: type: string x-cds-type: RateString type: array type: object x-conditional: - currentMonth - previousMonths PerformanceMetricsV3_largeSecondary_primary: description: Percentage of large Shared Responsibility calls within the performance thresholds for the secondary data holder. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2: description: Authorisation counts for the data holder. properties: activeAuthorisationCount: $ref: '#/components/schemas/AuthorisationMetricsV2_activeAuthorisationCount' newAuthorisationCount: $ref: '#/components/schemas/AuthorisationMetricsV2_newAuthorisationCount' revokedAuthorisationCount: $ref: '#/components/schemas/AuthorisationMetricsV2_revokedAuthorisationCount' amendedAuthorisationCount: $ref: '#/components/schemas/AuthorisationMetricsV2_amendedAuthorisationCount' expiredAuthorisationCount: $ref: '#/components/schemas/AuthorisationMetricsV2_expiredAuthorisationCount' abandonedConsentFlowCount: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonedConsentFlowCount' abandonmentsByStage: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonmentsByStage' required: - abandonedConsentFlowCount - abandonmentsByStage - activeAuthorisationCount - amendedAuthorisationCount - expiredAuthorisationCount - newAuthorisationCount - revokedAuthorisationCount type: object AverageTPSMetricsV2_aggregate: description: Aggregate average transactions per second, over time, for all endpoints. properties: currentDay: description: Average TPS for current day. Must be a positive value or zero. type: number previousDays: description: Average TPS for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. Values must be a positive or zero. items: type: number type: array type: object x-conditional: - currentDay - previousDays ErrorMetricsV2: description: Number of calls resulting in error, over time. properties: aggregate: $ref: '#/components/schemas/ErrorMetricsV2_aggregate' unauthenticated: $ref: '#/components/schemas/ErrorMetricsV2_unauthenticated' authenticated: $ref: '#/components/schemas/ErrorMetricsV2_authenticated' required: - aggregate - authenticated - unauthenticated type: object AuthorisationMetricsV2_amendedAuthorisationCount_currentDay: description: Number of amended authorisations for the current day. properties: individual: description: Amended authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: Amended authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object AuthorisationMetricsV2_revokedAuthorisationCount: description: The number of revoked authorisations. properties: currentDay: $ref: '#/components/schemas/AuthorisationMetricsV2_revokedAuthorisationCount_currentDay' previousDays: description: Number of revoked authorisations for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: $ref: '#/components/schemas/AuthorisationMetricsV2_revokedAuthorisationCount_previousDays' type: array type: object x-conditional: - currentDay - previousDays AverageResponseMetricsV2: description: Average response time in seconds, at millisecond resolution, within each performance tier. properties: unauthenticated: $ref: '#/components/schemas/AverageResponseMetricsV2_unauthenticated' highPriority: $ref: '#/components/schemas/AverageResponseMetricsV2_highPriority' lowPriority: $ref: '#/components/schemas/AverageResponseMetricsV2_lowPriority' unattended: $ref: '#/components/schemas/AverageResponseMetricsV2_unattended' largePayload: $ref: '#/components/schemas/AverageResponseMetricsV2_largePayload' secondary: $ref: '#/components/schemas/AverageResponseMetricsV2_secondary' largeSecondary: $ref: '#/components/schemas/AverageResponseMetricsV2_largeSecondary' required: - highPriority - largePayload - lowPriority - unattended - unauthenticated type: object x-conditional: - secondary - largeSecondary InvocationMetricsV3_largeSecondary: description: API call counts for the large Shared Responsibility Data Requests tier. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster. properties: currentDay: description: API call counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: API call counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays PerformanceMetricsV3_unauthenticated: description: Percentage of unauthenticated calls within the performance thresholds. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays ResponseMetricsListV5: properties: data: $ref: '#/components/schemas/ResponseMetricsListV5_data' links: $ref: '#/components/schemas/Links' meta: $ref: '#/components/schemas/Meta' required: - data - links type: object AuthorisationMetricsV2_abandonmentsByStage: description: Customer abandonment count per stage of the consent flow. Note that the aggregated abandonment count for all stages for a period should equal the count in _abandonedConsentFlowCount_ for the same period (i.e. each abandoned consent should assigned to one, and only one, stage). properties: preIdentification: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonmentsByStage_preIdentification' preAuthentication: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonmentsByStage_preAuthentication' preAccountSelection: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonmentsByStage_preAccountSelection' preAuthorisation: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonmentsByStage_preAuthorisation' rejected: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonmentsByStage_rejected' failedTokenExchange: $ref: '#/components/schemas/AuthorisationMetricsV2_abandonmentsByStage_failedTokenExchange' required: - failedTokenExchange - preAccountSelection - preAuthentication - preAuthorisation - preIdentification - rejected type: object InvocationMetricsV3_unauthenticated: description: API call counts for the unauthenticated tier. properties: currentDay: description: API call counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: API call counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays ResponseMetricsListV5_data: properties: requestTime: description: The date and time that the metrics in this payload were requested. type: string x-cds-type: DateTimeString availability: $ref: '#/components/schemas/AvailabilityMetricsV2' performance: $ref: '#/components/schemas/PerformanceMetricsV3' invocations: $ref: '#/components/schemas/InvocationMetricsV3' averageResponse: $ref: '#/components/schemas/AverageResponseMetricsV2' sessionCount: $ref: '#/components/schemas/SessionCountMetricsV2' averageTps: $ref: '#/components/schemas/AverageTPSMetricsV2' peakTps: $ref: '#/components/schemas/PeakTPSMetricsV2' errors: $ref: '#/components/schemas/ErrorMetricsV2' rejections: $ref: '#/components/schemas/RejectionMetricsV3' customerCount: description: Number of customers with active authorisations at the time of the call. type: integer x-cds-type: NaturalNumber recipientCount: description: Number of Data Recipient Software Products with active authorisations at the time of the call. type: integer x-cds-type: NaturalNumber secondaryHolder: $ref: '#/components/schemas/SecondaryHolderMetricsV2' authorisations: $ref: '#/components/schemas/AuthorisationMetricsV2' required: - authorisations - availability - averageResponse - averageTps - customerCount - errors - invocations - peakTps - performance - recipientCount - rejections - requestTime - sessionCount type: object x-conditional: - secondaryHolder PerformanceMetricsV3_lowPriority: description: Percentage of low priority calls within the performance thresholds. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_abandonmentsByStage_preAuthentication: description: The number of authorisations where the customer identified themselves (i.e. they successfully identify the customer profile to use for the authorisation) but failed to provide a valid OTP or equivalent. properties: currentDay: description: Number of abandoned consent flows for this stage for the current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of abandoned consent flows for this stage for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays ErrorV2: properties: code: description: The code of the error encountered. Where the error is specific to the respondent, an application-specific error code, expressed as a string value. If the error is application-specific, the URN code that the specific error extends must be provided in the _meta_ object. Otherwise, the value is the error code URN. type: string title: description: A short, human-readable summary of the problem that **MUST NOT** change from occurrence to occurrence of the problem represented by the error code. type: string detail: description: A human-readable explanation specific to this occurrence of the problem. type: string meta: $ref: '#/components/schemas/ErrorV2_meta' required: - code - detail - title type: object x-conditional: - meta AuthorisationMetricsV2_amendedAuthorisationCount_previousDays: properties: individual: description: Amended authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: Amended authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object AverageResponseMetricsV2_secondary: description: Average response time for the secondary tier. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster. properties: primary: $ref: '#/components/schemas/AverageResponseMetricsV2_secondary_primary' secondary: $ref: '#/components/schemas/AverageResponseMetricsV2_secondary_secondary' required: - primary - secondary type: object AuthorisationMetricsV2_expiredAuthorisationCount_previousDays: properties: individual: description: Expired authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: Expired authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object ErrorMetricsV2_authenticated: description: Number of calls resulting in error for authenticated endpoints. properties: currentDay: additionalProperties: description: 'This is a placeholder field to be substituted with each respective HTTP error code in the 4xx and 5xx range recorded by the Data Holder. It is represented by _property1_ and _property2_ in the _Non-normative Examples_ section. Note that the property name **MUST** be the three-digit HTTP error code as per the adjacent _500_ example. All possible property names have not been defined as the range is expected to vary across participants. Examples would include, but are not limited to: _400, 401, 403, 404, 405, 406, 415, 422, 429, 500, 503, 504_.' type: integer x-cds-type: NaturalNumber description: Error counts, by HTTP error code, for current day. properties: '500': description: Reflecting the description provided in the adjacent _additionalProperties_ field, this is an example demonstrating the structure for reporting the number of calls resulting in HTTP error code `500`. Each error code recorded by the Data Holder in the 4xx and 5xx range **MUST** be provided in this format against the respective property name. type: integer x-cds-type: NaturalNumber type: object previousDays: description: Error counts, by HTTP error code, for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: additionalProperties: description: 'This is a placeholder field to be substituted with each respective HTTP error code in the 4xx and 5xx range recorded by the Data Holder. It is represented by _property1_ and _property2_ in the _Non-normative Examples_ section. Note that the property name **MUST** be the three-digit HTTP error code as per the adjacent _500_ example. All possible property names have not been defined as the range is expected to vary across participants. Examples would include, but are not limited to: _400, 401, 403, 404, 405, 406, 415, 422, 429, 500, 503, 504_.' type: integer x-cds-type: NaturalNumber properties: '500': description: Reflecting the description provided in the adjacent _additionalProperties_ field, this is an example demonstrating the structure for reporting the number of calls resulting in HTTP error code `500`. Each error code recorded by the Data Holder in the 4xx and 5xx range **MUST** be provided in this format against the respective property name. type: integer x-cds-type: NaturalNumber type: object type: array type: object x-conditional: - currentDay - previousDays RequestMetaDataUpdateV1_data: properties: action: default: REFRESH description: The action to take for the meta data. At the moment the only option is `REFRESH` which requires the data holder to call the ACCC to refresh meta data as soon as practicable. enum: - REFRESH type: string required: - action type: object AverageTPSMetricsV2: description: Average transactions per second, over time. properties: aggregate: $ref: '#/components/schemas/AverageTPSMetricsV2_aggregate' unauthenticated: $ref: '#/components/schemas/AverageTPSMetricsV2_unauthenticated' authenticated: $ref: '#/components/schemas/AverageTPSMetricsV2_authenticated' required: - aggregate - authenticated - unauthenticated type: object InvocationMetricsV3_secondary: description: API call counts for the Shared Responsibility Data Requests tier. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster. properties: currentDay: description: API call counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: API call counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays ResponseErrorListV2: properties: errors: description: List of errors. items: $ref: '#/components/schemas/ErrorV2' type: array required: - errors type: object AuthorisationMetricsV2_abandonmentsByStage_rejected: description: The number of authorisations where the customer actively rejected the authorisation rather than abandoning the process. properties: currentDay: description: Number of abandoned consent flows for this stage for the current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of abandoned consent flows for this stage for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AvailabilityMetricsV2: description: Availability metrics. properties: aggregate: $ref: '#/components/schemas/AvailabilityMetricsV2_aggregate' unauthenticated: $ref: '#/components/schemas/AvailabilityMetricsV2_unauthenticated' authenticated: $ref: '#/components/schemas/AvailabilityMetricsV2_authenticated' required: - aggregate - authenticated - unauthenticated type: object AverageResponseMetricsV2_largeSecondary: description: Average response time for the large payload tier. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster. properties: primary: $ref: '#/components/schemas/AverageResponseMetricsV2_secondary_primary' secondary: $ref: '#/components/schemas/AverageResponseMetricsV2_secondary_secondary' required: - primary - secondary type: object PeakTPSMetricsV2: description: Peak transactions per second, over time. properties: aggregate: $ref: '#/components/schemas/PeakTPSMetricsV2_aggregate' unauthenticated: $ref: '#/components/schemas/PeakTPSMetricsV2_unauthenticated' authenticated: $ref: '#/components/schemas/PeakTPSMetricsV2_authenticated' required: - aggregate - authenticated - unauthenticated type: object PeakTPSMetricsV2_authenticated: description: Peak transactions per second, over time, for authenticated endpoints. properties: currentDay: description: Peak TPS for current day. Must be a positive value or zero. type: number previousDays: description: Peak TPS for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. Values must be a positive or zero. items: type: number type: array type: object x-conditional: - currentDay - previousDays PerformanceHours: description: Percentage of calls within the performance threshold for the specified hour. `0.0` means 0%. `1.0` means 100%. Must be a positive value or zero. type: string x-cds-type: RateString ErrorV2_meta: description: Additional data for customised error codes. properties: urn: description: The CDR error code URN which the application-specific error code extends. Mandatory if the error _code_ is an application-specific error rather than a standardised error code. type: string type: object x-conditional: - urn PerformanceMetricsV3_secondary: description: Percentage of Shared Responsibility calls within the performance thresholds. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster. properties: primary: $ref: '#/components/schemas/PerformanceMetricsV3_secondary_primary' secondary: $ref: '#/components/schemas/PerformanceMetricsV3_secondary_secondary' required: - primary - secondary type: object PerformanceMetricsV3: description: Percentage of calls within the performance thresholds in each performance tier, over time. properties: aggregate: $ref: '#/components/schemas/PerformanceMetricsV3_aggregate' highPriority: $ref: '#/components/schemas/PerformanceMetricsV3_highPriority' largePayload: $ref: '#/components/schemas/PerformanceMetricsV3_largePayload' lowPriority: $ref: '#/components/schemas/PerformanceMetricsV3_lowPriority' unattended: $ref: '#/components/schemas/PerformanceMetricsV3_unattended' unauthenticated: $ref: '#/components/schemas/PerformanceMetricsV3_unauthenticated' secondary: $ref: '#/components/schemas/PerformanceMetricsV3_secondary' largeSecondary: $ref: '#/components/schemas/PerformanceMetricsV3_largeSecondary' required: - highPriority - largePayload - lowPriority - unattended - unauthenticated type: object x-conditional: - secondary - largeSecondary AuthorisationMetricsV2_newAuthorisationCount: description: The number of new authorisations. properties: currentDay: $ref: '#/components/schemas/AuthorisationMetricsV2_newAuthorisationCount_currentDay' previousDays: description: Number of new authorisations for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: $ref: '#/components/schemas/AuthorisationMetricsV2_newAuthorisationCount_previousDays' type: array type: object x-conditional: - currentDay - previousDays Meta: type: object AuthorisationMetricsV2_abandonmentsByStage_failedTokenExchange: description: The number of authorisations that completed the interactive flow with the consumer authorising the consent, but the ADR failed to - or was unable to - obtain a refresh or access token using the authorisation code. properties: currentDay: description: Number of abandoned consent flows for this stage for the current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of abandoned consent flows for this stage for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays PerformanceMetricsV3_secondary_secondary: description: Percentage of Shared Responsibility calls within the performance thresholds for the secondary data holder. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays AverageResponseMetricsV2_highPriority: description: Average response time for the high priority tier. properties: currentDay: description: Average response time for current day. type: number previousDays: description: Average response time for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: number type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_newAuthorisationCount_currentDay_onceOff: description: New authorisation count for once-off authorisations. properties: individual: description: New authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: New authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object AuthorisationMetricsV2_revokedAuthorisationCount_currentDay: description: Number of revoked authorisations for the current day. properties: individual: description: Revoked authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: Revoked authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object PerformanceMetricsV3_largePayload: description: Percentage of large payload calls within the performance thresholds. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays AverageResponseMetricsV2_secondary_primary: description: Average response time as measured for the primary data holder. properties: currentDay: description: Average response time for current day. type: number previousDays: description: Average response time for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: number type: array type: object x-conditional: - currentDay - previousDays ErrorMetricsV2_unauthenticated: description: Number of calls resulting in error for unauthenticated endpoints. properties: currentDay: additionalProperties: description: 'This is a placeholder field to be substituted with each respective HTTP error code in the 4xx and 5xx range recorded by the Data Holder. It is represented by _property1_ and _property2_ in the _Non-normative Examples_ section. Note that the property name **MUST** be the three-digit HTTP error code as per the adjacent _500_ example. All possible property names have not been defined as the range is expected to vary across participants. Examples would include, but are not limited to: _400, 404, 405, 406, 415, 422, 429, 500, 503, 504_.' type: integer x-cds-type: NaturalNumber description: Error counts, by HTTP error code, for current day. properties: '500': description: Reflecting the description provided in the adjacent _additionalProperties_ field, this is an example demonstrating the structure for reporting the number of calls resulting in HTTP error code `500`. Each error code recorded by the Data Holder in the 4xx and 5xx range **MUST** be provided in this format against the respective property name. type: integer x-cds-type: NaturalNumber type: object previousDays: description: Error counts, by HTTP error code, for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: additionalProperties: description: 'This is a placeholder field to be substituted with each respective HTTP error code in the 4xx and 5xx range recorded by the Data Holder. It is represented by _property1_ and _property2_ in the _Non-normative Examples_ section. Note that the property name **MUST** be the three-digit HTTP error code as per the adjacent _500_ example. All possible property names have not been defined as the range is expected to vary across participants. Examples would include, but are not limited to: _400, 404, 405, 406, 415, 422, 429, 500, 503, 504_.' type: integer x-cds-type: NaturalNumber properties: '500': description: Reflecting the description provided in the adjacent _additionalProperties_ field, this is an example demonstrating the structure for reporting the number of calls resulting in HTTP error code `500`. Each error code recorded by the Data Holder in the 4xx and 5xx range **MUST** be provided in this format against the respective property name. type: integer x-cds-type: NaturalNumber type: object type: array type: object x-conditional: - currentDay - previousDays InvocationMetricsV3_unattended: description: API call counts for the unattended tier. properties: currentDay: description: API call counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: API call counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays SecondaryHolderMetricsV2_errors: description: Number of calls resulting in error due to server execution, over time. properties: currentDay: description: Number of errors for current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of errors for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays InvocationMetricsV3_largePayload: description: API call counts for the large payload tier. properties: currentDay: description: API call counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: API call counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays PerformanceMetricsV3_secondary_primary: description: Percentage of Shared Responsibility calls within the performance thresholds for the primary data holder. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_newAuthorisationCount_currentDay: description: Number of new authorisations for the current day. properties: onceOff: $ref: '#/components/schemas/AuthorisationMetricsV2_newAuthorisationCount_currentDay_onceOff' ongoing: $ref: '#/components/schemas/AuthorisationMetricsV2_newAuthorisationCount_currentDay_ongoing' required: - onceOff - ongoing type: object AuthorisationMetricsV2_revokedAuthorisationCount_previousDays: properties: individual: description: Revoked authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: Revoked authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object AuthorisationMetricsV2_expiredAuthorisationCount: description: The number of expired ongoing authorisations. properties: currentDay: $ref: '#/components/schemas/AuthorisationMetricsV2_expiredAuthorisationCount_currentDay' previousDays: description: Number of expired authorisations for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: $ref: '#/components/schemas/AuthorisationMetricsV2_expiredAuthorisationCount_previousDays' type: array type: object x-conditional: - currentDay - previousDays PerformanceMetricsV3_largeSecondary: description: Percentage of large Shared Responsibility calls within the performance thresholds. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster. properties: primary: $ref: '#/components/schemas/PerformanceMetricsV3_largeSecondary_primary' secondary: $ref: '#/components/schemas/PerformanceMetricsV3_largeSecondary_primary' required: - primary - secondary type: object PeakTPSMetricsV2_unauthenticated: description: Peak transactions per second, over time, for unauthenticated endpoints. properties: currentDay: description: Peak TPS for current day. Must be a positive value or zero. type: number previousDays: description: Peak TPS for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. Values must be a positive or zero. items: type: number type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_abandonmentsByStage_preAccountSelection: description: The number of authorisations where the customer successfully authenticated with a valid OTP or equivalent but abandoned the process before selecting accounts. properties: currentDay: description: Number of abandoned consent flows for this stage for the current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of abandoned consent flows for this stage for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AvailabilityMetricsV2_aggregate: description: Aggregated availability metrics. properties: currentMonth: description: Percentage availability of the CDR platform so far for the current calendar month. `0.0` means 0%. `1.0` means 100%. Must be a positive value or zero. type: string x-cds-type: RateString previousMonths: description: Percentage availability of the CDR platform for previous calendar months. The first element indicates the last month and so on. A maximum of twelve entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: type: string x-cds-type: RateString type: array type: object x-conditional: - currentMonth - previousMonths AuthorisationMetricsV2_abandonmentsByStage_preAuthorisation: description: The number of authorisations where the customer has passed the account selection step but abandoned the process before approving or rejecting the consent being requested. properties: currentDay: description: Number of abandoned consent flows for this stage for the current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of abandoned consent flows for this stage for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays Links: properties: self: description: Fully qualified link to this API call. type: string x-cds-type: URIString required: - self type: object AverageResponseMetricsV2_lowPriority: description: Average response time for the low priority tier. properties: currentDay: description: Average response time for current day. type: number previousDays: description: Average response time for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: number type: array type: object x-conditional: - currentDay - previousDays PerformanceMetricsV3_highPriority: description: Percentage of high priority calls within the performance thresholds. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays AverageTPSMetricsV2_unauthenticated: description: Average transactions per second, over time, for unauthenticated endpoints. properties: currentDay: description: Average TPS for current day. Must be a positive value or zero. type: number previousDays: description: Average TPS for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. Values must be a positive or zero. items: type: number type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_activeAuthorisationCount: description: The number of active ongoing authorisations. properties: individual: description: Active ongoing authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: Active ongoing authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object RejectionMetricsV3_unauthenticated: description: Rejection counts for all unauthenticated endpoints. properties: currentDay: description: Number of calls rejected for current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of calls rejected for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_newAuthorisationCount_currentDay_ongoing: description: New authorisation count for ongoing authorisations. properties: individual: description: New authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: New authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object RequestMetaDataUpdateV1: properties: data: $ref: '#/components/schemas/RequestMetaDataUpdateV1_data' meta: $ref: '#/components/schemas/Meta' required: - data type: object AuthorisationMetricsV2_newAuthorisationCount_previousDays: properties: onceOff: $ref: '#/components/schemas/AuthorisationMetricsV2_newAuthorisationCount_currentDay_onceOff' ongoing: $ref: '#/components/schemas/AuthorisationMetricsV2_newAuthorisationCount_currentDay_ongoing' required: - onceOff - ongoing type: object RejectionMetricsV3: description: Number of calls rejected due to traffic thresholds, over time. properties: authenticated: $ref: '#/components/schemas/RejectionMetricsV3_authenticated' unauthenticated: $ref: '#/components/schemas/RejectionMetricsV3_unauthenticated' required: - authenticated - unauthenticated type: object SecondaryHolderMetricsV2: description: Errors and rejections received by the primary data holder from the secondary data holder. Mandatory for data holders designated for a Shared Responsibility Data Request data cluster. properties: errors: $ref: '#/components/schemas/SecondaryHolderMetricsV2_errors' rejections: $ref: '#/components/schemas/SecondaryHolderMetricsV2_rejections' required: - errors - rejections type: object PerformanceMetricsV3_unattended: description: Percentage of unattended calls within the performance thresholds. properties: currentDay: description: Array of contiguous hourly metrics for the current day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: $ref: '#/components/schemas/PerformancePreviousDays' type: array type: object x-conditional: - currentDay - previousDays ErrorMetricsV2_aggregate: description: Aggregate number of calls resulting in error due to server execution, over time, for all endpoints. properties: currentDay: description: Error counts for current day. type: integer x-cds-type: NaturalNumber previousDays: description: Error counts for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_expiredAuthorisationCount_currentDay: description: Number of expired authorisations for the current day. properties: individual: description: Expired authorisation count for individual customers. type: integer x-cds-type: NaturalNumber nonIndividual: description: Expired authorisation count for non-individual customers. type: integer x-cds-type: NaturalNumber required: - individual - nonIndividual type: object AverageResponseMetricsV2_unauthenticated: description: Average response time for the unauthenticated tier. properties: currentDay: description: Average response time for current day. type: number previousDays: description: Average response time for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: number type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_amendedAuthorisationCount: description: The number of amended ongoing authorisations. properties: currentDay: $ref: '#/components/schemas/AuthorisationMetricsV2_amendedAuthorisationCount_currentDay' previousDays: description: Number of amended authorisations for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: $ref: '#/components/schemas/AuthorisationMetricsV2_amendedAuthorisationCount_previousDays' type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_abandonedConsentFlowCount: description: The number of consents flows that were not successfully authorised. properties: currentDay: description: Number of consents flows that were not successfully authorised for the current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of consents flows that were not successfully authorised for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays AuthorisationMetricsV2_abandonmentsByStage_preIdentification: description: The number of authorisations that commenced with the data holder but the customer did not successfully identify their profile or user ID. properties: currentDay: description: Number of abandoned consent flows for this stage for the current day. type: integer x-cds-type: NaturalNumber previousDays: description: Number of abandoned consent flows for this stage for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays SessionCountMetricsV2: description: Session counts, over time. Note that a session is defined as the provisioning of an Access Token. properties: currentDay: description: Session count for current day. type: integer x-cds-type: NaturalNumber previousDays: description: Session count for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: integer x-cds-type: NaturalNumber type: array type: object x-conditional: - currentDay - previousDays PerformanceMetricsV3_aggregate: description: Percentage of calls within Primary Data Holder performance thresholds. Note that Secondary Data Holder performance **MUST** be excluded from this metric. properties: currentDay: description: Percentage of calls within the performance threshold for the current day. `0.0` means 0%. `1.0` means 100%. Must be a positive value or zero. type: string x-cds-type: RateString previousDays: description: Percentage of calls within the performance threshold for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. `0.0` means 0%. `1.0` means 100%. Values must be a positive or zero. items: type: string x-cds-type: RateString type: array type: object x-conditional: - currentDay - previousDays AverageResponseMetricsV2_largePayload: description: Average response time for the large payload tier. properties: currentDay: description: Average response time for current day. type: number previousDays: description: Average response time for previous days. The first element indicates yesterday and so on. A maximum of seven entries is required if available. items: type: number type: array type: object x-conditional: - currentDay - previousDays PerformancePreviousDays: description: Array of contiguous hourly metrics for the specified day. Each element represents a 1 hour period starting from 12am-1am. Timezone for determining 12am must be consistent but is at the discretion of the Data Holder. items: $ref: '#/components/schemas/PerformanceHours' type: array requestBodies: RequestMetaDataUpdate: content: application/json: schema: $ref: '#/components/schemas/RequestMetaDataUpdateV1' required: true headers: XV: description: The [payload version](#response-headers) that the endpoint has responded with. explode: false required: true schema: type: string style: simple