Skip to main content

List Invoices

Describes the List Energy Invoices call.

Purpose​

The purpose of this endpoint is to deliver invoice information related to a specific Principal (principalId) and a set of Account(s) (accountIds).

This Data Adapter endpoint is used to deliver the responses for the following Consumer Data Standards endpoints:

tip

You can find CDR error mapping after each CDS endpoint on this page.

Data Adapter API​

List Energy Account Invoices​

Loading...

Β 


Consumer Data Standards Associations​

Get Energy Account Invoices​

Loading...

Β 

CDR Error Mapping​

TitleStatus CodeAdapter URN - Error CodeDetailCDR Status CodeCDR URN - Error Code
Invalid Field400urn:au-cds:error:cds-all:Field/Invalid

Applies when the value of required path parameter, i.e. principalId is an invalid type or the value violates the field's constraints.
Invalid format supplied for accountIds.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Header400urn:au-cds:error:cds-all:Header/Invalid

Applies when a HTTP Header is provided but the value provided is an invalid type or violates the field type constraints as defined in the Consumer Data Standards.
x-fapi-interaction-id - If supplied, it must be a Universal Unique Identifier (UUID) and compliant with RFC4122. If not supplied, a compliant value is autogenerated.
Invalid format supplied for
x-fapi-interaction-id.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Date400urn:au-cds:error:cds-all:Field/InvalidDateTime

Applies when the value of the parameter oldest-date or newest-date is of an invalid type.
An invalid date is provided.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Page Size400urn:au-cds:error:cds-all:Field/InvalidPageSizeApplies when the value of the parameter page is an invalid type or violates ANY of the field's constraints.500urn:au-cds:error:cds-all:GeneralError/Unexpected
Missing Required Field400urn:au-cds:error:cds-all: Field/Missing

Applies when the required query parameter is not supplied in the request. The request is missing a mandatory field required for the API.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Expected Error400urn:au-cds:error:cds-all:GeneralError/ExpectedThis status code indicates that the Expected Error has encountered.500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Resource404urn:au-cds:error:cds-all:Resource/InvalidThe requested resource identifier is permanently unavailable.404urn:au-cds:error:cds-all:Resource/Invalid
Invalid Page422urn:au-cds:error:cds-all: Field/InvalidPage

Applies when the value of the parameter page violates ANY of the field's constraints.
The page being requested is out of range.

422urn:au-cds:error:cds-all: Field/InvalidPage
Legal Block451urn:dio:error:cds-all:Resource/LegalBlockThis status code indicates that the server is denying access to the resource as a consequence of a legal demand.422urn:au-cds:error:cds-all:Resource/Unavailable
Ineligible Block451urn:dio:error:cds-all:Resource/IneligibleBlockThis status code indicates that the Customer is ineligible for CDR Data Sharing.422urn:au-cds:error:cds-all:Resource/Invalid
Call Center Block451urn:dio:error:cds-all:Resource/CallCenterBlockThis status code indicates that the consumer should call the Call Center for further information.422urn:au-cds:error:cds-all:Resource/Invalid
Internal Server Error500urn:au-cds:error:cds-all:GeneralError/UnexpectedThis status code indicates that the server encountered an internal error or misconfiguration.500urn:au-cds:error:cds-all:GeneralError/Unexpected

Get Bulk Invoices​

Loading...

Β 

CDR Error Mapping​

TitleStatus CodeAdapter URN - Error CodeDetailCDR Status CodeCDR URN - Error Code
Invalid Field400urn:au-cds:error:cds-all:Field/Invalid

Applies when the value of required path parameter, i.e. principalId is an invalid type or the value violates the field's constraints.
Invalid format supplied for accountIds.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Header400urn:au-cds:error:cds-all:Header/Invalid

Applies when a HTTP Header is provided but the value provided is an invalid type or violates the field type constraints as defined in the Consumer Data Standards.
x-fapi-interaction-id - If supplied, it must be a Universal Unique Identifier (UUID) and compliant with RFC4122. If not supplied, a compliant value is autogenerated.
Invalid format supplied for
x-fapi-interaction-id.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Date400urn:au-cds:error:cds-all:Field/InvalidDateTime

Applies when the value of the parameter oldest-date or newest-date is of an invalid type.
An invalid date is provided.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Page Size400urn:au-cds:error:cds-all:Field/InvalidPageSizeApplies when the value of the parameter page is an invalid type or violates ANY of the field's constraints.500urn:au-cds:error:cds-all:GeneralError/Unexpected
Missing Required Field400urn:au-cds:error:cds-all: Field/Missing

Applies when the required query parameter is not supplied in the request. The request is missing a mandatory field required for the API.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Expected Error400urn:au-cds:error:cds-all:GeneralError/ExpectedThis status code indicates that the Expected Error has encountered.500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Resource404urn:au-cds:error:cds-all:Resource/InvalidThe requested resource identifier is permanently unavailable.404urn:au-cds:error:cds-all:Resource/Invalid
Invalid Page422urn:au-cds:error:cds-all: Field/InvalidPage

Applies when the value of the parameter page violates ANY of the field's constraints.
The page being requested is out of range.

422urn:au-cds:error:cds-all: Field/InvalidPage
Legal Block451urn:dio:error:cds-all:Resource/LegalBlockThis status code indicates that the server is denying access to the resource as a consequence of a legal demand.422urn:au-cds:error:cds-all:Resource/Unavailable
Ineligible Block451urn:dio:error:cds-all:Resource/IneligibleBlockThis status code indicates that the Customer is ineligible for CDR Data Sharing.422urn:au-cds:error:cds-all:Resource/Invalid
Call Center Block451urn:dio:error:cds-all:Resource/CallCenterBlockThis status code indicates that the consumer should call the Call Center for further information.422urn:au-cds:error:cds-all:Resource/Invalid
Internal Server Error500urn:au-cds:error:cds-all:GeneralError/UnexpectedThis status code indicates that the server encountered an internal error or misconfiguration.500urn:au-cds:error:cds-all:GeneralError/Unexpected

Get Invoices For Specific Energy Accounts​

Loading...

Β 

CDR Error Mapping​

TitleStatus CodeAdapter URN - Error CodeDetailCDR Status CodeCDR URN - Error Code
Invalid Field400urn:au-cds:error:cds-all:Field/Invalid

Applies when the value of required path parameter, i.e. principalId is an invalid type or the value violates the field's constraints.
Invalid format supplied for accountIds.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Header400urn:au-cds:error:cds-all:Header/Invalid

Applies when a HTTP Header is provided but the value provided is an invalid type or violates the field type constraints as defined in the Consumer Data Standards.
x-fapi-interaction-id - If supplied, it must be a Universal Unique Identifier (UUID) and compliant with RFC4122. If not supplied, a compliant value is autogenerated.
Invalid format supplied for
x-fapi-interaction-id.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Date400urn:au-cds:error:cds-all:Field/InvalidDateTime

Applies when the value of the parameter oldest-date or newest-date is of an invalid type.
An invalid date is provided.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Page Size400urn:au-cds:error:cds-all:Field/InvalidPageSizeApplies when the value of the parameter page is an invalid type or violates ANY of the field's constraints.500urn:au-cds:error:cds-all:GeneralError/Unexpected
Missing Required Field400urn:au-cds:error:cds-all: Field/Missing

Applies when the required query parameter is not supplied in the request. The request is missing a mandatory field required for the API.

500urn:au-cds:error:cds-all:GeneralError/Unexpected
Expected Error400urn:au-cds:error:cds-all:GeneralError/ExpectedThis status code indicates that the Expected Error has encountered.500urn:au-cds:error:cds-all:GeneralError/Unexpected
Invalid Resource404urn:au-cds:error:cds-all:Resource/InvalidThe requested resource identifier is permanently unavailable.404urn:au-cds:error:cds-all:Resource/Invalid
Invalid Page422urn:au-cds:error:cds-all: Field/InvalidPage

Applies when the value of the parameter page violates ANY of the field's constraints.
The page being requested is out of range.

422urn:au-cds:error:cds-all: Field/InvalidPage
Legal Block451urn:dio:error:cds-all:Resource/LegalBlockThis status code indicates that the server is denying access to the resource as a consequence of a legal demand.422urn:au-cds:error:cds-all:Resource/Unavailable
Ineligible Block451urn:dio:error:cds-all:Resource/IneligibleBlockThis status code indicates that the Customer is ineligible for CDR Data Sharing.422urn:au-cds:error:cds-all:Resource/Invalid
Call Center Block451urn:dio:error:cds-all:Resource/CallCenterBlockThis status code indicates that the consumer should call the Call Center for further information.422urn:au-cds:error:cds-all:Resource/Invalid
Internal Server Error500urn:au-cds:error:cds-all:GeneralError/UnexpectedThis status code indicates that the server encountered an internal error or misconfiguration.500urn:au-cds:error:cds-all:GeneralError/Unexpected

Β 


Supplemental Fields​

No supplemental fields are specified.

Endpoint Specific Guidance​

  • The Data Adapter call is made with an accountIds filter at all times as this endpoint is not used prior to an arrangement being established