Retirements

SecurityJWT

Request

query Parameters

onBehalfOfAccountId

string

Account id for which the request is being made: defaults to the primary account id of the requester unless specified

Request Body schema: application/json

Retire requests

Array of objects (RetireRequest)

List of requests

Responses

200

400

Invalid parameter(s)

401

Unauthorized access

403

Permission denied

413

Request payload is too large

429

Server too busy or acceptable use policy violation

500

An unexpected error has occurred

post/api/ledger/retire

Request samples

Payload

application/json

{"requests": [{"certificateSerialNumberRange": "TIGR-1234-GT-SM-08-2024-321-1 to 55",
"correlationId": "1",
"details": "Retired for Green Energy Program",
"emailNotification": "jdoe@acmecorp.com",
"onBehalfOfCorporateEntityId": "99",
"quantity": "55",
"reasonCode": "7",
"retirementCertificateType": "TIGR",
"retirementTypeCode": "OTH",
"subaccountId": "99",
"year": "2024"
}
]
}

Response samples

application/json

{"responses": [{"certificateSerialNumberRange": "TIGR-1234-GT-SM-08-2024-321-1 to 55",
"correlationId": "1",
"details": "Retired for Green Energy Program",
"emailNotification": "jdoe@acmecorp.com",
"onBehalfOfCorporateEntityId": "55",
"quantity": "55",
"reasonCode": "7",
"retirementCertificateType": "TIGR",
"retirementTypeCode": "OTH",
"subaccountId": "99",
"transferId": "7654",
"year": "2024"
}
],
"submissionId": "string"
}