JSON output

Requesting JSON

Add "json" to the output_formats field on POST /v1/conversions. It's a repeatable form field — send it once per format:

curl -s -X POST https://est.anterotrail.com/v1/conversions \
  -H "X-API-Key: at_test_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "file=@estimate.pdf;type=application/pdf" \
  -F "price_list=FLTA8X_02MAY26" \
  -F "output_formats=esx" \
  -F "output_formats=json"

On success, the job resource — and the identical webhook body — carries an artifacts array listing every output of the job, each with its own time-limited signed URL:

{
  "job_id": "b3f1...",
  "status": "succeeded",
  "artifacts": [
    { "type": "esx",  "url": "https://.../job.esx?sig=...",  "expired": false },
    { "type": "json", "url": "https://.../job.json?sig=...", "expired": false }
  ]
}

Conventions

• Money is always a string with two decimals (e.g. "1234.56"), never a float. Parse with a decimal type, not floating point.
• Quantities are numbers, with a unit string alongside.
• Absent values omit the key — no nulls. Code defensively around missing optional keys.
• Ordering is meaningful: sections and line items appear in the same order as in the ESX.
• Versioning is additive-only within the 1.x line: new optional keys may appear over time; existing keys never change type or meaning, and required keys never disappear. A breaking change would ship as a new major schema_version.

Accuracy and source fidelity

The source PDF is the only source of truth available to the converter. Output accuracy means fidelity to the PDF, not to whatever estimate file originally produced it.

• unit_price, tax, and rcv are the values as printed in the source. rcv includes tax and overhead & profit as printed, so it is not necessarily quantity × unit_price. The sum of line rcv equals totals.rcv, which matches the ESX grand total.
• Repricing. Xactimate reprices catalog items against the selected price list on import. Printed unit prices in this output are source values, not a prediction of post-import pricing. Bid items retain their own pricing.
• *REVIEW* convention. Descriptions may carry a *REVIEW* prefix where the converter emitted a source line it could not confidently map to a catalog code. These lines are written as bid items, preserve the source text verbatim, and are intended for adjuster review after import.
• No source warranty. The converter faithfully represents the PDF. It cannot detect or reverse edits, overrides, or omissions made before the PDF was printed — no converter can.

Top level

claim

sections[]

sections[].dimensions

All values are numbers. Any subset may be present:

floor_sf, ceiling_sf, wall_sf, wall_and_ceiling_sf, floor_perimeter_lf, ceiling_perimeter_lf, roof_surface_sf, roof_squares, height_ft, length_ft, width_ft

sections[].line_items[]

totals

Sample payload

{
  "schema_version": "1.0",
  "claim": {
    "estimate_name": "SMITH_J",
    "claim_number": "CLM-2026-04581",
    "policy_number": "HO3-99120",
    "insured_name": "John Smith",
    "property_address": {
      "street": "12 Oak St",
      "city": "Tampa",
      "state": "FL",
      "zip": "33601"
    },
    "date_of_loss": "2026-05-01",
    "type_of_loss": "Water",
    "price_list": "FLTA8X_02MAY26"
  },
  "sections": [
    {
      "name": "Master Bathroom",
      "path": ["Main Level", "Master Bathroom"],
      "dimensions": {
        "floor_sf": 96.0,
        "ceiling_sf": 96.0,
        "wall_sf": 320.0,
        "floor_perimeter_lf": 40.0,
        "height_ft": 8.0
      },
      "notes": [{ "text": "Flooring" }],
      "line_items": [
        {
          "cat": "DRY",
          "sel": "1/2-",
          "description": "1/2\" drywall - hung, taped, floated, ready for paint",
          "quantity": 320.0,
          "unit": "SF",
          "activity": "+",
          "unit_price": "2.15",
          "tax": "9.87",
          "rcv": "688.00",
          "notes": [{ "text": "Water damage to lower 2 feet" }]
        }
      ]
    }
  ],
  "totals": { "rcv": "688.00" }
}