Skip to main content
← HaaS Developer Resources

Consumer Data Standards (Biza.io Edition)

Consumer Data Standards (Biza.io Edition) (1.36.3)

Download OpenAPI specification:Download

Biza.io: hello@biza.io URL: https://biza.io/ License: Commercial

This specification mirrors the definitions of the Australian Consumer Data Standards and is intended to deliver the Standards in OpenAPI 3 format with additional data specifications.

Client Registration

Dynamic Client Registration Endpoints

Register Data Recipient oAuth Client

Register a client using a CDR Register issued Software Statement Assertion. This endpoint does not require CORS.

Request Body schema: application/jwt
required

Client Registration Request

string <JWT>

The registration request JWT to be used to register with a Data Holder. The schema of the payload section of the decoded string(JWT) is defined in the CDS (but not this DSB Standards)

Responses

Response samples

Content type
application/json
{}

Get oAuth Client Registration

Get a Client Registration for a given Client ID.

Authorizations:
CDRAuth
path Parameters
clientId
required
string

The client ID issued by the target Data Holder

Responses

Response samples

Content type
application/json
{}

Update Data Recipient Registration

Update a Client Registration for a given Client ID.

Authorizations:
CDRAuth
path Parameters
clientId
required
string

The client ID issued by the target Data Holder

Request Body schema: application/jwt
required

Client Registration Request

string <JWT>

The registration request JWT to be used to register with a Data Holder. The schema of the payload section of the decoded string(JWT) is defined in the CDS (but not this DSB Standards)

Responses

Response samples

Content type
application/json
{}

Delete Data Recipient oAuth Client Registration

Delete a Client Registration for a given Client ID.

Authorizations:
CDRAuth
path Parameters
clientId
required
string

The client ID issued by the target Data Holder

Responses

Admin

Admin APIs

Get Metrics

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 v2.

Deprecated versions:

  • v3 - 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 - 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.

Authorizations:
ACCCAuth
query Parameters
period
string
Default: "ALL"
Enum: "ALL" "CURRENT" "HISTORIC"

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.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Metadata Update

Indicate that a critical update to the metadata for Accredited Data Recipients has been made and should be obtained

Authorizations:
ACCCAuth
header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Request Body schema: application/json
required

Register triggered action to perform

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
{
  • "errors": [
    ]
}

Register (Public)

Unauthenticated endpoints hosted by the Register

Get Data Holder Brands Summary

Endpoint used by participants to discover public details of Data Holder Brands from the CDR Register

path Parameters
industry
required
string
Enum: "banking" "energy" "telco" "all"

The industry the participant is retrieving for:

  • banking: Banking
  • energy: Energy
  • telco: Telecommunications
  • all: All Sectors
header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

If-None-Match
string

Makes the request method conditional on a recipient cache or origin server not having any current representation of the target resource with an entity-tag that does not match any of those listed in the field-value.

Responses

Response samples

Content type
application/json
{}

Get Data Holder Statuses

Endpoint used by participants to discover the statuses for Data Holders from the CDR Register

path Parameters
industry
required
string
Enum: "banking" "energy" "telco" "all"

The industry the participant is retrieving for:

  • banking: Banking
  • energy: Energy
  • telco: Telecommunications
  • all: All Sectors
header Parameters
x-v
string
Default: 1

The version of the API endpoint requested by the client. Must be set to a positive integer. For backwards compatibility defaults to 1 if absent. Note that once version 1 is decommissioned the header will be mandatory for a valid response to be obtained

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

If-None-Match
string

Makes the request method conditional on a recipient cache or origin server not having any current representation of the target resource with an entity-tag that does not match any of those listed in the field-value.

Responses

Response samples

Content type
application/json
{}

Get Software Products Statuses

Get Data Recipient Software Products Statuses

path Parameters
industry
required
string
Enum: "banking" "energy" "telco" "all"

The industry the participant is retrieving for:

  • banking: Banking
  • energy: Energy
  • telco: Telecommunications
  • all: All Sectors
header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The Register should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The Register should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable.

If-None-Match
string

Makes the request method conditional on a recipient cache or origin server not having any current representation of the target resource with an entity-tag that does not match any of those listed in the field-value.

Responses

Response samples

Content type
application/json
Example
{
  • "softwareProducts": [
    ]
}

Get Data Recipients Statuses

Endpoint used by participants to discover the statuses for Data Recipients from the CDR Register.

path Parameters
industry
required
string
Enum: "banking" "energy" "telco" "all"

The industry the participant is retrieving for:

  • banking: Banking
  • energy: Energy
  • telco: Telecommunications
  • all: All Sectors
header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The Register should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The Register should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable.

If-None-Match
string

Makes the request method conditional on a recipient cache or origin server not having any current representation of the target resource with an entity-tag that does not match any of those listed in the field-value.

Responses

Response samples

Content type
application/json
Example
{
  • "dataRecipients": [
    ]
}

Get Data Recipients

Endpoint used by participants to discover data recipients and associated brands and software products, available in the CDR ecosystem.

path Parameters
industry
required
string
Enum: "banking" "energy" "telco" "all"

The industry the participant is retrieving for:

  • banking: Banking
  • energy: Energy
  • telco: Telecommunications
  • all: All Sectors
header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The Register should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The Register should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable.

If-None-Match
string

Makes the request method conditional on a recipient cache or origin server not having any current representation of the target resource with an entity-tag that does not match any of those listed in the field-value.

Responses

Response samples

Content type
application/json
Example
{
  • "data": [
    ],
  • "meta": { }
}

Register (Authenticated)

Authenticated endpoints hosted by the Register

Get Data Holder Brands

Allows Data Recipients to discover Data Holder Brands available in the CDR ecosystem.

Authorizations:
RegisterAuth
path Parameters
industry
required
string
Enum: "banking" "energy" "telco" "all"

The industry the participant is retrieving for:

  • banking: Banking
  • energy: Energy
  • telco: Telecommunications
  • all: All Sectors
query Parameters
updated-since
string <date-time>

Only include items that have been updated after the specified date and time. If absent defaults to include all items.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The Register should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The Register should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
Example
{}

Get Software Statement Assertion (SSA)

Get a Software Statement Assertion (SSA) for a software product on the CDR Register to be used for Dynamic Client Registration with a Data Holder Brand.

Authorizations:
RegisterAuth
path Parameters
industry
required
string
Enum: "banking" "energy" "telco" "all"

The industry the participant is retrieving for:

  • banking: Banking
  • energy: Energy
  • telco: Telecommunications
  • all: All Sectors
dataRecipientBrandId
required
string

Unique id for the Accredited Data Recipient Brand that the Software Product is associated with in the CDR Register

softwareProductId
required
string

Unique id for the Accredited Data Recipient Software Product in the CDR Register

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The Register should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The Register should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the Register must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ]
}

Customer

Customer APIs

Get Customer

Obtain basic information on the customer that has authorised the current session. Conventions In the customer payloads relevant conventions are explained here, in one place. Given Names firstName represents the first of a person's given names middleNames represents a collection of given names if the person has more than one given name Where a data holder holds a person's given names as a single string in source systems, it may not possible in some situations to reliably split these given names into their component first and middle names. In these situations, data holders MAY use the firstName field to return the single string of given names and an empty middleNames array. For example, a person whose given names are "John Paul Winston" but the data holder cannot determine what is the first name, can return "firstName": "John Paul Winston".

Authorizations:
CDRAuth
header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Get Customer Detail

Obtain detailed information on the authorised customer within the current session.

Authorizations:
CDRAuth
header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Discovery

Discovery APIs

Get Outages

Obtain a list of scheduled outages for the implementation

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
{}

Get Status

Obtain a health check status for the implementation

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Accounts

Accounts Related APIs

Get Accounts

Obtain a list of accounts

Authorizations:
CDRAuth
query Parameters
product-category
string (EnumBankingProductCategoryV2)
Enum: "BUSINESS_LOANS" "BUY_NOW_PAY_LATER" "CRED_AND_CHRG_CARDS" "LEASES" "MARGIN_LOANS" "OVERDRAFTS" "PERS_LOANS" "REGULATED_TRUST_ACCOUNTS" "RESIDENTIAL_MORTGAGES" "TERM_DEPOSITS" "TRADE_FINANCE" "TRANS_AND_SAVINGS_ACCOUNTS" "TRAVEL_CARDS"
Example: product-category=TRANS_AND_SAVINGS_ACCOUNTS

Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

open-status
string (EnumAccountOpenStatusWithAllV1)
Default: "ALL"
Enum: "ALL" "CLOSED" "OPEN"

Used to filter results according to open/closed status. Values can be OPEN, CLOSED or ALL. If absent then ALL is assumed.

is-owned
boolean

Filters accounts based on whether they are owned by the authorised customer. true for owned accounts, false for unowned accounts and absent for all accounts.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{}

Get Account Detail

Obtain detailed information on a single account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Balances

Banking Account Balance Related APIs

Get Bulk Balances

Obtain balances for multiple, filtered accounts

Authorizations:
CDRAuth
query Parameters
product-category
string (EnumBankingProductCategoryV2)
Enum: "BUSINESS_LOANS" "BUY_NOW_PAY_LATER" "CRED_AND_CHRG_CARDS" "LEASES" "MARGIN_LOANS" "OVERDRAFTS" "PERS_LOANS" "REGULATED_TRUST_ACCOUNTS" "RESIDENTIAL_MORTGAGES" "TERM_DEPOSITS" "TRADE_FINANCE" "TRANS_AND_SAVINGS_ACCOUNTS" "TRAVEL_CARDS"
Example: product-category=TRANS_AND_SAVINGS_ACCOUNTS

Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

open-status
string (EnumAccountOpenStatusWithAllV1)
Default: "ALL"
Enum: "ALL" "CLOSED" "OPEN"

Used to filter results according to open/closed status. Values can be OPEN, CLOSED or ALL. If absent then ALL is assumed.

is-owned
boolean

Filters accounts based on whether they are owned by the authorised customer. true for owned accounts, false for unowned accounts and absent for all accounts.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Balances For Specific Banking Accounts

Obtain balances for a specified list of accounts.

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Accounts to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
{}

Get Account Balance

Obtain the balance for a single specified account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Direct Debits

Banking Direct Debits APIs

Get Bulk Direct Debits

Obtain direct debit authorisations for multiple, filtered accounts

Authorizations:
CDRAuth
query Parameters
product-category
string (EnumBankingProductCategoryV2)
Enum: "BUSINESS_LOANS" "BUY_NOW_PAY_LATER" "CRED_AND_CHRG_CARDS" "LEASES" "MARGIN_LOANS" "OVERDRAFTS" "PERS_LOANS" "REGULATED_TRUST_ACCOUNTS" "RESIDENTIAL_MORTGAGES" "TERM_DEPOSITS" "TRADE_FINANCE" "TRANS_AND_SAVINGS_ACCOUNTS" "TRAVEL_CARDS"
Example: product-category=TRANS_AND_SAVINGS_ACCOUNTS

Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

open-status
string (EnumAccountOpenStatusWithAllV1)
Default: "ALL"
Enum: "ALL" "CLOSED" "OPEN"

Used to filter results according to open/closed status. Values can be OPEN, CLOSED or ALL. If absent then ALL is assumed.

is-owned
boolean

Filters accounts based on whether they are owned by the authorised customer. true for owned accounts, false for unowned accounts and absent for all accounts.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Direct Debits For Specific Accounts

Obtain direct debit authorisations for a specified list of accounts

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Accounts to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
{}

Get Direct Debits For Account

Obtain direct debit authorisations for a specific account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Instalment Plans

Banking Instalment Plan APIs

Get Instalment Plans Bulk

Obtain the active and/or inactive instalment plans across all accounts the customer has authorised access to. The plans returned MUST be ordered according to plan creationDate in descending order. Data Holders MAY respond with 404 Resource Not Implemented if instalment plans are not applicable to any account types they support.

Authorizations:
CDRAuth
query Parameters
plan-status
string (EnumBankingInstalmentPlanStatusV1)
Default: "ACTIVE"
Enum: "ACTIVE" "INACTIVE" "ALL"

Used to filter results on the status field. Values can be ACTIVE, INACTIVE or ALL. If absent then ACTIVE is assumed. An ACTIVE plan is one in which one or more scheduled instalments has not yet been paid (i.e. isPaid is false). An INACTIVE plan is one in which all scheduled instalments have been paid (i.e. isPaid is true for every entry in the schedule).

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Instalment Plans for Account

Obtain the active and/or inactive instalment plans for a specific account. The plans returned MUST be ordered according to plan creationDate in descending order.

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

query Parameters
plan-status
string (EnumBankingInstalmentPlanStatusV1)
Default: "ACTIVE"
Enum: "ACTIVE" "INACTIVE" "ALL"

Used to filter results on the status field. Values can be ACTIVE, INACTIVE or ALL. If absent then ACTIVE is assumed. An ACTIVE plan is one in which one or more scheduled instalments has not yet been paid (i.e. isPaid is false). An INACTIVE plan is one in which all scheduled instalments have been paid (i.e. isPaid is true for every entry in the schedule).

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Payees

Banking Payee APIs

Get Payees

Obtain a list of pre-registered payees

Authorizations:
CDRAuth
query Parameters
type
string
Default: "ALL"
Enum: "ALL" "BILLER" "DIGITAL_WALLET" "DOMESTIC" "INTERNATIONAL"

Filter on the payee type field. In addition to normal type field values, ALL can be specified to retrieve all payees. If absent the assumed value is ALL.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{}

Get Payee Detail

Obtain detailed information on a single payee. Note that the payee sub-structure should be selected to represent the payment destination only rather than any known characteristics of the payment recipient

Authorizations:
CDRAuth
path Parameters
payeeId
required
string

The ID used to locate the details of a particular payee.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Products

Banking Product APIs

Get Products

Obtain a list of products that are currently openly offered to the market

Note that the results returned by this endpoint are expected to be ordered in descending order according to lastUpdated

Conventions

In the product reference payloads there are a number of recurring conventions that are explained here, in one place.

Arrays Of Features

In the product detail payload there are a number of arrays articulating generic features, constraints, prices, etc. The intent of these arrays is as follows:

  • Each element in an array has the same structure so that clients can reliably interpret the payloads
  • Each element as a type element that is an enumeration of the specific aspect of a product being described, such as types of fees.
  • Each element has a field named additionalValue. This is a generic field with contents that will vary based on the type of object being described. The contents of this field for the ADDITIONAL_CARDS feature is the number of cards allowed while the contents of this field for the MAX_LIMIT constraint would be the maximum credit limit allowed for the product.
  • An element in these arrays of the same type may appear more than once. For instance, a product may offer two separate loyalty programs that the customer can select from. A fixed term mortgage may have different rates for different term lengths.
  • An element in these arrays may contain an additionalInfo and additionalInfoUri field. The additionalInfo field is used to provide displayable text clarifying the purpose of the element in some way when the product is presented to a customer. The additionalInfoUri provides a link to externally hosted information specifically relevant to that feature of the product.
  • Depending on the type of data being represented there may be additional specific fields.

URIs To More Information

As the complexities and nuances of a financial product can not easily be fully expressed in a data structure without a high degree of complexity it is necessary to provide additional reference information that a potential customer can access so that they are fully informed of the features and implications of the product. The payloads for product reference therefore contain numerous fields that are provided to allow the product holder to describe the product more fully using a web page hosted on their online channels.

These URIs do not need to all link to different pages. If desired, they can all link to a single hosted page and use different HTML anchors to focus on a specific topic such as eligibility or fees.

Linkage To Accounts

From the moment that a customer applies for a product and an account is created the account and the product that spawned it will diverge. Rates and features of the product may change and a discount may be negotiated for the account.

For this reason, while productCategory is a common field between accounts and products, there is no specific ID that can be used to link an account to a product within the regime.

Similarly, many of the fields and objects in the product payload will appear in the account detail payload but the structures and semantics are not identical as one refers to a product that can potentially be originated and one refers to an account that actually has been instantiated and created along with the associated decisions inherent in that process.

Dates

It is expected that data consumers needing this data will call relatively frequently to ensure the data they have is representative of the current offering from a bank. To minimise the volume and frequency of these calls the ability to set a lastUpdated field with the date and time of the last update to this product is included. A call for a list of products can then be filtered to only return products that have been updated since the last time that data was obtained using the updated-since query parameter.

In addition, the concept of effective date and time has also been included. This allows for a product to be marked for obsolescence, or introduction, from a certain time without the need for an update to show that a product has been changed. The inclusion of these dates also removes the need to represent deleted products in the payload. Products that are no longer offered can be marked not effective for a few weeks before they are then removed from the product set as an option entirely.

query Parameters
effective
string (EnumEffectiveWithAllV1)
Default: "CURRENT"
Enum: "ALL" "CURRENT" "FUTURE"
Example: effective=CURRENT

Allows for the filtering of results based on whether the current time is within the period of time defined as effective by the effectiveFrom and effectiveTo fields. Valid values are β€˜CURRENT’, β€˜FUTURE’ and β€˜ALL’. If absent defaults to 'CURRENT'

updated-since
string <date-time>

Only include items that have been updated after the specified date and time. If absent defaults to include all items.

brand
string

Filter results based on a specific brand. If absent defaults to include all plans.

product-category
string (EnumBankingProductCategoryV2)
Enum: "BUSINESS_LOANS" "BUY_NOW_PAY_LATER" "CRED_AND_CHRG_CARDS" "LEASES" "MARGIN_LOANS" "OVERDRAFTS" "PERS_LOANS" "REGULATED_TRUST_ACCOUNTS" "RESIDENTIAL_MORTGAGES" "TERM_DEPOSITS" "TRADE_FINANCE" "TRANS_AND_SAVINGS_ACCOUNTS" "TRAVEL_CARDS"
Example: product-category=TRANS_AND_SAVINGS_ACCOUNTS

Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
Example
{}

Get Product Detail

Obtain detailed information on a single product offered openly to the market.

path Parameters
productId
required
string

ID of the specific product requested

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Scheduled Payments

Scheduled Payments APIs

Get Scheduled Payments for Account

Obtain scheduled, outgoing payments for a specific account.

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": {
    }
}

Get Scheduled Payments Bulk

Obtain scheduled payments for multiple, filtered accounts that are the source of funds for the payments

Authorizations:
CDRAuth
query Parameters
product-category
string (EnumBankingProductCategoryV2)
Enum: "BUSINESS_LOANS" "BUY_NOW_PAY_LATER" "CRED_AND_CHRG_CARDS" "LEASES" "MARGIN_LOANS" "OVERDRAFTS" "PERS_LOANS" "REGULATED_TRUST_ACCOUNTS" "RESIDENTIAL_MORTGAGES" "TERM_DEPOSITS" "TRADE_FINANCE" "TRANS_AND_SAVINGS_ACCOUNTS" "TRAVEL_CARDS"
Example: product-category=TRANS_AND_SAVINGS_ACCOUNTS

Used to filter results on the productCategory field applicable to accounts. Any one of the valid values for this field can be supplied. If absent then all accounts returned.

open-status
string (EnumAccountOpenStatusWithAllV1)
Default: "ALL"
Enum: "ALL" "CLOSED" "OPEN"

Used to filter results according to open/closed status. Values can be OPEN, CLOSED or ALL. If absent then ALL is assumed.

is-owned
boolean

Filters accounts based on whether they are owned by the authorised customer. true for owned accounts, false for unowned accounts and absent for all accounts.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": {
    }
}

Get Scheduled Payments For Specific Accounts

Obtain scheduled payments for a specified list of accounts.

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Accounts to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": {
    }
}

Transactions

Banking Transactions APIs

Get Transactions For Account

Obtain transactions for a specific account. Some general notes that apply to all endpoints that retrieve transactions:

  • Where multiple transactions are returned, transactions should be ordered according to effective date in descending order
  • As the date and time for a transaction can alter depending on status and transaction type two separate date/times are included in the payload. There are still some scenarios where neither of these time stamps is available. For the purpose of filtering and ordering it is expected that the data holder will use the "effective" date/time which will be defined as:
    • Posted date/time if available, then
    • Execution date/time if available, then
    • A reasonable date/time nominated by the data holder using internal data structures
  • For transaction amounts it should be assumed that a negative value indicates a reduction of the available balance on the account while a positive value indicates an increase in the available balance on the account
  • For aggregated transactions (ie. groups of sub transactions reported as a single entry for the account) only the aggregated information, with as much consistent information across the subsidiary transactions as possible, is required to be shared
Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

query Parameters
oldest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or after this date/time. Format is aligned to DateTimeString common type.

If absent defaults to the following dependent on call:

  • Banking: newest-time minus 90 days
  • Energy: newest-time minus 12 months
newest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or before this date/time. If absent defaults to current date/time. Format is aligned to DateTimeString common type.

min-amount
string

Filter transactions to only transactions with amounts higher than or equal to this amount.

max-amount
string

Filter transactions to only transactions with amounts less than or equal to this amount.

text
string

Filter transactions to only transactions where this string value is found as a substring of either the reference or description fields. Format is arbitrary ASCII string. This parameter is optionally implemented by data holders. If it is not implemented then a response should be provided as normal without text filtering applied and an additional boolean field named isQueryParamUnsupported should be included in the meta object and set to true (whether the text parameter is supplied or not)

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{}

Get Transaction Detail

Obtain detailed information on a transaction for a specific account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

transactionId
required
string

ID of the transaction obtained from a previous call to one of the other transaction endpoints.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Accounts

Energy Account Related APIs

Get Energy Accounts

Obtain the list of energy accounts available under the authorised consent

Authorizations:
CDRAuth
query Parameters
open-status
string (EnumAccountOpenStatusWithAllV1)
Default: "ALL"
Enum: "ALL" "CLOSED" "OPEN"

Used to filter results according to open/closed status. Values can be OPEN, CLOSED or ALL. If absent then ALL is assumed.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Energy Account Detail

Obtain detailed information for a specific energy account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Get Energy Account Concessions

Obtain the details of any concessions or arrangements applied to a specific energy account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Get Balance For Energy Account

Obtain the current balance for a specific energy account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Bulk Balances for Energy

Obtain the current balance for all energy accounts

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Balances For Specific Energy Accounts

Obtain the current balances for a specified list of energy accounts

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Accounts to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
{}

Distributed Energy Resources

Distributed Energy Resources

Get DER For Electricity Service Point

Obtain a list of DER data from a particular service point

Authorizations:
CDRAuth
path Parameters
servicePointId
required
string

ID of the specific service point requested. This is a tokenised ID previous obtained from the Service Point List Data endpoint. Note that it is not a nationalMeteringId.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Get Bulk DER

Obtain DER data for all service points associated with the customer

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": {
    }
}

Get DER For Specific Service Points

Obtain DER data for a specific set of service points

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Service Points to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": {
    }
}

Billing

Energy Billing Related APIs

Get Energy Account Payment Schedule

Obtain the agreed payment schedule and details, if any, for a specific energy account.

Some general notes about this endpoint:

  • This API describes how the consumer has elected to pay for their account
  • Payments initiated by the consumer are classified as manual payments. The billing frequency is captured for manual payments. The consumer may choose to pay on a different schedule/frequency. The payment method and frequency is not captured for manual payments
  • Payments that can be initiated by the retailer, based on a consumer's preferences and permission, include payments based on a direct debit, card debit or digital wallet setup. Each of these requires a payment frequency to be provided along with other relevant fields
  • Information about payment plans related to debt repayments or arrangements due to hardship is not captured within this API
Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Get Energy Account Invoices

Obtain the invoices for a specific account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

query Parameters
oldest-date
string <date>

Constrain the request to records with issue date at or after this date. If absent defaults to newest-date minus 24 months. Format is aligned to DateString common type

newest-date
string <date>

Constrain the request to records with issue date at or before this date. If absent defaults to current date. Format is aligned to DateString common type

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Bulk Invoices

Obtain the invoices for all accounts

Authorizations:
CDRAuth
query Parameters
oldest-date
string <date>

Constrain the request to records with issue date at or after this date. If absent defaults to newest-date minus 24 months. Format is aligned to DateString common type

newest-date
string <date>

Constrain the request to records with issue date at or before this date. If absent defaults to current date. Format is aligned to DateString common type

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Invoices For Specific Energy Accounts

Obtain invoices for a specified set of energy accounts

Authorizations:
CDRAuth
query Parameters
oldest-date
string <date>

Constrain the request to records with issue date at or after this date. If absent defaults to newest-date minus 24 months. Format is aligned to DateString common type

newest-date
string <date>

Constrain the request to records with issue date at or before this date. If absent defaults to current date. Format is aligned to DateString common type

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Accounts to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
{}

Get Billing for Energy Account

Obtain the billing transactions for a specific account

Authorizations:
CDRAuth
path Parameters
accountId
required
string

ID of a specific account to obtain data for. This is a tokenised ID previous obtained from the Account List endpoint.

query Parameters
oldest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or after this date/time. Format is aligned to DateTimeString common type.

If absent defaults to the following dependent on call:

  • Banking: newest-time minus 90 days
  • Energy: newest-time minus 12 months
newest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or before this date/time. If absent defaults to current date/time. Format is aligned to DateTimeString common type.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": {
    }
}

Get Bulk Billing

Obtain billing transactions for all accounts

Authorizations:
CDRAuth
query Parameters
oldest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or after this date/time. Format is aligned to DateTimeString common type.

If absent defaults to the following dependent on call:

  • Banking: newest-time minus 90 days
  • Energy: newest-time minus 12 months
newest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or before this date/time. If absent defaults to current date/time. Format is aligned to DateTimeString common type.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": {
    }
}

Get Billing for Specific Energy Accounts

Obtain billing for a specified set of accounts

Authorizations:
CDRAuth
query Parameters
oldest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or after this date/time. Format is aligned to DateTimeString common type.

If absent defaults to the following dependent on call:

  • Banking: newest-time minus 90 days
  • Energy: newest-time minus 12 months
newest-time
string <date-time>

Constrain the transaction history request to transactions with effective time at or before this date/time. If absent defaults to current date/time. Format is aligned to DateTimeString common type.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Accounts to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": {
    }
}

Plans

Energy Plans Related APIs

Get Energy Plans

Obtain a list of energy plans that are currently offered to the market. Note that the results returned by this endpoint are expected to be ordered in descending order according to lastUpdated.

query Parameters
type
string (EnumEnergyPlanTypeWithAllV1)
Default: "ALL"
Enum: "STANDING" "MARKET" "REGULATED" "ALL"
Example: type=ALL

Used to filter results on the type field. Any one of the valid values for this field can be supplied plus 'ALL'. If absent defaults to 'ALL'

fuelType
string (EnumEnergyFuelTypeWithAllV1)
Default: "ALL"
Enum: "ELECTRICITY" "GAS" "DUAL" "ALL"
Example: fuelType=ALL

Used to filter results on the fuelType field. Any one of the valid values for this field can be supplied plus 'ALL'. If absent defaults to 'ALL'

effective
string (EnumEffectiveWithAllV1)
Default: "CURRENT"
Enum: "ALL" "CURRENT" "FUTURE"
Example: effective=CURRENT

Allows for the filtering of results based on whether the current time is within the period of time defined as effective by the effectiveFrom and effectiveTo fields. Valid values are β€˜CURRENT’, β€˜FUTURE’ and β€˜ALL’. If absent defaults to 'CURRENT'

updated-since
string <date-time>

Only include items that have been updated after the specified date and time. If absent defaults to include all items.

brand
string

Filter results based on a specific brand. If absent defaults to include all plans.

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
{}

Get Energy Plan detail

Obtain detailed information on a single energy plan offered openly to the market

path Parameters
planId
required
string

ID of the specific plan requested

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Service Points

Energy Service Points Related APIs

Get Electricity Service Points

Obtain a list of service points owned by the customer that has authorised the current session

Authorizations:
CDRAuth
query Parameters
page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{}

Get Electricity Service Point Detail

Obtain detailed standing information for a specific service point that is owned by the customer that has authorised the current session

Authorizations:
CDRAuth
path Parameters
servicePointId
required
string

ID of the specific service point requested. This is a tokenised ID previous obtained from the Service Point List Data endpoint. Note that it is not a nationalMeteringId.

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "meta": { }
}

Usage

Electricity Usage Related APIs

Get Usage For Electricity Service Point

Obtain a list of electricity usage data from a particular service point

Authorizations:
CDRAuth
path Parameters
servicePointId
required
string

ID of the specific service point requested. This is a tokenised ID previous obtained from the Service Point List Data endpoint. Note that it is not a nationalMeteringId.

query Parameters
oldest-date
string <date>

Constrain the request to records with effective date at or after this date. If absent defaults to newest-date minus 24 months. Format is aligned to DateString common type

newest-date
string <date>

Constrain the request to records with effective date at or before this date. If absent defaults to current date. Format is aligned to DateString common type

interval-reads
string (EnumElectricityMeterReadIntervalReadTypeV1)
Default: "NONE"
Enum: "NONE" "MIN_30" "FULL"
Example: interval-reads=NONE

Type of interval reads. Any one of the valid values for this field can be supplied. If absent defaults to NONE

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Bulk Service Point Usage

Obtain usage data for all service points associated with the customer

Authorizations:
CDRAuth
query Parameters
interval-reads
string (EnumElectricityMeterReadIntervalReadTypeV1)
Default: "NONE"
Enum: "NONE" "MIN_30" "FULL"
Example: interval-reads=NONE

Type of interval reads. Any one of the valid values for this field can be supplied. If absent defaults to NONE

oldest-date
string <date>

Constrain the request to records with effective date at or after this date. If absent defaults to newest-date minus 24 months. Format is aligned to DateString common type

newest-date
string <date>

Constrain the request to records with effective date at or before this date. If absent defaults to current date. Format is aligned to DateString common type

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Responses

Response samples

Content type
application/json
{}

Get Usage For Specific Service Points

Obtain the electricity usage data for a specific set of service points

Authorizations:
CDRAuth
query Parameters
oldest-date
string <date>

Constrain the request to records with effective date at or after this date. If absent defaults to newest-date minus 24 months. Format is aligned to DateString common type

newest-date
string <date>

Constrain the request to records with effective date at or before this date. If absent defaults to current date. Format is aligned to DateString common type

interval-reads
string (EnumElectricityMeterReadIntervalReadTypeV1)
Default: "NONE"
Enum: "NONE" "MIN_30" "FULL"
Example: interval-reads=NONE

Type of interval reads. Any one of the valid values for this field can be supplied. If absent defaults to NONE

page
integer >= 1
Default: 1

Page of results to request (standard pagination).

page-size
integer >= 1
Default: 25

Page size to request. Default is 25 (standard pagination).

header Parameters
x-v
required
string

Version of the API endpoint requested by the client. Must be set to a positive integer. The data holder should respond with the highest supported version between x-min-v and x-v. If the value of x-min-v is equal to or higher than the value of x-v then the x-min-v header should be treated as absent. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable. See HTTP Headers

x-min-v
string

Minimum version of the API endpoint requested by the client. Must be set to a positive integer if provided. The data holder should respond with the highest supported version between x-min-v and x-v. If all versions requested are not supported then the data holder must respond with a 406 Not Acceptable.

x-fapi-interaction-id
string <uuid>
Example: 6ba7b814-9dad-11d1-80b4-00c04fd430c8

An RFC4122 UUID used as a correlation id. If provided, the data holder must play back this value in the x-fapi-interaction-id response header. If not provided a RFC4122 UUID value is required to be provided in the response header to track the interaction.

x-fapi-auth-date
string
Example: Thu, 16 Jan 2020 16:50:15 GMT

The time when the customer last logged in to the Data Recipient Software Product as described in FAPI-1.0-Baseline. Required for all resource calls (customer present and unattended). Not required for unauthenticated calls.

x-fapi-customer-ip-address
string
Example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334

The customer's original IP address if the customer is currently logged in to the Data Recipient Software Product. The presence of this header indicates that the API is being called in a customer present context. Not to be included for unauthenticated calls.

x-cds-client-headers
string
Example: TW96aWxsYS81LjAgKFgxMTsgTGludXggeDg2XzY0KSBBcHBsZVdlYktpdC81MzcuMzYgKEtIVE1MLCBsaWtlIEdlY2tvKSBDaHJvbWUvNzkuMC4zOTQ1Ljg4IFNhZmFyaS81MzcuMzY=

The customer's original standard http headers Base64 encoded, including the original User-Agent header, if the customer is currently logged in to the Data Recipient Software Product. Mandatory for customer present calls. Not required for unattended or unauthenticated calls.

Request Body schema: application/json
required

Request payload containing list of specific Service Points to obtain data for

required
object
meta
object

Responses

Request samples

Content type
application/json
{
  • "data": {
    },
  • "meta": { }
}

Response samples

Content type
application/json
{}