Mexico · mx_sat_published_rfc
OpenAPI

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.

Kontrata ng source

Publisher
Servicio de Administracion Tributaria, Mexico
Saklaw
Corporate RFC entries in SAT article 69/69-B publication lists; not a general corporate census.
Kahulugan ng tala
A published list entry, retaining its list family, official status and dates.
Identifier
Lookup by rfc as a string, preserving leading zeros. Accepted syntax and normalization are defined by the contract below.
Tinatanggap na pattern
^[A-Z&Ñ]{3}[0-9]{6}[A-Z0-9]{3}$
Bilang ng mga tala
many
Lisensya
Hindi pa nabeberipika ang pahintulot sa muling paggamit. Hindi lisensya sa muling paggamit ang pampublikong access.

Mga kilalang limitasyon

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

Kontrata ng source para sa mga agent · Dokumentasyon ng source

Kailangan ng authentication. Gumagamit ang REST request ng Latinfo api key. Idinaragdag ng console ang authorization header at hindi iniimbak ang key.

Mga parameter

rfcstringpathkailangan

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.

Halimbawa ng request

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

Mga tugon

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

Mga header ng tugon

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

Mga field ng tugon

[].rfc string kailangan

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

[].legal_name string kailangan

Registered name published by the authority.

[].article string kailangan

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

[].publication_list string kailangan

Original SAT publication-list label.

[].official_status string kailangan

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

[].sat_publication_date string kailangan

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

[].dof_publication_date string kailangan

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

[].source_url string kailangan

Official source CSV URL containing the row.

Response schema
{
  "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.
Walang nakadokumentong response body.
401Missing or invalid API key. Authenticate before retrying.
Walang nakadokumentong response body.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
Walang nakadokumentong response body.
409Source generation changed during paginated retrieval. Restart from offset 0.
Walang nakadokumentong response body.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
Walang nakadokumentong response body.
503Source unavailable. Report unavailable, not an empty result.
Walang nakadokumentong response body.
Halimbawang JSON

Halimbawa ng schema lamang. Hindi ito live na tugon.

[
  {
    "rfc": "string",
    "legal_name": "string",
    "article": "string",
    "publication_list": "string",
    "official_status": "string",
    "sat_publication_date": "string",
    "dof_publication_date": "string",
    "source_url": "string"
  }
]

Pinagmulan at mga limitasyon

Nag-iiba ang saklaw ayon sa bansa at pampublikong source. Ang nawawalang field ay hindi patunay na wala ang katotohanan. Maaaring maantala o magkamali ang mga rehistro; suriin ang ebidensya at petsa bago gamitin ang resulta.