XML Validation and Generation

Validate report data and generate submission-ready XML.

Validate a report before generating XML

post

Run business rules validation against the report data. Returns a structured list of errors and warnings. Does NOT generate XML — call /generate when ready.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

report_idstring · uuidRequired

Responses

200

Successful Response

application/json

validbooleanRequired

error_countintegerRequired

warning_countintegerRequired

422

Validation Error

application/json

post

/reports/{report_id}/validate

HTTPcURLJavaScriptPython

POST /reports/{report_id}/validate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "valid": true,
  "error_count": 1,
  "warning_count": 1,
  "issues": [
    {
      "level": "text",
      "category": "text",
      "message": "text"
    }
  ]
}

Validate and generate FATCA or CRS XML

post

Validates the report, generates XML, and streams the file.

Returns 422 with validation errors if business rules fail. Returns 200 with application/xml content-disposition attachment on success. Marks the report status as GENERATED on success.

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

report_idstring · uuidRequired

Responses

200

XML file ready for submission

application/xml

422

Validation errors — fix before generating

post

/reports/{report_id}/generate

HTTPcURLJavaScriptPython

POST /reports/{report_id}/generate HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*