Versions Compared

Old Version 6

changes.mady.by.user Que Nguyen

Saved on

compared with

New Version 7

changes.mady.by.user Que Nguyen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Table of Contents
stylenone

Changelogs

Version

Date

Changes by

Description of change

V1.0

Mar 29, 2024

Que Nguyen

  • Add Table of Contents.

  • Add Changelogs.

V1.0.1

Apr 11, 2024

Que Nguyen

  • Add Release Status

Release status

Environment

Status

Released Date

Version

DEV

Status
colourBlue
titleNOT RELEASED

N/A

N/A

UAT

Status
colourBlue
titleNOT RELEASED

N/A

N/A

PROD

Status
colourBlue
titleNOT RELEASED

N/A

N/A

API Definition

Query REC Inventory

Resource information

Response format(s)

JSON

Requires authentication?

Yes using API key

Request Header

Name

Value

Content-Type

application/json

Authorization

Bearer {{token}}

Query Parameters

ItemsPerPage

  • numeric

  • query

The total items that return in the response

PageCurrentPage

  • numeric

  • query

Request field for pagination. The Page that you wish to view

Registries

  • array[string]

  • query

Filter the items by Registry

  • IREC

  • TIGR

DeviceId

  • uuid

  • string(36)

Device unique identifier

Returns

Get REC Inventory

Response Header

Content-Type

application/json

Response Body

Field

Type

Description

Id

uuid

REC Unique Identifier

AssetId

uuid

Device Unique Identifier

AssetName

string

Name Of Device

Registry:Value

string

Value of Registry (IREC, TIGR)

Registry:Description

string

Description of Registry (I-REC, TIGR)

SerialNumber

string

REC Serial Number

Serial number is combination of RecPrefix

From

decimal(18,6)

From REC Index

To

decimal(18,6)

To REC Index

Total

decimal(18,6)

REC Quantity

Retired

decimal(18,6)

Retired REC Quantity: number of RECs retired

OnSale

decimal(18,6)

On Sale: number of RECs on sale

OnRetirement

decimal(18,6)

On Retirement: number of RECs on retirement

OnDelistingOnExporting

decimal(18,6)

On DelistingExporting: number of RECs on delistingexporting

DelistedExported

decimal(18,6)

DelistedExported: number of RECs delistedExported

OnAuction

decimal(18,6)

On Auction: number of RECs on auction

Available

decimal(18,6)

Available RECs: number of available RECs

Available numbers = Total - OnSale - OnRetirement - On Retired - OnDelist - Delisted - OnAuction

Balance

decimal(18,6)

Balance of REC items:

Balance = Available + On Sale + On Retirement + On Exporting + On Auction

VintageFrom

Datetime

Date Time UTC

VintageTo

Datetime

Date Time UTC

CountryCode

string

Country Code. Ex: SG

FuelType

string

Fuel Type

EnergyValue

string

Energy Type

VintageYear

int

Vintage Year

TradingCount

int

Trading Count

RecItemType

Fuel Name (Marine Wave…)

Energy

Energy Value (Marine Wave…)

CommissionDate

Date Time UTC

  • enum

  • string

(Issued, Imported)

Request

Status
colourGreen
titleGET
/public/v2/inventories/recs

Parameter

Code Block
languagejson
?Page=5&ItemsPerPage=10&RegistryName=IREC

Response

Info

200 Success

Code Block
languagejson
{
  "Data": [
    {
      "RegistryId": "GFNIES10001",
  
   "Retired": 0,       "Id": "326be15c-795e-4c33-26f0-08dbf7dca95f",
      "AssetIdDeviceId": "f26be15c-795e-4c33-26f0-08dbf7dca95f",
      "AssetNameDeviceName": "Sentosa Fun Pass Singapore",
      "SerialNumberDeviceUniqueId": "IREC-GFNIES10001-SG-2021SOLAR-1106-1110-1767.250000 to 1768.24999911012021-2540515487",
      "FromRegistryId": 1767.25"GFNIES10001",
      "ToSerialNumber": "IREC-GFNIES10001-SG-2021-1106-1110-1767.250000 to 1768.249999",
      "Total": 1,
      "OnSaleBalance": 01,
      "Available": 1,
      "OnRetirementOnSale": 0,
      "OnDelistingOnRetirement": 0,
      "DelistedOnExporting": 0,
      "OnAuction": 0,
      "CountryCodeRetired": "SG"0,
      "FuelTypeExported": "Solar"0,
      "EnergyValueVintageFrom": "Solar2021-11-06T00:00:00",
      "VintageYearVintageTo": "2021-11-10T00:00:00",
      "BalanceCountryCode": 1,
      "TradingCountSG": 1,
      "RecItemTypeFuelType": "IssuedSolar",
      "DeviceUniqueIdEnergyValue": "SG-SOLAR-11012021-2540515487Solar",
      "IsOwnerAssetVintageYear": false2021,
      "ProvinceCodeTradingCount": null1,
      "ProvinceNameRecItemType": null"Issued",
      "TickerId": "N/A",
      "VintageFrom": "2021-11-06T00:00:00",
      "VintageTo": "2021-11-10T00:00:00",
      "Registry": {
        "Value": "IREC",
        "Description": "I-REC"
      }
    }
  ],
  "Meta": {
    "CurrentPage": 5,
    "TotalPage": 7,
    "ItemsPerPage": 1,
    "TotalItems": 64,
  },
  "Errors": null,
  "StatusCode": 200,
  "Message": "Success"
}
Warning

404 Not Found

Code Block
{
  "Data": null,
  "Errors": null,
  "Meta": null,
  "StatusCode": 404,
  "Message": "Not found"
}

Warning

401 Unauthorized

Code Block
languagejson
{
  "Data": null,
  "Errors": null,
  "Meta": null,
  "StatusCode": 401,
  "Message": "Unauthorized"
}

Warning

403 Forbidden

Code Block
languagejson
{
  "Data": null,
  "Errors": null,
  "Meta": null,
  "StatusCode": 403,
  "Message": "Forbidden"
}