Tax Status

Description

Ecuador Tax Regime Check for Individuals allows clients to verify the tax registration and tax regime status of an Ecuadorian individual against public taxpayer information maintained by the Servicio de Rentas Internas.

The service checks whether the submitted Ecuadorian ID number or RUC is associated with an active taxpayer record and returns the individual's taxpayer status, tax regime, taxpayer class, accounting obligation, economic activity, and registered tax address when available.

For individuals, the service can identify whether the taxpayer is under the General Regime or the RIMPE regime. The SRI states that RIMPE covers Popular Businesses and Entrepreneurs; Popular Businesses are natural persons with annual gross income up to USD 20,000, while Entrepreneurs may include natural persons and companies with annual gross income up to USD 300,000.

This check is useful for KYC, KYB support, merchant onboarding, tax compliance screening, fraud prevention, and identity enrichment where the client needs to confirm whether a person is registered as a taxpayer in Ecuador and under which tax regime.

HTTP method POST

Endpoint

https://api.msla-id.com/experience-idv-taxes-api-v1/api/idv-govcheck/v1/ecu-identity/person-check

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

info

Before proceeding, make sure you have your jwt token, if you don't have it, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

Request body parameters

NAME	REQUIRED	TYPE	DESCRIPTION
ruc	✅	string	Ecuador's tax id number.

The ruc parameter is required in the request.

Status code responses

Code	Description
200	OK
400	Bad request — IDV-3001
401	Unauthorized
403	Forbidden — IDV-1004
404	Not found — IDV-1002 Data not found.
500	Internal server error — IDV-1008
504	Gateway timeout — IDV-1100

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "25998249a38f3ac1",
    "timestamp": "2026-06-22 14:55:49",
    "data": {
        "idNumber": "13",
        "ruc": "0190167186001",
        "fullName": "CONSTRUCTORA MEDINA MEDOCIV CIA LTDA",
        "taxpayerType": "SOCIEDAD",
        "taxpayerStatus": "PASIVO",
        "taxpayerClass": "GEN",
        "obligedToKeepAccounting": "S",
        "activityStartDate": "19990704 000000",
        "economicActivity": {
            "code": "M711021",
            "description": "ACTIVIDADES DE DISENO DE INGENIERIA ES DECIR APLICACION DE LAS LEYES FISICAS Y DE LOS PRINCIPIOS DE INGENIERIA AL DISENO DE MAQUINAS MATERIALES INSTRUMENTOS ESTRUCTURAS PROCESOS Y SISTEMAS Y ASESORIA DE INGENIERIA PARA MAQUINARIA PROCESOS Y PLANTAS INDUSTRIALES"
        },
        "registeredLocation": {
            "province": "AZUAY",
            "canton": "CUENCA",
            "parish": "BELLAVISTA"
        },
        "establishment": {
            "establishmentNumber": "1",
            "establishmentStatus": "CER",
            "commercialName": ""
        }
    }
}

Response 400 status code

{
    "traceId": "76b3e0a80adc6585",
    "timestamp": "2024-04-04 17:25:44",
    "code": "IDV-3001",
    "message": "Provider error, contact with the administrator.",
    "data": null
}

Response 403 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1004",
    "message": "Forbidden",
    "data": null
}

Response 404 status code

{
    "traceId": "ef2407b8c0df635c",
    "timestamp": "2023-05-22 17:25:55",
    "code": "IDV-1002",
    "message": "Data not found."
}

Response 500 status code

{
    "traceId": "86c6eda02b615604",
    "timestamp": "2024-01-09 15:44:32",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administrator!",
    "data": null
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}