Check an RFC against the SAT lists

GET

https://api.gigstack.io/v2/sat-lists/check/{rfc}

Checks whether an RFC appears on any of the SAT lists gigstack tracks, and returns every matching entry.

Use this before invoicing a counterparty: is_risky is true when the RFC appears on at least one list
flagged as risky (Cancelados, Definitivos 69-B, Presuntos 69-B, No localizados, CSD sin efectos, …),
and risky_lists names exactly which ones.

An RFC that appears on no list returns 200 with found: false — a clean RFC is not a 404.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

RFC checked against the SAT lists

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.gigstack.io/v2/sat-lists/check/?risky_only=undefined' \
--header 'Authorization: <api-key>'

Response Example

200 - Example 1

{
    "message": "Operation completed successfully",
    "data": {
        "rfc": "XAXX010101000",
        "found": true,
        "is_risky": true,
        "risky_lists": [
            "art_69b_definitivos"
        ],
        "entries": [
            {
                "list_key": "art_69b_definitivos",
                "list_label": "Definitivos 69-B",
                "source": "art_69",
                "is_risky": true,
                "detail": {},
                "last_seen_at": "2019-08-24T14:15:22.123Z"
            }
        ]
    }
}

Modified at 2026-07-13 18:47:45

List SAT lists and sync status

Apidog connectivity test