Validate client fiscal information

POST

https://api.gigstack.io/v2/clients/validate/{id}

Re-runs the full SAT validation for a client on demand. Performs three independent checks in parallel
and persists the results on the client doc (is_valid, efos, sat_status):

Fiscal validation — attempts to stamp a test CFDI against the PAC. Detects RFC/legal_name/CP mismatches with SAT registry.

EFOS check — Facturapi tools.validateTaxId, checks Art. 69-B blacklist.

SAT lists — fan-out lookup across 20 Datos Abiertos lists (Art. 69 Cancelados/Firmes/No localizados/CSD sin efectos/..., Art. 69-B Definitivos/Presuntos/..., Art. 69-B Bis). Lists are refreshed weekly from sat.gob.mx.

gigstack Connect: Validate other teams' clients using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Client validated successfully

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/clients/validate/?team' \
--header 'Authorization: <api-key>'

Response Example

{
    "success": true,
    "message": "Client info validated successfully",
    "data": {
        "fiscal_validation": {
            "status": "not_valid",
            "message": "Fiscal info validation failed. El campo DomicilioFiscalReceptor del receptor..."
        },
        "efos": {
            "is_valid": false
        },
        "sat_status": {
            "is_risky": true,
            "efos": {
                "is_valid": false
            },
            "hits": [
                {
                    "list": "art_69b_definitivos",
                    "label": "Definitivos 69-B",
                    "source": "art_69b",
                    "is_risky": true,
                    "detail": {
                        "nombre_del_contribuyente": "ASESORES Y ADMINISTRADORES AGRICOLAS, S. DE R.L. DE C.V.",
                        "situacion_del_contribuyente": "Definitivo",
                        "publicacion_dof_definitivos": "28/06/2018"
                    }
                }
            ],
            "checked_at": 1776887458784
        }
    }
}

Modified at 2026-04-27 18:08:58

Create client

Get client customer portal access token