Skip to content
/
Technical MTA (tMTA)
Last updated

Technical MTA (tMTA)

Interactive content available

All ledger endpoints can be interacted with through interactive API Registry

What is tMTA?

A Technical Mid-Term Adjustment (tMTA) is a simplified, technical process used to change data or attach documents to an already issued policy, without initiating a full commercial MTA (which might impact pricing, coverage, or contract structure). This adjustment is purely administrative and should influence only the fields that don't affect final premium .

Use Case

tMTA is typically used in scenarios where:

  • Some data needs to be changed post policy issue
  • A signed contract, scanned certificate, or supporting documentation needs to be added post-issuance.
  • No financial, legal, or coverage-related parameters of the policy are being changed.
  • No new documents or policy version needs to be created or shared with the customer

Summary

tMTA serves as a lightweight and technical mechanism to change specific data and/or add supplementary documents to active policies. It is designed for backend or system-level integrations and should not be confused with a full MTA that triggers recalculations or business rules.

Endpoint - tMTA

This endpoint is used to upload documents (e.g., PDFs or images) for a given insurance policy and/or change specified data. It supports file uploads encoded in Base64 format and allows categorizing the document under types like "other" by default.

curl -i -X PUT \
  'https://ledger.docs.insly.com/_mock/apis/ledger/bundled/api/v1/ledger/policies/{id}/data-change' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-TENANT-ID: {$inputs.tenant}'
Response
application/json
{
  "policy": {
    "id": "1234",
    "policyNo": "string",
    "dateIssue": "2019-08-24",
    "dateInception": "2019-08-24",
    "dateExpiry": "2019-08-24",
    "financials": { … },
    "params": { … }
  },
  "customer": {
    "name": "string",
    "code": "string",
    "params": { … }
  },
  "agent": {
    "broker": "string",
    "code": "string",
    "params": { … }
  },
  "objects": {
    "objectId": { … }
  }
}

Notes

No Premium Impact: tMTAs must not affect pricing, premium calculations, or financial flows. If a change could influence the premium or coverage, a full MTA should be used instead.

Only PDF and PNG files are currently supported via MIME types.

Previous page
Next page