Root Insurance · Schema

fulfillment-request

InsuranceAuto InsuranceTelematicsEmbedded InsurancePolicy AdministrationClaimsUsage-Based InsuranceInsurTech

Properties

Name Type Description
fulfillment_request_id string Must be a UUID. The fulfillment request ID.
fulfillment_type_id string Must be a UUID. The fulfillment type ID.
fulfillment_type object The fulfillment type object containing type details.
policy_id string Must be a UUID. The ID of the policy linked to the claim.
claim_id string Must be a UUID. The ID of the claim linked to the fulfillment request.
status string A string indicating the status of the fulfillment request.
fulfillment_data object The fulfillment data as specified in the fulfillment type.
created_at string The time at which the fulfillment request was created.
created_by objectnull An object indicating the user or API key that created the fulfillment request. See [Authentication](https://docs.rootplatform.com/reference/getting-started-1#created_by-field).
environment string Whether the payout request was created in Root's sandbox or production environment.
finalized_at string The time at which the fulfillment request was finalized.
finalized_by object An object indicating the user or API key that finalized the fulfillment request. See [Authentication](https://docs.rootplatform.com/reference/getting-started-1#created_by-field).
View JSON Schema on GitHub

JSON Schema

fulfillment-request.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "fulfillment-request",
  "type": "object",
  "required": [
    "fulfillment_request_id",
    "fulfillment_type_id",
    "policy_id",
    "claim_id",
    "status",
    "fulfillment_data",
    "created_at",
    "created_by",
    "environment"
  ],
  "properties": {
    "fulfillment_request_id": {
      "type": "string",
      "description": "Must be a UUID. The fulfillment request ID."
    },
    "fulfillment_type_id": {
      "type": "string",
      "description": "Must be a UUID. The fulfillment type ID."
    },
    "fulfillment_type": {
      "type": "object",
      "description": "The fulfillment type object containing type details.",
      "properties": {
        "fulfillment_type_id": {
          "type": "string",
          "format": "uuid",
          "description": "The unique identifier of the fulfillment type."
        },
        "key": {
          "type": "string",
          "description": "The key identifier of the fulfillment type."
        },
        "name": {
          "type": "string",
          "description": "The name of the fulfillment type."
        },
        "description": {
          "type": "string",
          "description": "A description of the fulfillment type."
        }
      }
    },
    "policy_id": {
      "type": "string",
      "description": "Must be a UUID. The ID of the policy linked to the claim."
    },
    "claim_id": {
      "type": "string",
      "description": "Must be a UUID. The ID of the claim linked to the fulfillment request."
    },
    "status": {
      "type": "string",
      "enum": [
        "pending",
        "rejected",
        "successful"
      ],
      "description": "A string indicating the status of the fulfillment request."
    },
    "fulfillment_data": {
      "type": "object",
      "description": "The fulfillment data as specified in the fulfillment type."
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "The time at which the fulfillment request was created."
    },
    "created_by": {
      "type": [
        "object",
        "null"
      ],
      "description": "An object indicating the user or API key that created the fulfillment request. See [Authentication](https://docs.rootplatform.com/reference/getting-started-1#created_by-field)."
    },
    "environment": {
      "type": "string",
      "enum": [
        "sandbox",
        "production"
      ],
      "description": "Whether the payout request was created in Root's sandbox or production environment."
    },
    "finalized_at": {
      "type": "string",
      "format": "date-time",
      "description": "The time at which the fulfillment request was finalized."
    },
    "finalized_by": {
      "type": "object",
      "description": "An object indicating the user or API key that finalized the fulfillment request. See [Authentication](https://docs.rootplatform.com/reference/getting-started-1#created_by-field)."
    }
  },
  "example": {
    "fulfillment_request_id": "8f8b3469-82e9-4d5b-bcc5-f200af095a79",
    "fulfillment_type_id": "ad044686-6b6f-4ce6-878f-143039243f11",
    "fulfillment_type": {
      "fulfillment_type_id": "ad044686-6b6f-4ce6-878f-143039243f11",
      "key": "repatriation",
      "name": "Repatriation",
      "description": "Cover for repatriation of remains"
    },
    "policy_id": "2800a20b-ce92-4463-a0de-75cd76d8bf22",
    "claim_id": "80f8e67a-15e5-417c-9d29-dfc31a5b92bb",
    "status": "pending",
    "fulfillment_data": {
      "amount": "100000",
      "customer_account_number": "02870611321"
    },
    "created_at": "2022-06-07T12:52:55.014Z",
    "created_by": {
      "type": "user",
      "id": "99ff4c56-577c-11e9-b47c-a3d0f3abd20c"
    },
    "environment": "sandbox"
  }
}