---
updatedAt: 2025-11-11T23:14:38.000Z
agentTools:
projectIndex: https://developers.fortresstrust.com/llms.txt
---
# Manually review a business identity, which may result in suspension or unsuspension based on the decision. (Auth)
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Fortress.Identity Api",
"version": "2.0"
},
"servers": [
{
"url": "https://api.sandbox.fortressapi.com/"
}
],
"paths": {
"/api/compliance/v2/business-identities/{identityId}/verify": {
"post": {
"tags": [
"BusinessIdentities"
],
"summary": "Manually review a business identity, which may result in suspension or unsuspension based on the decision. (Auth)",
"parameters": [
{
"name": "identityId",
"in": "path",
"description": "Identity id",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
}
],
"requestBody": {
"description": "The data.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ManualIdentityVerificationByOrgRequestModel"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ManualIdentityVerificationByOrgRequestModel"
}
},
"application/*+json": {
"schema": {
"$ref": "#/components/schemas/ManualIdentityVerificationByOrgRequestModel"
}
}
}
},
"responses": {
"200": {
"description": "Identity was successfully updated",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BusinessUserIdentityModelV2"
}
}
}
},
"400": {
"description": "Bad request model data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
},
"examples": {
"Example 1": {
"summary": "Bad request result",
"value": {
"title": "string",
"status": 400,
"traceId": "string",
"path": "string",
"errors": {
"00000000-0000-0000-0000-000000000000": [
"Validation error"
]
}
}
},
"Example 2": {
"summary": "Invalid data",
"value": {
"title": "One or more validation errors occured.",
"status": 400,
"traceId": "string",
"path": "string",
"errors": {
"string": [
"string"
]
}
}
},
"Example 3": {
"summary": "Exeption",
"value": {
"title": "string",
"status": 400,
"traceId": "string",
"path": "string",
"errors": {}
}
}
}
}
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Identity not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
},
"examples": {
"Example 1": {
"summary": "Validation exception",
"value": {
"title": "string",
"status": 404,
"traceId": "string",
"path": "string",
"errors": {
"00000000-0000-0000-0000-000000000000": [
"Validation error"
]
}
}
},
"Example 2": {
"summary": "Not found",
"value": {
"type": "string",
"title": "Not Found",
"status": 404,
"traceId": "string"
}
}
}
}
}
}
},
"security": [
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"AddressModel": {
"required": [
"city",
"country",
"street1"
],
"type": "object",
"properties": {
"street1": {
"minLength": 1,
"type": "string",
"description": "Gets or sets the first street"
},
"street2": {
"type": "string",
"description": "Gets or sets the second street",
"nullable": true
},
"postalCode": {
"type": "string",
"description": "Gets or sets the postal code (ZIP code)",
"nullable": true
},
"city": {
"minLength": 1,
"type": "string",
"description": "Gets or sets the city"
},
"state": {
"type": "string",
"description": "Gets or sets the state",
"nullable": true
},
"country": {
"minLength": 1,
"type": "string",
"description": "Gets or sets the country"
}
},
"additionalProperties": false,
"description": "Represents Address model"
},
"BusinessDocumentType": {
"enum": [
"other",
"proofOfAddress",
"proofOfCompanyFormation",
"formationDocument",
"agreement",
"taxIdDocument"
],
"type": "string"
},
"BusinessIndustry": {
"enum": [
"b2b",
"b2c",
"accounting",
"aerospace",
"agriculture",
"aquaticsMarine",
"automotive",
"businessServices",
"charity",
"computerSoftware",
"construction",
"cryptoBlockchain",
"education",
"energy",
"engineering",
"entertainment",
"environmentGreen",
"farming",
"fashion",
"financialServices",
"franchise",
"gaming",
"gigEconomy",
"government",
"hospitality",
"informationTechnology",
"insurance",
"internet",
"international",
"lawEnforcementMilitary",
"lifestyle",
"manufacturing",
"marketingServices",
"mediaPublishing",
"medical",
"mobileApps",
"music",
"naturalResources",
"networkMarketing",
"performingArts",
"personalServices",
"professionalServices",
"realEstate",
"recreation",
"retail",
"royalties",
"science",
"securities",
"shippingTransportation",
"software",
"storageWarehousing",
"supplier",
"technology",
"transportation",
"wholesale",
"other",
"art"
],
"type": "string"
},
"BusinessUserIdentityModelV2": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"kycLevel": {
"type": "string",
"nullable": true
},
"type": {
"$ref": "#/components/schemas/UserIdentityType"
},
"status": {
"$ref": "#/components/schemas/UserIdentityStatus"
},
"address": {
"$ref": "#/components/schemas/AddressModel"
},
"email": {
"type": "string",
"nullable": true
},
"phone": {
"type": "string",
"nullable": true
},
"isSuspended": {
"type": "boolean"
},
"suspendReason": {
"type": "string",
"nullable": true
},
"documents": {
"type": "array",
"items": {
"$ref": "#/components/schemas/DocumentModel"
},
"nullable": true
},
"companyName": {
"type": "string",
"nullable": true
},
"website": {
"type": "string",
"nullable": true
},
"description": {
"type": "string",
"nullable": true
},
"establishedOn": {
"type": "string",
"format": "date-time"
},
"mailingAddress": {
"$ref": "#/components/schemas/AddressModel"
},
"naics": {
"type": "string",
"nullable": true
},
"naicsDescription": {
"type": "string",
"nullable": true
},
"industry": {
"$ref": "#/components/schemas/BusinessIndustry"
},
"otherIndustry": {
"type": "string",
"nullable": true
},
"legalStructure": {
"$ref": "#/components/schemas/LegalStructure"
},
"otherLegalStructure": {
"type": "string",
"nullable": true
},
"beneficialOwners": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"nullable": true
},
"dbaName": {
"type": "string",
"nullable": true
},
"businessRegistrationNumber": {
"type": "string",
"nullable": true
},
"taxId": {
"type": "string",
"nullable": true
},
"countryOfFormation": {
"type": "string",
"nullable": true
},
"stateOfFormation": {
"type": "string",
"nullable": true
},
"regionOfFormation": {
"type": "string",
"nullable": true
}
},
"additionalProperties": false
},
"DocumentModel": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"identityId": {
"type": "string",
"format": "uuid"
},
"personalDocumentType": {
"$ref": "#/components/schemas/PersonalDocumentType"
},
"businessDocumentType": {
"$ref": "#/components/schemas/BusinessDocumentType"
},
"documentReferenceId": {
"type": "string",
"format": "uuid",
"nullable": true
},
"documentUuid": {
"type": "string",
"format": "uuid",
"nullable": true
},
"documentCheckStatus": {
"$ref": "#/components/schemas/DocumentStatus"
},
"isVerified": {
"type": "boolean",
"readOnly": true
}
},
"additionalProperties": false
},
"DocumentStatus": {
"enum": [
"pending",
"automaticReviewInProgress",
"manualReviewNeeded",
"accepted",
"rejected",
"resubmit"
],
"type": "string"
},
"LegalStructure": {
"enum": [
"ccorp",
"llc",
"partnership",
"nonprofit",
"scorp",
"soleprop",
"other",
"ira",
"trust",
"corporation"
],
"type": "string"
},
"ManualIdentityVerificationByOrgRequestModel": {
"required": [
"comment",
"decision"
],
"type": "object",
"properties": {
"decision": {
"$ref": "#/components/schemas/ManualVerificationDecision"
},
"comment": {
"maxLength": 50,
"minLength": 4,
"type": "string"
}
},
"additionalProperties": false
},
"ManualVerificationDecision": {
"enum": [
"approve",
"suspend"
],
"type": "string",
"description": "Update identity decisions"
},
"PersonalDocumentType": {
"enum": [
"license",
"identificationCard",
"passport"
],
"type": "string"
},
"ProblemDetails": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"status": {
"type": "integer",
"format": "int32",
"nullable": true
},
"detail": {
"type": "string",
"nullable": true
},
"instance": {
"type": "string",
"nullable": true
}
},
"additionalProperties": {}
},
"UserIdentityStatus": {
"enum": [
"active",
"inactive",
"inactivationStarted"
],
"type": "string"
},
"UserIdentityType": {
"enum": [
"personal",
"business"
],
"type": "string"
}
},
"securitySchemes": {
"Bearer": {
"type": "apiKey",
"description": "Put access token in the box below.
For example: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6I",
"name": "Authorization",
"in": "header"
}
}
},
"security": [
{
"Bearer": []
}
],
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```