List SAT lists and sync status

GET

https://api.gigstack.io/v2/sat-lists

Returns every SAT list definition tracked by gigstack, together with the metadata from its most recent sync.

gigstack mirrors the RFC lists the SAT publishes under Artículo 69, Artículo 69-B and Artículo 69-B Bis.
The lists are re-synced automatically every Sunday from the SAT's published CSVs.

Each list carries an is_risky flag. Risky lists (for example Cancelados, Definitivos 69-B, No localizados,
CSD sin efectos) are the ones that indicate a counterparty you should not invoice; the remaining lists are
informational only.

The sync object is null for a list that has never completed a sync.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Responses

🟢200OK

application/json

SAT lists retrieved successfully

Bodyapplication/json

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "message": "Operation completed successfully",
    "data": [
        {
            "key": "art_69b_definitivos",
            "label": "Definitivos 69-B",
            "source": "art_69",
            "is_risky": true,
            "filename": "Listado_Definitivos.csv",
            "sync": {
                "last_sync_at": "2019-08-24T14:15:22.123Z",
                "last_status": "success",
                "row_count": 12843,
                "previous_row_count": 12790,
                "net_new": 53,
                "removed": 4,
                "duration_ms": 8421
            }
        }
    ]
}

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

Health check

Check an RFC against the SAT lists