Lookup sat · published by RFC

GET https://api.latinfo.dev/mx/sat/published/rfc/{rfc}

A published list entry, retaining its list family, official status and dates. Coverage: Corporate RFC entries in SAT article 69/69-B publication lists; not a general corporate census. Lookup by rfc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below. List status is source terminology; do not turn a publication into a broader legal conclusion. Returns all records as an array. Import time is not observation time; inspect freshness headers. Add limit (1–500) and offset to retrieve an explicit page; without them the complete original array is returned. X-Total-Count gives the exact row count; follow Link rel=next to retrieve all pages.

Contrato da fonte

Publicador: Servicio de Administracion Tributaria, Mexico
Cobertura: Corporate RFC entries in SAT article 69/69-B publication lists; not a general corporate census.
Significado do 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.
Padrão aceito: ^[A-Z&Ñ]{3}[0-9]{6}[A-Z0-9]{3}$
Quantidade de registros: many
Licença: A permissão de reutilização não foi verificada. Acesso público não equivale a uma licença de reutilização.

Limitações conhecidas

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

Contrato da fonte para agentes · Documentação da fonte

Autenticação necessária. As requisições REST usam uma chave de api do Latinfo. O console adiciona o cabeçalho de autorização e não armazena a chave.

Parâmetros

rfcstringpathobrigatório

RFC in the source's normalized format. Keep identifiers as strings; preserve leading zeros.

Example: AAA080808HL8

limitintegerquery

Optional page size. Supplying limit or offset enables explicit pagination; default page size is 100.

offsetintegerquery

Row offset, default 0. Keep the same source generation while collecting pages.

generationstringquery

Opaque source-generation guard, automatically included in the next-page Link. A changed generation returns 409; restart retrieval.

Exemplo de requisição

curl https://api.latinfo.dev/mx/sat/published/rfc/AAA080808HL8 \
  -H "Authorization: Bearer $LATINFO_API_KEY"

Respostas

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

Cabeçalhos da resposta

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 da resposta

[].rfc string obrigatório

Lookup by rfc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.

[].legal_name string obrigatório

Registered name published by the authority.

[].article string obrigatório

CFF article/list family derived from the official file path.

[].publication_list string obrigatório

Original SAT publication-list label.

[].official_status string obrigatório

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

[].sat_publication_date string obrigatório

Published sat publication date date. Format: DD/MM/YYYY.

[].dof_publication_date string obrigatório

Published dof publication date date. Format: DD/MM/YYYY.

[].source_url string obrigatório

Official source CSV URL containing the row.

Esquema de resposta

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "rfc": {
        "type": "string",
        "description": "Lookup by rfc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below."
      },
      "legal_name": {
        "type": "string",
        "description": "Registered name published by the authority.",
        "x-latinfo-meaning": "text"
      },
      "article": {
        "type": "string",
        "description": "CFF article/list family derived from the official file path.",
        "x-latinfo-meaning": "text"
      },
      "publication_list": {
        "type": "string",
        "description": "Original SAT publication-list label.",
        "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"
      },
      "sat_publication_date": {
        "type": "string",
        "description": "Published sat publication date date. Format: DD/MM/YYYY.",
        "x-latinfo-meaning": "date"
      },
      "dof_publication_date": {
        "type": "string",
        "description": "Published dof publication date date. Format: DD/MM/YYYY.",
        "x-latinfo-meaning": "date"
      },
      "source_url": {
        "type": "string",
        "description": "Official source CSV URL containing the row.",
        "x-latinfo-meaning": "text"
      }
    },
    "required": [
      "rfc",
      "legal_name",
      "article",
      "publication_list",
      "official_status",
      "sat_publication_date",
      "dof_publication_date",
      "source_url"
    ],
    "additionalProperties": false
  }
}

400Invalid identifier or query. Correct the input before retrying.