Search sat · published
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.
Source contract
- Publisher
- Servicio de Administracion Tributaria, Mexico
- Coverage
- Corporate RFC entries in SAT article 69/69-B publication lists; not a general corporate census.
- Record meaning
- 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.
- Accepted pattern
^[A-Z&Ñ]{3}[0-9]{6}[A-Z0-9]{3}$- Cardinality
many- License
- Reuse permission has not been verified. Public access is not a reuse license.
Known limitations
- List status is source terminology; do not turn a publication into a broader legal conclusion.
Parameters
qstringqueryrequiredName query, 3–200 characters.
Request example
curl https://api.latinfo.dev/mx/sat/published/search?q=q \
-H "Authorization: Bearer $LATINFO_API_KEY"
Responses
200Published source records. Missing data is not a clearance or a negative finding.
Response headers
X-Latinfo-Imported-AtImport time, not the date of the government observation.
X-Source-Updated-AtPublisher update time, when known.
X-Latest-Observation-AtLatest date in returned records, when known.
X-Freshness-Statusstring
CURRENT · DELAYED · STALE · UNKNOWNX-Credits-CostActual credits charged for this request.
X-Source-GenerationOpaque immutable source generation. Follow the guarded next-page Link when collecting a history.
X-Total-CountExact row count for this identifier when pagination is requested.
X-Page-Offsetinteger
X-Page-Limitinteger
LinkNext page URL, rel=next. Absent at the end.
application/jsonResponse fields
[].id string[].legal_name stringRegistered name published by the authority.
[].official_status stringOriginal SAT status or premise; not reclassified as a Latinfo risk conclusion.
Response schema
{
"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.
401Missing or invalid API key. Authenticate before retrying.
404No published record, or identifier outside the legal-entity scope. Not proof that the company does not exist.
409Source generation changed during paginated retrieval. Restart from offset 0.
429Rate or credit limit exceeded. Inspect the response and rate-limit headers before retrying.
503Source unavailable. Report unavailable, not an empty result.
Example JSON
Illustrative schema example. This is not a live response.
[
{
"id": "string",
"legal_name": "string",
"official_status": "string"
}
]Provenance and limitations
Coverage varies by country and public source. A missing field is not evidence that the underlying fact does not exist. Public registries may be delayed or contain source errors; inspect the returned evidence and source date before relying on a result.