Skip to main content
GET
/
platform
/
admin
/
issuer_factories
/
{tenantId}
Get issuer factories report
curl --request GET \
  --url https://api.example.com/platform/admin/issuer_factories/{tenantId}
{
  "isSuccess": true,
  "isFailure": false,
  "error": null,
  "value": {
    "id": 42,
    "name": "Example"
  }
}

​
Description

Fetches a detailed report containing all issuer factory smart contracts deployed for a tenant, including their blockchain locations, owners, guardians, and operational status.

​
Input

  • tenantId (long, required) — The unique identifier of the tenant whose issuer factories are requested.

​
Output

Returns a IssuerFactoriesReportResponse object containing:
  • tenantId (long) — The tenant identifier.
  • tenantName (string) — The name of the tenant.
  • factories (array) — List of issuer factory details including blockchain ID, contract address, owner, guardians, and status.

​
Examples

Request 
GET /api/platform/tenants/1024/issuer-factories
Response (200 OK) 
{
  "tenantId": 1024,
  "tenantName": "Acme Corporation",
  "factories": [
    {
      "blockchainId": 137,
      "blockchainName": "Polygon",
      "contractAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "ownerAddress": "0x123...abc",
      "guardians": ["0x456...def", "0x789...ghi"],
      "isEnabled": true,
      "isStopped": false
    }
  ]
}

​
Errors

  • 400 Bad Request: Invalid tenant identifier format.
  • 401 Unauthorized: Caller is not authenticated.
  • 403 Forbidden: Caller lacks permissions to view issuer factories.
  • 404 Not Found: Tenant does not exist.
  • 500 Internal Server Error: Unexpected server error occurred.

​
Notes

This endpoint provides an overview of all issuer factory deployments for a tenant. Guardians are security roles that can pause factory operations in emergencies.

Path Parameters

​
tenantId
integer<int64>
required

The unique identifier of the tenant.

Query Parameters

​
api-version
string | null

Response

Issuer factories report retrieved successfully.

Wrapper for API operation results containing success status, error information, and return value.

​
isSuccess
boolean

True if the operation completed successfully, false otherwise.

Example:

true

​
isFailure
boolean

True if the operation failed, false otherwise.

Example:

false

​
error
object

Error information returned when the operation fails.

Example:
{
  "code": "ValidationError",
  "message": "The request parameters failed validation.",
  "info": [
    "The Name field is required.",
    "The Id field must be greater than 0."
  ]
}
​
value
object

The result value returned when the operation is successful.