Mexico · mx_sat_published_search
OpenAPI

Search sat · published

GET https://api.latinfo.dev/mx/sat/published/search

Search the published legal_name index. Results are candidates, not confirmed identity matches. Confirm the country and identifier before fetching a profile. An empty list is not proof of absence.

Contrato de la fuente

Publicador
Servicio de Administracion Tributaria, Mexico
Cobertura
Corporate RFC entries in SAT article 69/69-B publication lists; not a general corporate census.
Qué representa un registro
A published list entry, retaining its list family, official status and dates.
Identificador
Lookup by rfc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Patrón admitido
^[A-Z&Ñ]{3}[0-9]{6}[A-Z0-9]{3}$
Cantidad de registros
many
Licencia
No se ha verificado el permiso de reutilización. El acceso público no equivale a una licencia de reutilización.

Limitaciones conocidas

  • List status is source terminology; do not turn a publication into a broader legal conclusion.

Contrato de la fuente para agentes · Documentación de la fuente

Requiere autenticación. Las solicitudes REST usan una clave de api de Latinfo. La consola agrega el encabezado de autorización y no guarda la clave.

Parámetros

qstringqueryobligatorio

Name query, 3–200 characters.

Ejemplo de solicitud

curl https://api.latinfo.dev/mx/sat/published/search?q=q \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respuestas

200Published source records. Missing data is not a clearance or a negative finding.

Encabezados de la respuesta

X-Latinfo-Imported-At

Import time, not the date of the government observation.

X-Source-Updated-At

Publisher update time, when known.

X-Latest-Observation-At

Latest date in returned records, when known.

X-Freshness-Status

string

CURRENT · DELAYED · STALE · UNKNOWN
X-Credits-Cost

Actual credits charged for this request.

X-Source-Generation

Opaque immutable source generation. Follow the guarded next-page Link when collecting a history.

X-Total-Count

Exact row count for this identifier when pagination is requested.

X-Page-Offset

integer

X-Page-Limit

integer

Link

Next page URL, rel=next. Absent at the end.

Content-Type: application/json

Campos de la respuesta

[].id string
[].legal_name string

Registered name published by the authority.

[].official_status string

Original SAT status or premise; not reclassified as a Latinfo risk conclusion.

Esquema de respuesta
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      },
      "legal_name": {
        "type": "string",
        "description": "Registered name published by the authority.",
        "x-latinfo-meaning": "text"
      },
      "official_status": {
        "type": "string",
        "description": "Original SAT status or premise; not reclassified as a Latinfo risk conclusion.",
        "x-latinfo-meaning": "text"
      }
    }
  }
}
400Invalid identifier or query. Correct the input before retrying.
No se documentó un cuerpo de respuesta.
401Missing or invalid API key. Authenticate before retrying.
No se documentó un cuerpo de respuesta.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
No se documentó un cuerpo de respuesta.
409Source generation changed during paginated retrieval. Restart from offset 0.
No se documentó un cuerpo de respuesta.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
No se documentó un cuerpo de respuesta.
503Source unavailable. Report unavailable, not an empty result.
No se documentó un cuerpo de respuesta.
Ejemplo JSON

Ejemplo ilustrativo del esquema. No es una respuesta en vivo.

[
  {
    "id": "string",
    "legal_name": "string",
    "official_status": "string"
  }
]

Procedencia y limitaciones

La cobertura varía por país y fuente pública. Un campo ausente no demuestra que el hecho no exista. Los registros públicos pueden tener retrasos o errores; revisa la evidencia y la fecha de la fuente antes de usar un resultado.