MarminDeveloper Docs
BusinessesPartnersProduct Wiki

Request claim OTP

Use this endpoint to request a verification code (OTP) for claiming a business profile in Marmin after the business has selected M A R M I N AI Software Design LLC as its ASP on the EmaraTax portal. See the right panel for the base URL, request samples, and response JSON.

In the partner onboarding path, authenticate with the account-scoped access token from Obtain Account Access Token (not the partner JWT).

When you call this API, Marmin validates the provided TIN and EmaraTax email, then generates a one-time verification code and sends it to the specified email address.

Request body
FieldTypeRequiredDescription
emailstring
Required
The EmaraTax-registered email address for the business (for example, user@example.com). The OTP will be sent to this address and it must match the email stored in EmaraTax for the specified TIN.
tinstring
Required
The business Tax Identification Number (TIN) as registered in EmaraTax. Used to identify the business you want to claim.
Response

Status code: 200 OK

Returns a confirmation message indicating that a verification code has been sent to the provided email.

Error responses
StatusDescription
400 Bad RequestThe request body is invalid, required fields are missing, or the email/TIN combination does not match an eligible business to claim.
401 UnauthorizedAuthentication required or the access token is invalid.
403 ForbiddenThe authenticated user is not allowed to claim this business.
404 Not FoundNo business was found for the provided TIN (or matching EmaraTax email).
500 Internal Server ErrorAn error occurred while processing the request.
Next