[BillingTrust] Add Microsoft.BillingTrust TypeSpec API spec (2026-03-17-preview)

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/.cspell.yaml

@@ -0,0 +1,13 @@
+# This file configures spell checking for the BillingTrust spec. Items in "words"
+# are project-specific terms not in the global dictionary.
+# For more information, see: https://aka.ms/ci-fix#spell-check
+
+version: "0.2"
+import:
+  - ../../../../../cspell.yaml
+words:
+  - rpaasextensionapi
+  - OAPI
+  - scvmm
+  - connectedvmware
+  - abmohanr

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/client.tsp

@@ -0,0 +1,7 @@
+import "./main.tsp";
+import "@azure-tools/typespec-client-generator-core";
+
+using Microsoft.BillingTrust;
+using Azure.ClientGenerator.Core;
+
+@@clientName(ProvisioningState, "BillingTrustProvisioningState", "csharp");

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/examples/2026-03-17-preview/Assessments_CreateOrUpdate.json

@@ -0,0 +1,79 @@
+{
+  "operationId": "Assessments_CreateOrUpdate",
+  "title": "Create or update the Edu assessment for an enrollment",
+  "parameters": {
+    "resourceUri": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default",
+    "api-version": "2026-03-17-preview",
+    "resource": {
+      "properties": {
+        "assessmentType": "Edu",
+        "initialValues": [
+          {
+            "kind": "eduQualification",
+            "domains": [
+              {
+                "domainNames": [
+                  "students.contoso.edu",
+                  "faculty.contoso.edu"
+                ],
+                "tenantId": "11111111-1111-1111-1111-111111111111"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "Edu",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "edu-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "edu-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "Edu",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "edu-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "edu-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    }
+  }
+}

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/examples/2026-03-17-preview/Assessments_CreateOrUpdate_BV.json

@@ -0,0 +1,65 @@
+{
+  "operationId": "Assessments_CreateOrUpdate",
+  "title": "Create or update the BusinessVerification assessment for a billing account",
+  "parameters": {
+    "resourceUri": "providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31",
+    "api-version": "2026-03-17-preview",
+    "resource": {
+      "properties": {
+        "assessmentType": "BusinessVerification"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "BusinessVerification",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "billing-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "billing-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "BusinessVerification",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "billing-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "billing-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    }
+  }
+}

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/examples/2026-03-17-preview/Assessments_CreateOrUpdate_PayeeEnrollment.json

@@ -0,0 +1,65 @@
+{
+  "operationId": "Assessments_CreateOrUpdate",
+  "title": "Create or update the PayeeEnrollment assessment for a billing account",
+  "parameters": {
+    "resourceUri": "providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31",
+    "api-version": "2026-03-17-preview",
+    "resource": {
+      "properties": {
+        "assessmentType": "PayeeEnrollment"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "PayeeEnrollment",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "billing-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "billing-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "PayeeEnrollment",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "billing-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "billing-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    }
+  }
+}

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/examples/2026-03-17-preview/Assessments_CreateOrUpdate_PayeeProfile.json

@@ -0,0 +1,65 @@
+{
+  "operationId": "Assessments_CreateOrUpdate",
+  "title": "Create or update the PayeeProfile assessment for a billing account",
+  "parameters": {
+    "resourceUri": "providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31",
+    "api-version": "2026-03-17-preview",
+    "resource": {
+      "properties": {
+        "assessmentType": "PayeeProfile"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "PayeeProfile",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "billing-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "billing-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    },
+    "201": {
+      "headers": {
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/22222222-2222-2222-2222-222222222222?api-version=2026-03-17-preview",
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      },
+      "body": {
+        "id": "/providers/Microsoft.Billing/billingAccounts/abc123:00000000-0000-0000-0000-000000000000_2019-05-31/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "PayeeProfile",
+          "evaluationState": "pending",
+          "provisioningState": "Accepted"
+        },
+        "systemData": {
+          "createdBy": "billing-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "billing-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:00:00.000Z"
+        }
+      }
+    }
+  }
+}

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/examples/2026-03-17-preview/Assessments_Delete.json

@@ -0,0 +1,18 @@
+{
+  "operationId": "Assessments_Delete",
+  "title": "Delete the Edu assessment for an enrollment",
+  "parameters": {
+    "resourceUri": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default",
+    "api-version": "2026-03-17-preview"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/33333333-3333-3333-3333-333333333333?api-version=2026-03-17-preview",
+        "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.BillingTrust/locations/westus2/operationStatuses/33333333-3333-3333-3333-333333333333?api-version=2026-03-17-preview",
+        "Retry-After": 30
+      }
+    },
+    "204": {}
+  }
+}

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/examples/2026-03-17-preview/Assessments_Get.json

@@ -0,0 +1,30 @@
+{
+  "operationId": "Assessments_Get",
+  "title": "Get the Edu assessment for an enrollment",
+  "parameters": {
+    "resourceUri": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default",
+    "api-version": "2026-03-17-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default/providers/Microsoft.BillingTrust/assessments/default",
+        "name": "default",
+        "type": "Microsoft.BillingTrust/assessments",
+        "properties": {
+          "assessmentType": "Edu",
+          "evaluationState": "succeeded",
+          "provisioningState": "Succeeded"
+        },
+        "systemData": {
+          "createdBy": "edu-admin@contoso.com",
+          "createdByType": "User",
+          "createdAt": "2026-03-17T10:00:00.000Z",
+          "lastModifiedBy": "edu-admin@contoso.com",
+          "lastModifiedByType": "User",
+          "lastModifiedAt": "2026-03-17T10:15:00.000Z"
+        }
+      }
+    }
+  }
+}

specification/billingtrust/resource-manager/Microsoft.BillingTrust/BillingTrust/examples/2026-03-17-preview/Assessments_List.json

@@ -0,0 +1,34 @@
+{
+  "operationId": "Assessments_List",
+  "title": "List assessments for an enrollment scope",
+  "parameters": {
+    "resourceUri": "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default",
+    "api-version": "2026-03-17-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/billing-edu-rg/providers/Microsoft.Program/educationEnrollments/default/providers/Microsoft.BillingTrust/assessments/default",
+            "name": "default",
+            "type": "Microsoft.BillingTrust/assessments",
+            "properties": {
+              "assessmentType": "Edu",
+              "evaluationState": "succeeded",
+              "provisioningState": "Succeeded"
+            },
+            "systemData": {
+              "createdBy": "edu-admin@contoso.com",
+              "createdByType": "User",
+              "createdAt": "2026-03-17T10:00:00.000Z",
+              "lastModifiedBy": "edu-admin@contoso.com",
+              "lastModifiedByType": "User",
+              "lastModifiedAt": "2026-03-17T10:15:00.000Z"
+            }
+          }
+        ]
+      }
+    }
+  }
+}