Versions Compared

Old Version 2

changes.mady.by.user Que Nguyen

Saved on

compared with

New Version 3

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.

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}}

Parameters

ItemsPerPage

  • numeric

  • query

The total items that return in the response

Page

  • numeric

  • query

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

Registries

  • array[string]

  • query

Filter the items by Registry

  • IREC

  • TIGR

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

RegistryName

string

Name of Registry (I-REC, TIGR)

OwnerName

string

Owner Name

SerialNumber

string

REC Serial Number

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

OnSale

decimal(18,6)

On Sale

OnBlock

decimal(18,6)

OnBlock

Available

decimal(18,6)

Available RECs

OnRetirement

decimal(18,6)

On Retirement

OnDelisting

decimal(18,6)

On Delisting

Delisted

decimal(18,6)

Delisted

OnAuction

decimal(18,6)

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

Vintage Year

int

Vintage Year

Balance

string

Balance

TradingCount

int

Trading Count

RecItemType

Fuel Name (Marine Wave…)

Energy

Energy Value (Marine Wave…)

CommercialOperationDate

Date Time UTC

Status

  • Draft

  • New

  • Verified

  • Submitted

  • Resubmitted

  • Returned

  • Approved

  • Rejected

StatusDescription

Request

Status
colourGreen
titleGET
/public/v2/inventories/recs

RequestParameter

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",
      "AssetId": null,
      "RegistryName": "IREC",
      "OwnerName": "Nam Song Tien Company",
      "AssetName": "Sentosa Fun Pass Singapore",
      "SerialNumber": "IREC-GFNIES10001-SG-2021-1106-1110-1767.250000 to 1768.249999",
      "From": 1767.25,
      "To": 1768.249999,
      "Total": 1,
      "OnSale": 0,
      "OnBlock": 0,
      "Available": 1,
      "OnRetirement": 0,
      "OnDelisting": 0,
      "Delisted": 0,
      "OnAuction": 0,
      "CountryCode": "SG",
      "FuelType": "Solar",
      "EnergyValue": "Solar",
      "VintageYear": 2021,
      "Balance": 1,
      "TradingCount": 1,
      "RecItemType": "Issued",
      "DeviceUniqueId": "SG-SOLAR-11012021-2540515487",
      "IsOwnerAsset": false,
      "ProvinceCode": null,
      "ProvinceName": null,
      "TickerId": "N/A",
      "VintageFrom": "2021-11-06T00:00:00",
      "VintageTo": "2021-11-10T00:00:00",
    }
  ],
  "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"
}