Codat · Schema

Read completed webhook

Unified-API

Properties

Name Type Description
id string Unique identifier of the event.
eventType string The type of event.
generatedDate object The date time in UTC the event was generated in Codat.
payload object
View JSON Schema on GitHub

JSON Schema

codat-readcompletedwebhook-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/ReadCompletedWebhook",
  "title": "Read completed webhook",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "example": "743ec94a-8aa4-44bb-8bd4-e1855ee0e74b",
      "description": "Unique identifier of the event."
    },
    "eventType": {
      "type": "string",
      "description": "The type of event."
    },
    "generatedDate": {
      "$ref": "#/components/schemas/DateTime",
      "description": "The date time in UTC the event was generated in Codat."
    },
    "payload": {
      "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/readCompletedWebhookPayload"
    }
  },
  "definitions": {
    "readCompletedWebhookPayload": {
      "title": "Read result webhook payload",
      "type": "object",
      "properties": {
        "referenceCompany": {
          "$ref": "#/components/schemas/Company/definitions/companyReference"
        },
        "modifiedFromDate": {
          "$ref": "#/components/schemas/DateTime",
          "description": "The date time in UTC when the data types were last fetched and input into Codat's cache.",
          "nullable": true
        },
        "dataTypes": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/dataTypeReadSummary"
          }
        }
      }
    },
    "dataTypeReadSummary": {
      "title": "Summary of data type reads",
      "type": "object",
      "properties": {
        "connectionId": {
          "$ref": "#/components/parameters/connectionId/schema"
        },
        "dataType": {
          "$ref": "#/components/schemas/DataStatus/properties/dataType"
        },
        "recordsModified": {
          "type": "boolean",
          "example": false,
          "description": "`True` if records have been created, updated or deleted in Codat's cache."
        },
        "status": {
          "$ref": "#/components/schemas/PullOperation/properties/status"
        },
        "issues": {
          "type": "array",
          "nullable": true,
          "description": "A array of issues encountered during a data read.",
          "items": {
            "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/issue"
          }
        }
      }
    },
    "customProductReadCompleteWebhook": {
      "title": "Read completed webhook",
      "type": "object",
      "properties": {
        "id": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/properties/id"
        },
        "eventType": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/properties/eventType"
        },
        "generatedDate": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/properties/generatedDate"
        },
        "payload": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/customProductReadCompleteWebhookPayload"
        }
      }
    },
    "customProductReadCompleteWebhookPayload": {
      "title": "Read result webhook payload",
      "type": "object",
      "properties": {
        "referenceCompany": {
          "$ref": "#/components/schemas/Company/definitions/companyReference"
        },
        "modifiedFromDate": {
          "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/readCompletedWebhookPayload/properties/modifiedFromDate"
        },
        "dataTypes": {
          "type": "array",
          "description": "Contains all data types configured for the product or a subset of data types defined in the manual refresh call.",
          "items": {
            "type": "object",
            "title": "Summary of data type reads",
            "properties": {
              "connectionId": {
                "$ref": "#/components/parameters/connectionId/schema"
              },
              "dataType": {
                "$ref": "#/components/schemas/DataStatus/properties/dataType"
              },
              "recordsModified": {
                "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/dataTypeReadSummary/properties/recordsModified"
              },
              "status": {
                "$ref": "#/components/schemas/PullOperation/properties/status"
              },
              "issues": {
                "type": "array",
                "nullable": true,
                "description": "A array of issues encountered during a data read.",
                "items": {
                  "$ref": "#/components/schemas/ReadCompletedWebhook/definitions/issue"
                }
              }
            }
          }
        }
      }
    },
    "issue": {
      "title": "Issue",
      "type": "object",
      "description": "Details of a problem encountered during a data read.",
      "properties": {
        "type": {
          "type": "string",
          "description": "The type of issue.",
          "example": "warning.validation"
        },
        "message": {
          "type": "string",
          "description": "A message describing the issue.",
          "example": "Something doesn't look right about these accounts from Xero. You can see more information in the logs."
        },
        "links": {
          "title": "Links",
          "type": "object",
          "properties": {
            "logs": {
              "type": "string",
              "description": "A link to the validation logs, providing details on any errors or warnings encountered.",
              "example": "https://api.codat.io/companies/0498e921-9b53-4396-a412-4f2f5983b0a2/sync/{datasetId}/validation"
            },
            "portal": {
              "type": "string",
              "description": "A link to the company's past data read history in the Codat portal.",
              "example": "https://app.codat.io/companies/0498e921-9b53-4396-a412-4f2f5983b0a2/pull-history"
            },
            "readMore": {
              "type": "string",
              "description": "A link to Codat's documentation with additional information on how to troubleshoot this issue.",
              "example": "https://docs.codat.io/using-the-api/get-data-troubleshooting#warning.validation"
            }
          }
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/codat-readcompletedwebhook"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.