# REST Service
All the flows published to the runtime can be executed as a REST service.
The available service list can be retrieved at this URL and the list is displayed in swagger UI.
### REST UI
[http://Ism-Install-Host:18080/rest](http://ism-install-host:18080/rest)
The request and response format of each service can be viewed like this.
### Authentication
Each service can be tested in this UI. The authentication is required to test the services. All the requests should contain API key in the http header, and this key is from [API Key(REST)](https://support.xnarum.com/download/manual.php#_API_Key\(REST\)).
### Execution
Input format of the REST service has this format.
|
This key is displayed in the business transaction result if exists.
txnId
This id is used as a transaction id if exists. Otherwise, a new random transaction id is generated.
table
This property contains real parameters of the flow.
This flow has one Router and three Function components. The Router will determine the path based on the input data.
The Router expects two parameters ??? param and param2.
The request parameters of this flow will be like these.
```
{
"userKey": "my-user-key",
"table": {
"param": "A",
"param2": 1
},
"txnId": "my-transaction-id"
}
```
The response of the execution will be like this.
The service endpoint is this
\_
This endpoint accepts only POST method.
And the result of this transaction will be logged like this. Transaction Id and User Key are picked up from the request.
The detail table shows the parameters from the request.
There is one more service endpoint. This endpoint does not accept userKey and txnId parameters. It accepts only parameters instead. A random transaction id is generated. This endpoint also requires authentication as the same as the previous endpoint.
The second endpoint is this.
[http://Ism-Install-Host:8080/api/*flow\_id/flow\_version*](http://ism-install-host:8080/api/flow_id/flow_version)
This endpoint accepts both GET and POST methods.
The requests for the same flow can be constructed like these.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://ism-docs.xnarum.com/rest-service.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
