--- updatedAt: 2026-06-03T16:27:31.000Z agentTools: projectIndex: https://developer.markaaz.com/llms.txt --- # Shareholder Data Shareholder Data # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Markaaz API Services 2.0", "description": "Markaaz API Services 2.0", "termsOfService": "https://markaaz.com/terms-and-conditions/", "contact": { "email": "support@markaaz.com" }, "license": { "name": "Copyright ©2023 Markaaz Inc. All rights reserved." }, "version": "v2.0" }, "security": [ { "Partner_API_Key": [] } ], "paths": { "/v2.0/business/shareholder": { "post": { "operationId": "v2.0_business_shareholder_create", "summary": "Shareholder Data", "description": "Shareholder Data", "parameters": [ { "name": "x-partner-id", "in": "header", "description": "Partner Id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "$ref": "#/components/requestBodies/VerificationRequest" }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ShareholderDataResponseMarkaazRoot" } } } }, "207": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MultiStatusWithoutConfidenceRootResponse" } } } }, "400": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestResponse" } } } }, "403": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnAuthorizedBizResponse" } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceNotFoundResponse" } } } }, "429": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TooManyRequestsResponse" } } } }, "500": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerErrorBizResponse" } } } }, "504": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayTimeoutResponse" } } } } }, "tags": [ "Markaaz Business Verification" ] }, "parameters": [] } }, "servers": [ { "url": "https://api-partner-sandbox.app.markaaz.com" }, { "url": "http://api-partner-sandbox.app.markaaz.com" } ], "components": { "requestBodies": { "VerificationRequest": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerificationRequest" } } }, "required": true } }, "securitySchemes": { "Partner_API_Key": { "type": "apiKey", "description": "Partner API Key", "name": "x-api-key", "in": "header" } }, "schemas": { "BadRequestResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "integer" }, "errors": { "title": "errors", "description": "errors", "type": "object" } } } }, "title": "Bad Request Response", "description": "Bad Request Response Data" }, "UnAuthorizedBizResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "integer" } } } }, "title": "UnAuthorized Response", "description": "UnAuthorized Response Data" }, "ResourceNotFoundResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "number" } } } }, "title": "Resource Not Found", "description": "Resource Not Found or bad URL" }, "TooManyRequestsResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "number" } } } }, "title": "Too Many Requests", "description": "Too many requests. Please try again later." }, "ServerErrorBizResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "number" }, "errors": { "title": "errors", "description": "Errors", "type": "string" } } } }, "title": "Server Error Response", "description": "Server Error Response Data" }, "GatewayTimeoutResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "integer" } } } }, "title": "Gateway Timeout Error Response", "description": "Gateway Timeout Error Response Data" }, "VerificationRequest": { "required": [ "markaazId" ], "type": "object", "properties": { "markaazId": { "title": "markaazId", "description": "markaazId", "type": "string", "maxLength": 16 }, "epInternalId": { "title": "epInternalId", "description": "A unique business identifier in the partners backend system. This can be provided for easier traceability between a partner system and a Markaaz ID.", "type": "string", "maxLength": 250 } } }, "MultiStatusWithoutConfidenceRootResponse": { "type": "object", "properties": { "traceId": { "title": "Traceid", "type": "string", "format": "uuid" }, "message": { "title": "Message", "type": "string", "maxLength": 200, "minLength": 1 }, "messageId": { "title": "Messageid", "type": "integer" } } }, "ShareholderDataResponseMarkaazRoot": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "markaazId": { "title": "markaazId", "description": "Markaaz Id", "type": "string" }, "epInternalId": { "title": "epInternalId", "description": "A unique business identifier in the partners backend system. This can be provided for easier traceability between a partner system and a Markaaz ID. Matching does not store the epInternalId.", "type": "string", "maxLength": 250 }, "bizInfo": { "title": "bizInfo", "description": "Business information data", "type": "object", "properties": { "dba": { "title": "DBA", "description": "Doing Business As", "type": "string", "maxLength": 1000 }, "legalName": { "title": "legalName", "description": "Business Legal Name", "type": "string", "maxLength": 1000 }, "taxId": { "title": "taxId", "description": "Business Tax Id", "type": "string", "maxLength": 100 }, "nationalId": { "title": "nationalId", "description": "National Id", "type": "string", "maxLength": 500 }, "addresses": { "title": "addresses", "description": "Addresses", "type": "array", "items": { "title": "AddressesItem", "description": "Addresses", "type": "object", "properties": { "type": { "title": "type", "description": "Indicates the type of address such as Primary, Registered or Secondary.", "type": "string" }, "line1": { "title": "line1", "description": "The first line of the address.", "type": "string" }, "line2": { "title": "line2", "description": "The second line of the address", "type": "string" }, "locality": { "title": "locality", "description": "The locality or city in which the business is based in.", "type": "string" }, "region": { "title": "region", "description": "The region or state in which the business is based in.", "type": "string" }, "postalCode": { "title": "postalCode", "description": "The postal code of the area in which the business is based in.", "type": "string" }, "country": { "title": "country", "description": "The country where the business is based in.", "type": "string" }, "latitude": { "title": "latitude", "description": "The latitude of the location of the business.", "type": "string" }, "longitude": { "title": "longitude", "description": "The longitude of the location of the business.", "type": "string" }, "geoprecision": { "title": "geoprecision", "description": "The geoprecision field.", "type": "string" }, "businessIndicator": { "title": "businessIndicator", "description": "The businessIndicator field.", "type": "string" }, "residentialIndicator": { "title": "residentialIndicator", "description": "The residentialIndicator field.", "type": "string" }, "sohoIndicator": { "title": "sohoIndicator", "description": "The small office home office inidcator.", "type": "string" } } } } } }, "CompanyShareholders": { "title": "CompanyShareholders", "description": "Shareholder details", "type": "object", "properties": { "companyShareDetails": { "title": "companyShareDetails", "description": "companyShareDetails", "type": "object", "properties": { "issuedShareCurrency": { "title": "issuedShareCurrency", "description": "Issued Share Currency", "type": "string" }, "issuedShareCapital": { "title": "issuedShareCapital", "description": "Issued Share Capital", "type": "number" }, "totalShareCurrency": { "title": "totalShareCurrency", "description": "Total Share Currency", "type": "string" }, "maxShareCapital": { "title": "maxShareCapital", "description": "Max Share Capital", "type": "number" }, "totalIssuedShares": { "title": "totalIssuedShares", "description": "Total Issued Shares", "type": "integer" } } }, "shareholder": { "title": "shareholder", "description": "shareholder", "type": "object", "properties": { "shareholderName": { "title": "shareholderName", "description": "Shareholder Name", "type": "string" }, "shareholderType": { "title": "shareholderType", "description": "Shareholder Type", "type": "string" }, "shareholderAddress": { "title": "shareholderAddress", "description": "shareholderAddress", "type": "object", "properties": { "line1": { "title": "line1", "description": "Line 1 Address", "type": "string" }, "locality": { "title": "locality", "description": "Locality", "type": "string" }, "region": { "title": "region", "description": "Region", "type": "string" }, "country": { "title": "country", "description": "Country", "type": "string" }, "postalCode": { "title": "postalCode", "description": "Postal Code", "type": "string" }, "addressType": { "title": "addressType", "description": "Address Type", "type": "string" } } }, "totalShareValue": { "title": "totalShareValue", "description": "totalShareValue", "type": "number" }, "totalShareNumber": { "title": "totalShareNumber", "description": "totalShareNumber", "type": "integer" }, "percentSharesOwned": { "title": "percentSharesOwned", "description": "percentSharesOwned", "type": "number" } } } } } } } }, "title": "markaaz", "description": "Markaaz root" } } } } ```