X-Request-IDstring(uuid)
Client-supplied correlation ID echoed in response headers for tracing.
EP-25 — Register Channel Profile
Registers a new named channel profile storing default processing parameters for a
specific channel/scheme/direction combination. Once registered, reference by channelName
in EP-01 through EP-17 to auto-apply all channel defaults.
channelName must be unique per account. HTTP 409 if name already exists.
Use DELETE + POST to rename. Changes via EP-26 take effect immediately for all
subsequent requests using this channelName.
post
https://api-uat.ionova.ai/ars/channel-profile
Headers
Body
Body
CreateChannelProfileRequest
Request body for EP-25 — Register Channel Profile.
channelNamestringrequired
Unique name for this channel profile. Must be unique per account. Use DELETE + POST to rename.
Example:CBPR_OUTBOUND_US
channelSelectionobjectrequired
Channel identification block for channelProfile registration and retrieval.
Show Child Parameters
corridorobject
Default corridor (geographic routing) block for a channelProfile.
Show Child Parameters
preferencesobject
Output and behaviour preference defaults for a channelProfile.
Show Child Parameters
Response
Response
Channel profile registered
ChannelProfileResponse
Full channel profile returned by EP-25 (201), EP-26 (200), and EP-27 (200).
channelNamestring
Example:CBPR_OUTBOUND_US
channelSelectionobject
Channel identification block for channelProfile registration and retrieval.
Show Child Parameters
corridorobject
Default corridor (geographic routing) block for a channelProfile.
Show Child Parameters
preferencesobject
Output and behaviour preference defaults for a channelProfile.
Show Child Parameters
createdAtstring(date-time)
Timestamp when this channel profile was first registered.
updatedAtstring(date-time)
Timestamp when this channel profile was last updated.
post/channel-profile
Authentication
Headers
Body
{
"channelName": "MY_SEPA_SCT",
"channelSelection": {
"channel": "sepa",
"scheme": "SCT",
"schemeVersion": "SR2026",
"direction": "OUTBOUND",
"pspCountry": "DE",
"timezone": "Europe/Berlin"
},
"corridor": {
"sendingCountry": "DE",
"receivingCountry": "FR",
"currency": "EUR"
},
"preferences": {
"outputMode": "EPC",
"autoRepairMode": "STANDARD",
"targetFormat": "auto",
"quality": "standard",
"repairConfidenceThreshold": 0.8
}
}
EP-26 — Update Channel Profile
Updates an existing named channel profile using PATCH semantics — only provided
fields updated. All other profile values remain unchanged.
Changes take effect immediately for all subsequent requests using this channelName.
channelName cannot be changed — use DELETE + POST to rename.
patch
https://api-uat.ionova.ai/ars/channel-profile/{name}
Path Parameters
namestringrequired
channelName of the profile to update
Headers
X-Request-IDstring(uuid)
Client-supplied correlation ID echoed in response headers for tracing.
Body
Body
UpdateChannelProfileRequest
Request body for EP-26 — Update Channel Profile (PATCH semantics).
Only fields provided are updated. channelName cannot be changed via PATCH.
channelSelectionobject
PATCH of channelSelection block. Only provided sub-fields are updated.
Show Child Parameters
corridorobject
Show Child Parameters
preferencesobject
Show Child Parameters
Response
Response
Channel profile updated — full profile returned
ChannelProfileResponse
Full channel profile returned by EP-25 (201), EP-26 (200), and EP-27 (200).
channelNamestring
Example:CBPR_OUTBOUND_US
channelSelectionobject
Channel identification block for channelProfile registration and retrieval.
Show Child Parameters
corridorobject
Default corridor (geographic routing) block for a channelProfile.
Show Child Parameters
preferencesobject
Output and behaviour preference defaults for a channelProfile.
Show Child Parameters
createdAtstring(date-time)
Timestamp when this channel profile was first registered.
updatedAtstring(date-time)
Timestamp when this channel profile was last updated.
patch/channel-profile/{name}
Authentication
Path Parameters
Headers
Body
{
"channelSelection": {
"schemeVersion": "SR2026"
},
"preferences": {
"repairConfidenceThreshold": 0.85
}
}
EP-27 — Read Channel Profile
Returns the complete channel profile for the specified channelName, including all
channelSelection, corridor, and preferences fields.
Returns HTTP 404 if channelName not found.
get
https://api-uat.ionova.ai/ars/channel-profile/{name}
Path Parameters
namestringrequired
channelName of the profile to read
Headers
X-Request-IDstring(uuid)
Client-supplied correlation ID echoed in response headers for tracing.
Response
application/json
Response
application/json
Channel profile returned
ChannelProfileResponse
Full channel profile returned by EP-25 (201), EP-26 (200), and EP-27 (200).
channelNamestring
Example:CBPR_OUTBOUND_US
channelSelectionobject
Channel identification block for channelProfile registration and retrieval.
Show Child Parameters
corridorobject
Default corridor (geographic routing) block for a channelProfile.
Show Child Parameters
preferencesobject
Output and behaviour preference defaults for a channelProfile.
Show Child Parameters
createdAtstring(date-time)
Timestamp when this channel profile was first registered.
updatedAtstring(date-time)
Timestamp when this channel profile was last updated.
get/channel-profile/{name}
Authentication
Path Parameters
Headers
application/json
Layer 5 — Health
Service availability. No authentication required.
EP-24 — Health
Returns the operational status of the ARS service. No API key or bearer token required.
Suitable for uptime monitoring, load balancer health probes, and status dashboards.
get
https://api-uat.ionova.ai/ars/health
Headers
X-Request-IDstring(uuid)
Client-supplied correlation ID echoed in response headers for tracing.
Response
application/json
Response
application/json
Health status returned
HealthResponse
statusstring
Operational status of the ARS service.
Allowed values:healthydegradedunhealthy
versionstring
Current ARS version (e.g. 4.3.0).
Example:4.3.0
timestampstring(date-time)
Current server time in ISO 8601 UTC format.
get/health
Authentication
Headers
application/json