TOtopograph
Discrepancy reports (Beta)

Get a discrepancy report (Beta)

Changed on

Beta. Germany only for now; more countries are coming. The request and response shapes may change. Available on accounts with access to the beta; contact support@topograph.co to request it.

The current state of a report: poll it until status is succeeded or failed. Free.

get/v2/discrepancy-reports/{id}

Request

  • Base URL
    https://api.topograph.co
  • URL
    https://api.topograph.co/v2/discrepancy-reports/{id}
  • Auth
    API key in header x-api-key

Path parameters

idstring required

The report id returned when the report was filed

Headers

x-topograph-workspace-idstring

Workspace whose register credentials file the report. Defaults to the default workspace.

Response

The report

idstring required

Unique identifier of the report

status'in_progress' | 'succeeded' | 'failed' required

in_progress: accepted and being filed. succeeded: filed with the register; filing.registerReference and filing.receipt are set. failed: nothing was filed; see error, then correct and resend with a new Idempotency-Key.

countryCodestring required

Country of the company

companyIdstring required

The company ID

reasonsstring[] required

Why the register is wrong, as sent

commentstring

Free text appended to the explanation, as sent

sourceRequestIdstring

The company request the report refers to, as sent

metadataobject

Key-value pairs provided at creation

createdAtstring required

Creation time (ISO 8601)

updatedAtstring required

Last update time (ISO 8601)

Example response

{
  "id": "0b7e8a3c-5d2f-4c1e-9a6b-7f8e9d0c1b2a",
  "countryCode": "DE",
  "companyId": "München HRB 228960",
  "register": {
    "name": "Transparenzregister"
  },
  "reasons": [
    "incorrect_or_incomplete_information"
  ],
  "ultimateBeneficialOwners": [
    {
      "gender": "Male",
      "name": {
        "fullName": "Erika Mustermann",
        "firstName": "Erika",
        "lastName": "Mustermann"
      },
      "birthDate": {
        "day": 15,
        "month": 7,
        "year": 1980
      },
      "nationality": "DE",
      "residenceAddress": {
        "city": "Berlin",
        "countryCode": "DE"
      },
      "control": {
        "types": [
          "ownership-of-shares"
        ],
        "details": [
          {
            "type": "shares",
            "percentageValue": 100,
            "percentageRange": {
              "lower": 25,
              "upper": 50
            }
          }
        ]
      }
    }
  ],
  "filing": {
    "language": "de",
    "text": "Die wirtschaftlich Berechtigte ist Erika Mustermann mit 100 %.",
    "registerReference": "261000000001",
    "submittedAt": "2026-10-27T14:11:47.000Z",
    "receipt": {
      "url": "https://storage.topograph.co/documents/discrepancy-reports/receipt.pdf?sv=...",
      "expiresAt": "2026-10-27T14:27:47.000Z",
      "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"
    }
  },
  "error": {
    "code": "resource_not_found",
    "message": "Resource not found"
  },
  "metadata": {
    "caseId": "case-12345"
  },
  "createdAt": "2026-10-27T14:10:02.000Z",
  "updatedAt": "2026-10-27T14:12:46.000Z"
}

Changes