---
title: "ConvertOutput"
url: "https://dev.ionova.ai/apis/ars-address-resolution-service-4/versions/fdd2c316-7f84-4f04-8bb7-64e9bf97893b/schemas/ConvertOutput"
---

> Full API specification: https://dev.ionova.ai/apis/ars-address-resolution-service-4/versions/fdd2c316-7f84-4f04-8bb7-64e9bf97893b.md

# ConvertOutput

Supplementary conversion output. Populated on EP-04 responses when the caller needs to distinguish between the target format they asked for and the fallback the engine used (e.g. targetFormat=FULLY_STRUCTURED but engine could only reach HYBRID).

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: ARS — Address Resolution Service
  version: 4.3.1
servers:
  - url: https://api-uat.ionova.ai/ars/
    description: UAT (test data only)
components:
  schemas:
    Direction:
      type: string
      description: Payment processing direction. OUTBOUND = sending; INBOUND = receiving.
      enum:
        - OUTBOUND
        - INBOUND
    AddressFormat:
      type: string
      description: Detected or target address format classification.
      enum:
        - FULLY_STRUCTURED
        - HYBRID
        - FULLY_UNSTRUCTURED
    ConvertOutput:
      type: object
      description: >
        Supplementary conversion output. Populated on EP-04 responses when the
        caller needs to

        distinguish between the target format they asked for and the fallback
        the engine used

        (e.g. targetFormat=FULLY_STRUCTURED but engine could only reach HYBRID).
      properties:
        appliedDirection:
          $ref: "#/components/schemas/Direction"
          description: Direction actually used for this conversion (may differ from
            context if per-address overrides applied).
        appliedTargetFormat:
          type: string
          enum:
            - auto
            - FULLY_STRUCTURED
            - HYBRID
            - FULLY_UNSTRUCTURED
          description: Target format the engine attempted (before fallback).
        finalFormat:
          $ref: "#/components/schemas/AddressFormat"
          description: Format actually reached after any fallback resolution.
```