Get a Single Banking Product by Its Unique Product ID

GET /v1/products/ — Retrieves full configuration for a single product, including connected bank partners and reconciliation metadata.

This endpoint retrieves the full configuration of a single product by its UUID. Use it to inspect which bank partners are connected to a given product, review reconciliation metadata, or verify product details before associating it with a payment workflow. Product records are read-only through the API and are managed by Diameter during tenant onboarding.

​

Endpoint

GET /v1/products/{id}

Required scope: com.diameterpay.api/products.read

​

Request Headers

Authorization · string · required

Bearer token obtained from your OAuth2 token endpoint. Format: Bearer {access_token}

​

Path Parameters

id · string · required

The UUID of the product to retrieve.

​

Response

Returns HTTP 200 OK with a ProductOutput object on success.

id · string

UUID uniquely identifying the product.

fullName · string

Human-readable display name of the product, as configured during tenant onboarding.

connectedBanks · array

List of bank partner identifiers connected to this product. Possible values: PORTAGE, SLOVAK_SAVINGS_BANK.

reconciliationInfo · object

Optional reconciliation configuration associated with this product. null if not configured.

createdAt · string

ISO 8601 timestamp of when the product was provisioned.

updatedAt · string

ISO 8601 timestamp of the most recent update to the product record.

​

Example

cURL

curl --request GET \
  --url https://api.diameterpay.com/v1/products/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  --header "Authorization: Bearer {access_token}"

​

Response

{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "fullName": "Domestic Wire Product",
  "connectedBanks": [
    "PORTAGE"
  ],
  "reconciliationInfo": {
    "accountCode": "WIRE-DOM-001"
  },
  "createdAt": "2024-01-15T08:00:00.000Z",
  "updatedAt": "2024-01-15T08:00:00.000Z"
}