Skip to main content
POST
/
api
/
sat
/
taxpayers
/
list
/sat/taxpayers/list
curl --request POST \
  --url https://api.anysite.io/api/sat/taxpayers/list \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "supuesto": "CANCELADOS POR INSOLVENCIA",
  "entidad": "JALISCO"
}
'
[
  {
    "rfc": "<string>",
    "name": "<string>",
    "@type": "@sat_taxpayer",
    "situacion": "<string>",
    "tipo_persona": "<string>",
    "entidad": "<string>",
    "monto": "<string>",
    "publication_date": "<string>",
    "amount_publication_date": "<string>",
    "cancellation_date": "<string>",
    "detail_69b": {
      "@type": "@sat_taxpayer69b_detail",
      "presuncion": {
        "@type": "@sat_taxpayer69b_stage",
        "oficio_sat": "<string>",
        "fecha_sat": "<string>",
        "oficio_dof": "<string>",
        "fecha_dof": "<string>"
      },
      "desvirtuaron": {
        "@type": "@sat_taxpayer69b_stage",
        "oficio_sat": "<string>",
        "fecha_sat": "<string>",
        "oficio_dof": "<string>",
        "fecha_dof": "<string>"
      },
      "definitivos": {
        "@type": "@sat_taxpayer69b_stage",
        "oficio_sat": "<string>",
        "fecha_sat": "<string>",
        "oficio_dof": "<string>",
        "fecha_dof": "<string>"
      },
      "sentencia_favorable": {
        "@type": "@sat_taxpayer69b_stage",
        "oficio_sat": "<string>",
        "fecha_sat": "<string>",
        "oficio_dof": "<string>",
        "fecha_dof": "<string>"
      }
    }
  }
]

Authorizations

​
access-token
string
header
required

API token from the dashboard

Headers

​
access-token
string
required

Body

application/json
​
list_type
enum<string>
required

Which blacklist to read

Available options:
art_69b,
firmes,
cancelados,
no_localizados,
condonados,
exigibles,
sentencias,
retorno_inversiones
​
count
integer
required

Max result count

Required range: x >= 1
Example:

20

​
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
​
situacion
enum<string> | null

Filter Art. 69-B records by situación (only applies to the art_69b list)

Available options:
presunto,
desvirtuado,
definitivo,
sentencia_favorable
​
supuesto
string | null

Filter Art. 69 records by supuesto (case-insensitive substring), e.g. the cancelados sub-types CANCELADOS or CANCELADOS POR INSOLVENCIA

Example:

"CANCELADOS POR INSOLVENCIA"

​
tipo_persona
enum<string> | null

Filter by taxpayer kind: F (individual) or M (legal entity)

Available options:
F,
M
​
entidad
string | null

Filter by federal entity / state (case-insensitive substring)

Example:

"JALISCO"

Response

Successful Response

​
rfc
string
required
​
name
string
required
​
list_type
enum<string>
required
Available options:
art_69b,
firmes,
cancelados,
no_localizados,
condonados,
exigibles,
sentencias,
retorno_inversiones
​
@type
string
default:@sat_taxpayer
​
situacion
string | null
​
tipo_persona
string | null
​
entidad
string | null
​
monto
string | null
​
publication_date
string | null
​
amount_publication_date
string | null
​
cancellation_date
string | null
​
detail_69b
SatTaxpayer69bDetail · object