Skip to content

Ledger/Sales service (1.0)

Using Swagger documentation in Postman


You can find instructions on how to convert swagger documentation to Postman collection here.
There is a known problem in Postman with env variables being imported as parameters (:schemaName instead of {{schemaName}}. More info on the issue can be found here.
Possible workaround is to find and replace all parameters with env variables inside Postman. For example search for :schemaName and replace with {{schemaName}}. Instructions how to do it in Postman are here.

Authorization

To obtain a token, start by visiting the identifier service documentation and make a request with your username and password.
Once you receive the response, copy the access_token and use it for making requests to ledger services.
Download OpenAPI description
Languages
Servers
Mock server

https://ledger.docs.insly.com/_mock/apis/ledger/bundled/

Beta

https://ledger.app.beta.insly.training/

Demo

https://ledger.app.demo.insly.com/

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Request

Policy issuing happens asynchronously.

Call current endpoint to validate, if policy has been issued before requesting policy data.

The endpoint needs to be called until the success or failure status is returned.

In case of pending status, please repeat the call again with some delay. The pending means its still processing.

Security
bearerAuth
Path
requestIdstring(uuid)required

request id

Query
longPollingbool
Default "false"
Example: longPolling=true
Headers
X-TENANT-IDstringrequired

Tenant tag

Example: {$inputs.tenant}
curl -i -X GET \
  'https://ledger.docs.insly.com/_mock/apis/ledger/bundled/api/v1/ledger/requests/{requestId}?longPolling=true' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-TENANT-ID: {$inputs.tenant}'

Responses

Request status

Bodyapplication/json
requestIdstring(uuid)

Request ID

Example: "8bb0e40f-6841-47fc-a283-b6a43c6e299e"
statusstring

Status of running request

Example: "pending"
dataobject

Request data if complete

Response
application/json
{ "requestId": "a202dc2a-9e32-4bb8-8c74-18c73c235129", "status": "success", "data": { "policyId": 286532, "message": "Policy issued" } }