{"components":{"schemas":{"Certificate":{"properties":{"cer_base64":{"description":"Base64 DER of the .cer file. Null when SAT's CDN did not serve it.","type":["string","null"]},"curp":{"description":"Persona física certs only","type":["string","null"]},"email":{"type":["string","null"]},"legal_representative_curp":{"description":"Persona moral certs only","type":["string","null"]},"legal_representative_rfc":{"description":"Persona moral certs only","type":["string","null"]},"serial":{"description":"20-digit SAT certificate serial number","type":"string"},"status":{"description":"Activo, Caduco, or Revocado","type":"string"},"type":{"description":"FIEL (e.firma) or SELLO (CSD)","type":"string"},"valid_from_utc":{"format":"date-time","type":"string"},"valid_to_utc":{"format":"date-time","type":"string"}},"type":"object"},"CfdiRecord":{"description":"A CFDI as SAT's Verifica CFDI portal prints it. Values are the portal's text, unparsed; blank cells are null.","properties":{"efecto_comprobante":{"description":"Voucher type: Ingreso, Egreso, Traslado, Nómina, or Pago.","example":"Ingreso","type":["string","null"]},"es_cancelable":{"description":"Whether and how the CFDI can be cancelled.","example":"Cancelable sin aceptación","type":["string","null"]},"estado":{"description":"SAT's state, unchanged: Vigente or Cancelado.","example":"Vigente","type":["string","null"]},"estatus_cancelacion":{"description":"Cancellation request status, when one exists.","type":["string","null"]},"fecha_cancelacion":{"description":"Cancellation date, when cancelled.","type":["string","null"]},"fecha_certificacion":{"description":"Stamping (certification) date, SAT's format, no time zone.","example":"2024-05-06T17:46:06","type":["string","null"]},"fecha_emision":{"description":"Issue date, SAT's format, no time zone.","example":"2024-05-06T17:45:57","type":["string","null"]},"folio_sustitucion":{"description":"UUID of the replacing CFDI, for reason 01.","type":["string","null"]},"motivo":{"description":"Cancellation reason code (01–04), when cancelled.","type":["string","null"]},"nombre_emisor":{"description":"Issuer name as SAT prints it.","example":"ACME CONSULTORES","type":["string","null"]},"nombre_receptor":{"description":"Receiver name as SAT prints it.","example":"PUBLICO EN GENERAL","type":["string","null"]},"rfc_emisor":{"description":"Issuer RFC.","example":"ACM010101AAA","type":["string","null"]},"rfc_pac":{"description":"RFC of the PAC that stamped the CFDI.","example":"ACM010101AAA","type":["string","null"]},"rfc_receptor":{"description":"Receiver RFC.","example":"XAXX010101000","type":["string","null"]},"sello_cfdi":{"description":"Issuer seal verdict (e.g. Válido). Only for XML uploads.","type":["string","null"]},"sello_timbre_fiscal":{"description":"Stamp seal verdict (e.g. Válido). Only for XML uploads.","type":["string","null"]},"total":{"description":"Total as SAT prints it, currency-formatted.","example":"$1,000.00","type":["string","null"]},"uuid":{"description":"Folio fiscal (UUID).","example":"5FB2822E-396D-4725-8521-CDC4BDD20CCF","type":["string","null"]}},"type":"object"},"CommerceRegistryRecord":{"description":"One folio mercantil electrónico (FME). Datetimes are ISO 8601 in Mexico City local time, without an offset.","properties":{"acts":{"items":{"properties":{"act":{"type":["string","null"]},"document_number":{"type":["string","null"]},"filed_at":{"description":"Fecha de ingreso","type":["string","null"]},"form":{"description":"Forma precodificada","type":["string","null"]},"modality":{"type":["string","null"]},"nci":{"description":"Número de control interno","type":["string","null"]},"registered_at":{"description":"Fecha de inscripción","type":["string","null"]}},"type":"object"},"type":"array"},"business_line":{"description":"Giro","type":["string","null"]},"corporate_purpose":{"description":"Objeto social","type":["string","null"]},"curp":{"type":["string","null"]},"domicile":{"description":"Domicilio social","type":["string","null"]},"duration":{"description":"Duración de la sociedad","type":["string","null"]},"fme":{"description":"Folio mercantil electrónico","type":"string"},"legal_regime":{"description":"Régimen jurídico","type":["string","null"]},"municipality":{"type":["string","null"]},"name":{"description":"Razón social as registered","type":"string"},"nationality":{"type":["string","null"]},"person_type":{"enum":["moral","fisica",null],"type":["string","null"]},"prior_registration":{"description":"Antecedente registral","type":["string","null"]},"registered_at":{"description":"Fecha de inscripción","type":["string","null"]},"registry_office":{"description":"Oficina registral","type":["string","null"]},"rfc":{"type":["string","null"]},"shareholders":{"items":{"properties":{"birth_date":{"description":"YYYY-MM-DD, individual shareholders","type":["string","null"]},"curp":{"type":["string","null"]},"first_surname":{"type":["string","null"]},"incorporation_date":{"description":"YYYY-MM-DD, company shareholders","type":["string","null"]},"name":{"description":"Given names, or the company name","type":["string","null"]},"nationality":{"type":["string","null"]},"rfc":{"type":["string","null"]},"second_surname":{"type":["string","null"]},"series":{"type":["string","null"]},"share_value":{"description":"MXN amount per share as a decimal string, e.g. \"500.00\"","type":["string","null"]},"shares":{"type":["integer","null"]},"status":{"type":["string","null"]},"total_value":{"description":"MXN amount as a decimal string, e.g. \"49500.00\"","type":["string","null"]}},"type":"object"},"type":"array"},"state":{"description":"Entidad federativa","type":["string","null"]},"status":{"description":"Estatus FME, e.g. Abierto","type":["string","null"]},"supported":{"description":"false when the folio is kept in a state the API does not support yet; only fme, name, and registry_office are set.","type":"boolean"}},"type":"object"},"CsfTaxpayer":{"description":"A taxpayer as a Constancia de Situación Fiscal describes it. Dates are ISO 8601; other values are SAT's text. Fields that only one kind of taxpayer or one source has are omitted rather than null.","properties":{"address":{"description":"Fiscal address (domicilio fiscal).","properties":{"and_street":{"description":"Second cross street. Only in `document.data`.","example":"CALLE DOS","type":["string","null"]},"between_street":{"description":"First cross street. Only in `document.data`.","example":"CALLE UNO","type":["string","null"]},"exterior_number":{"description":"Número exterior.","example":"200","type":["string","null"]},"interior_number":{"description":"Número interior.","type":["string","null"]},"locality":{"description":"Localidad. Only in `document.data`.","example":"CUAUHTEMOC","type":["string","null"]},"municipality":{"description":"Municipio or demarcación territorial.","example":"CUAUHTEMOC","type":["string","null"]},"neighborhood":{"description":"Colonia.","example":"COLONIA DE EJEMPLO","type":["string","null"]},"state":{"description":"Entidad federativa.","example":"CIUDAD DE MEXICO","type":["string","null"]},"street":{"description":"Nombre de vialidad.","example":"AVENIDA DE EJEMPLO","type":["string","null"]},"street_type":{"description":"Tipo de vialidad.","example":"CALLE","type":["string","null"]},"tax_office":{"description":"SAT's local administration (AL). Only in `taxpayer`.","example":"CIUDAD DE MEXICO 1","type":["string","null"]},"zip":{"description":"Postal code.","example":"06600","type":["string","null"]}},"type":"object"},"birthdate":{"description":"Persona física only. Only in `taxpayer`.","example":"1980-01-01","type":["string","null"]},"capital_regime":{"description":"Persona moral only.","example":"SA DE CV","type":["string","null"]},"curp":{"description":"Persona física only.","example":"PEMJ800101HDFRRN07","type":["string","null"]},"economic_activities":{"description":"Economic activities the constancia prints. Only in `document.data`.","items":{"properties":{"activity":{"description":"Activity name.","example":"Servicios de consultoría en computación","type":["string","null"]},"end_date":{"description":"End date; null while current.","type":["string","null"]},"order":{"description":"SAT's order number.","type":"integer"},"percentage":{"description":"Share of income, 0-100.","type":"integer"},"start_date":{"description":"Start date.","example":"2001-01-01","type":["string","null"]}},"type":"object"},"type":"array"},"email":{"description":"Contact email, when SAT prints one.","type":["string","null"]},"incorporation_date":{"description":"Persona moral only. Only in `taxpayer`.","example":"2001-01-01","type":["string","null"]},"mothers_maiden_name":{"description":"Persona física only.","example":"MARTINEZ","type":["string","null"]},"name":{"description":"Full name, or the company's denominación or razón social.","example":"ACME CONSULTORES","type":["string","null"]},"names":{"description":"Given names. Persona física only.","example":"JUAN CARLOS","type":["string","null"]},"obligations":{"description":"Tax obligations the constancia prints: the returns and payments the taxpayer must file. Only in `document.data`.","items":{"properties":{"description":{"description":"The obligation.","example":"Pago definitivo mensual de IVA.","type":["string","null"]},"due":{"description":"When it falls due, in SAT's words.","example":"A más tardar el día 17 del mes inmediato posterior al periodo que corresponda.","type":["string","null"]},"end_date":{"description":"End date; null while current.","type":["string","null"]},"start_date":{"description":"Start date.","example":"2001-01-01","type":["string","null"]}},"type":"object"},"type":"array"},"paternal_surname":{"description":"Persona física only.","example":"PEREZ","type":["string","null"]},"person_type":{"enum":["fisica","moral"],"type":"string"},"regimes":{"description":"Tax regimes. `taxpayer` lists the current ones.","items":{"properties":{"end_date":{"description":"End date; null while current.","type":["string","null"]},"name":{"description":"Regime name.","example":"Régimen General de Ley Personas Morales","type":["string","null"]},"start_date":{"description":"Start date.","example":"2001-01-01","type":["string","null"]}},"type":"object"},"type":"array"},"start_date":{"description":"Start date of operations (fecha de inicio de operaciones).","example":"2001-01-01","type":["string","null"]},"status":{"description":"Status in the registry (estatus en el padrón).","example":"ACTIVO","type":["string","null"]},"status_date":{"description":"Date of the last status change.","example":"2001-01-01","type":["string","null"]},"trade_name":{"description":"Nombre comercial. Only in `document.data`.","example":"ACME","type":["string","null"]}},"type":"object"},"CurpIdentity":{"properties":{"associated_curps":{"description":"CURPs listed in the PDF's correction section. Included by default on CURP lookup/search. Empty array when none are listed; null when the document could not be read.","items":{"type":"string"},"type":["array","null"]},"birthdate":{"description":"DD/MM/YYYY","type":"string"},"certification":{"description":"Certification statement printed on the official PDF. Included by default on CURP lookup/search. Null when no statement is printed or the document could not be read.","example":"CURP Certificada: verificada con el Registro Civil","type":["string","null"]},"certified":{"description":"true when the official PDF prints a CURP certification statement (Registro Civil, SRE, or INM); false when the PDF was read successfully and no statement is present; null when the document could not be read. This is not a nationality or paperwork eligibility determination.","type":["boolean","null"]},"curp":{"type":"string"},"entity_birth":{"type":"string"},"homonimo":{"example":false,"type":"boolean"},"mothers_maiden_name":{"type":"string"},"names":{"type":"string"},"nationality":{"type":"string"},"paternal_surname":{"type":"string"},"probation_document":{"type":["string","null"]},"probation_document_data":{"type":"object"},"renapo_valid":{"type":"boolean"},"sex":{"type":"string"},"status_curp":{"type":"string"}},"type":"object"},"Error":{"properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error"],"type":"object"},"IneCredential":{"description":"The record INE returned for the credential, with INE's own field names.","properties":{"anio_emision":{"type":["string","null"]},"anio_registro":{"type":["string","null"]},"cic":{"type":["string","null"]},"clave_elector":{"type":["string","null"]},"distrito_federal":{"type":["string","null"]},"distrito_local":{"type":["string","null"]},"en_lista_nominal":{"type":["boolean","null"]},"en_padron_electoral":{"type":["boolean","null"]},"fecha_actualizacion":{"description":"When INE last updated the record, local time without offset.","type":["string","null"]},"fecha_consulta":{"format":"date","type":["string","null"]},"found":{"type":"boolean"},"mensaje":{"description":"INE's headline sentence, in Spanish.","type":["string","null"]},"modelo":{"enum":["d","e"],"type":"string"},"numero_emision":{"type":["string","null"]},"ocr":{"type":["string","null"]},"puede_votar":{"description":"True only when INE also places the holder in the Lista Nominal.","type":["boolean","null"]},"status":{"type":"string"},"vigencia":{"description":"Expiry date.","format":"date","type":["string","null"]},"vigente":{"description":"INE reports the credential as valid identification.","type":["boolean","null"]}},"type":"object"},"LegalRepresentative":{"properties":{"associated_curps":{"description":"CURPs listed in the PDF's correction section. Included by default on CURP lookup/search. Empty array when none are listed; null when the document could not be read.","items":{"type":"string"},"type":["array","null"]},"birthdate":{"description":"DD/MM/YYYY","type":"string"},"certification":{"description":"Certification statement printed on the official PDF. Included by default on CURP lookup/search. Null when no statement is printed or the document could not be read.","example":"CURP Certificada: verificada con el Registro Civil","type":["string","null"]},"certified":{"description":"true when the official PDF prints a CURP certification statement (Registro Civil, SRE, or INM); false when the PDF was read successfully and no statement is present; null when the document could not be read. This is not a nationality or paperwork eligibility determination.","type":["boolean","null"]},"curp":{"type":"string"},"entity_birth":{"type":"string"},"homonimo":{"example":false,"type":"boolean"},"mothers_maiden_name":{"type":"string"},"names":{"type":"string"},"nationality":{"type":"string"},"paternal_surname":{"type":"string"},"probation_document":{"type":["string","null"]},"probation_document_data":{"type":"object"},"renapo_valid":{"type":"boolean"},"sex":{"type":"string"},"status_curp":{"type":"string"}},"type":"object"},"SatListing":{"properties":{"article":{"description":"Article: 69, 69b, 69b_bis","type":"string"},"first_publication_date":{"description":"Date SAT first published the listing, when the list provides one","type":"string"},"name":{"type":"string"},"person_type":{"description":"M (moral) or F (física)","type":"string"},"situation":{"type":"string"},"state":{"type":"string"},"sub_list":{"description":"e.g. cancelados, firmes, no_localizados","type":"string"}},"type":"object"},"WebhookAccepted":{"properties":{"message":{"type":"string"},"status":{"example":"processing","type":"string"}},"type":"object"}},"securitySchemes":{"apiKey":{"description":"API key for authenticating requests. Generate keys from your dashboard after signing up.","in":"header","name":"x-api-key","type":"apiKey"}}},"externalDocs":{"description":"Full developer documentation","url":"https://inecheck.com/docs"},"info":{"contact":{"email":"help@inecheck.com","name":"INECheck Support","url":"https://inecheck.com/docs"},"description":"REST API for Mexican voter IDs (credencial para votar). Send the identifiers printed on the back of the credential and get INE's answer from its Lista Nominal service: whether the credential is current, with the elector key, districts, and validity date on record.\n\n## Endpoints by use case\n\n- `/ine/verify`: `cic` plus `id_ciudadano` (models E to J) or `ocr` (model D) → INE's verdict and record. 4–15 s. Use to confirm a voter ID is current before accepting it as identification.\n\n## RFC and CURP endpoints\n\nINECheck shares accounts with RFCCheck and CURPCheck. The same API key also calls the `/rfc/*` and `/cfdi/verify` endpoints (SAT registration, taxpayer profile, postal code, SAT lists, commerce registry, CFDI status), documented on RFCCheck, and the `/curp/*` endpoints (RENAPO lookup and search), documented on CURPCheck.","termsOfService":"https://inecheck.com/terms-and-conditions","title":"INECheck API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/cfdi/verify":{"post":{"description":"Asks SAT's Verifica CFDI portal whether a CFDI (factura) is registered and whether it is current or cancelled. Send either the folio search (`uuid`, `rfc_emisor`, `rfc_receptor`) or the CFDI itself as `xml`, never both. Upload the XML file as multipart/form-data (`curl -F xml=@factura.xml`), or send it as a string in a JSON body. Sending the XML also has SAT check the CFDI's seals (`sello_cfdi`, `sello_timbre_fiscal`). An answer without a record (`found: false`) costs 5 credits; `found: null` means SAT could not be reached and is not charged. ~3 s.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/cfdi-verify"},"operationId":"cfdiVerify","requestBody":{"content":{"application/json":{"example":{"rfc_emisor":"ACM010101AAA","rfc_receptor":"XAXX010101000","uuid":"5FB2822E-396D-4725-8521-CDC4BDD20CCF"},"schema":{"oneOf":[{"properties":{"rfc_emisor":{"description":"RFC of the issuer (emisor).","example":"ACM010101AAA","type":"string"},"rfc_receptor":{"description":"RFC of the receiver (receptor).","example":"XAXX010101000","type":"string"},"uuid":{"description":"Folio fiscal (UUID) of the CFDI, any case.","example":"5FB2822E-396D-4725-8521-CDC4BDD20CCF","format":"uuid","type":"string"}},"required":["uuid","rfc_emisor","rfc_receptor"],"title":"Folio search","type":"object"},{"properties":{"xml":{"description":"The CFDI XML document as a string, as stamped by the PAC (with its tfd:TimbreFiscalDigital).","type":"string"}},"required":["xml"],"title":"XML upload","type":"object"}]}},"multipart/form-data":{"schema":{"properties":{"xml":{"contentMediaType":"application/xml","description":"The CFDI XML file as stamped by the PAC (with its tfd:TimbreFiscalDigital).","type":"string"}},"required":["xml"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"cfdi":{"anyOf":[{"$ref":"#/components/schemas/CfdiRecord"},{"type":"null"}]},"found":{"description":"true = SAT returned the CFDI in `cfdi`; false = SAT answered without one (charged); null = SAT unreachable (not charged).","type":["boolean","null"]},"message":{"description":"Plain-language summary. For `no_encontrado` and `rechazado` it is SAT's own message, in Spanish.","type":"string"},"status":{"description":"`vigente` or `cancelado` when found, `no_encontrado` when SAT has no such CFDI, `rechazado` when the portal refused the request itself (e.g. an XML it could not read), null when `found` is null. A status SAT adds later is passed through lowercased, so treat unknown values as neither current nor cancelled.","examples":["vigente","cancelado","no_encontrado","rechazado"],"type":["string","null"]},"uuid":{"description":"Folio fiscal asked about, uppercased. For an XML upload it is read from the stamp; null when the XML carries none and SAT found nothing.","type":["string","null"]}},"type":"object"}}},"description":"Lookup completed. `found` is true / false / null."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to `invalid_fields` and `fields` listing every missing or malformed field. Sending both the folio fields and `xml` lists the ones sent."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Verify a CFDI with SAT"}},"/csf/verify":{"post":{"description":"Reads a Constancia de Situación Fiscal (CSF) and checks it with SAT's QR validator. Send one of: `file` (the constancia PDF, or a PNG/JPEG of it; upload it as multipart/form-data with `curl -F file=@constancia.pdf`, or send it as base64 in JSON), `qr` (the text of a QR code printed on the constancia, or an array with both), or `rfc` with `id_cif`. `taxpayer` is SAT's record today: fiscal address, regimes, and start date of operations. For a file, `document` adds what the PDF prints (including economic activities), whether SAT confirms it issued the constancia and when, and the differences between the PDF and SAT's current record. An answer without a record (`found: false`) costs 5 credits; `found: null` means SAT could not be reached and is not charged. ~2 s.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/csf-verify"},"operationId":"csfVerify","requestBody":{"content":{"application/json":{"example":{"id_cif":"10010100002","rfc":"ACME010101AAA"},"schema":{"oneOf":[{"properties":{"id_cif":{"description":"The idCIF printed under the taxpayer's name on the constancia's first page.","example":"10010100002","type":"string"},"rfc":{"description":"The taxpayer's RFC.","example":"ACME010101AAA","type":"string"}},"required":["rfc","id_cif"],"title":"RFC and idCIF","type":"object"},{"properties":{"qr":{"description":"The text of a QR code printed on the constancia (a siat.sat.gob.mx validadorqr URL), or an array with both. The first-page QR returns the taxpayer; the seal QR returns the issue date.","items":{"type":"string"},"type":["string","array"]}},"required":["qr"],"title":"QR code","type":"object"},{"properties":{"file":{"contentEncoding":"base64","description":"The constancia as base64: the PDF SAT generated, or a PNG or JPEG image of it. A `data:` URL prefix is accepted. Up to 8 MB.","type":"string"}},"required":["file"],"title":"File","type":"object"}]}},"multipart/form-data":{"schema":{"properties":{"file":{"contentMediaType":"application/pdf","description":"The constancia file: the PDF SAT generated, or a PNG or JPEG image of it. Up to 8 MB.","type":"string"}},"required":["file"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"document":{"description":"The constancia that was sent. Null unless a file or a seal QR was sent.","properties":{"age_days":{"description":"Days from `issued_at` to today in Mexico City.","type":["integer","null"]},"alert":{"description":"The verdict on the file. `edited`: SAT did not issue a constancia with this seal, or the file differs in `rfc`, `id_cif`, `issued_at`, `curp`, or `start_date`, which cannot change after issue. Reject it. `outdated_or_edited`: it differs only in data a taxpayer can change (address, regimes, status, name); ask for a new constancia, and treat a recent one (`age_days`) as suspicious. null: nothing differs, or there was nothing to compare.","examples":["edited","outdated_or_edited"],"type":["string","null"]},"data":{"anyOf":[{"$ref":"#/components/schemas/CsfTaxpayer"},{"type":"null"}],"description":"What the file prints. Null for an image or a scanned PDF."},"differences":{"description":"Fields that do not agree: `rfc`, `id_cif`, `issued_at`, `name`, `curp`, `start_date`, `status`, `status_date`, `address.*`, `regimes`. The taxpayer changed that data after the constancia was issued, or the file was edited.","example":["address.zip"],"items":{"type":"string"},"type":"array"},"issuance":{"description":"`verified`: SAT confirms it issued a constancia with this seal. `rejected`: SAT says it did not, or the seal belongs to another taxpayer. `not_verifiable`: the constancia predates SAT's online seal check, or the file has no seal QR. null: SAT could not be asked about the seal.","examples":["verified","rejected","not_verifiable"],"type":["string","null"]},"issued_at":{"description":"When the constancia was issued, Mexico City time, no zone. SAT's own record when `issuance` is `verified`; otherwise what the constancia states. Older constancias carry the date alone.","example":"2026-10-16T08:45:15","type":["string","null"]},"issued_in":{"description":"Place of issue the constancia prints.","example":"CUAUHTEMOC, CIUDAD DE MEXICO","type":["string","null"]},"matches_sat":{"description":"Whether `data` agrees with SAT's current record. Null when there is no `data` or no `taxpayer` to compare.","type":["boolean","null"]}},"type":["object","null"]},"found":{"description":"true = SAT has a constancia for that idCIF and RFC, with its current record in `taxpayer` (for a seal QR alone: SAT issued that constancia); false = SAT answered that it has none (charged); null = SAT unreachable (not charged).","type":["boolean","null"]},"id_cif":{"description":"idCIF asked about. Null when only a seal QR was sent.","type":["string","null"]},"message":{"description":"Plain-language summary. For `found: false` it is SAT's own message, in Spanish.","type":"string"},"rfc":{"description":"RFC asked about.","type":"string"},"taxpayer":{"anyOf":[{"$ref":"#/components/schemas/CsfTaxpayer"},{"type":"null"}],"description":"The taxpayer as SAT has it today."}},"type":"object"}}},"description":"Check completed. `found` is true / false / null."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to `invalid_fields` and `fields` listing every missing, mixed, or malformed field. A file that is not a PDF or image, or carries no constancia QR code, lists `file`."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Read and verify a Constancia de Situación Fiscal"}},"/curp/lookup":{"post":{"description":"Returns the identity RENAPO has registered for a CURP. The CURP is checked offline first; one that fails is rejected with `invalid_curp` without a RENAPO call and is not charged. A CURP RENAPO has no record of (`found: false`) costs 5 credits. ~2 s.","externalDocs":{"description":"Endpoint guide","url":"https://curpcheck.com/docs/endpoints/curp-lookup"},"operationId":"curpLookup","requestBody":{"content":{"application/json":{"schema":{"properties":{"curp":{"description":"The CURP (18 characters, any case)","example":"TU_CURP_REAL","type":"string"},"include_pdf":{"default":false,"description":"Include the official PDF as pdf_base64 at no extra credit cost.","type":"boolean"}},"required":["curp"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"examples":{"illustrative":{"summary":"Abbreviated illustrative response; identifiers and names are placeholders.","value":{"curp":"TU_CURP_REAL","found":true,"message":"Identity retrieved from RENAPO","person":{"associated_curps":[],"certification":"CURP Certificada: verificada con el Registro Civil","certified":true,"curp":"TU_CURP_REAL","homonimo":false,"mothers_maiden_name":"APELLIDO MATERNO","names":"NOMBRES","paternal_surname":"APELLIDO PATERNO","renapo_valid":true}}}},"schema":{"properties":{"curp":{"type":"string"},"found":{"description":"true = RENAPO returned the record in `person`; false = RENAPO did not return a single record (charged; `person.homonimo` is true when RENAPO reports a problem with the key); null = RENAPO unreachable (not charged).","type":["boolean","null"]},"message":{"type":"string"},"pdf_base64":{"contentEncoding":"base64","contentMediaType":"application/pdf","description":"Official RENAPO PDF; present only when include_pdf is true and found is true.","type":"string"},"person":{"anyOf":[{"$ref":"#/components/schemas/CurpIdentity"},{"type":"null"}]}},"type":"object"}}},"description":"Search completed. `found` is true / false / null."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to: `missing_curp` or `invalid_curp`."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Look up a CURP in RENAPO"}},"/curp/search":{"post":{"description":"Searches RENAPO by name, birth date, sex, and state of birth (the \"Datos personales\" form on gob.mx) and returns the CURP registered for that person. Names are uppercased and stripped of accents (Ñ and Ü stay). Every invalid field is reported at once in a 422. ~2 s.","externalDocs":{"description":"Endpoint guide","url":"https://curpcheck.com/docs/endpoints/curp-search"},"operationId":"curpSearch","requestBody":{"content":{"application/json":{"schema":{"properties":{"birthdate":{"example":"1980-01-01","format":"date","type":"string"},"include_pdf":{"default":false,"description":"Include the official CURP PDF in pdf_base64 at no extra credit cost. A PDF download failure returns found: null and is not charged.","type":"boolean"},"mothers_maiden_name":{"description":"Omit when the person has a single surname.","example":"MARTINEZ","type":"string"},"names":{"example":"JUAN","type":"string"},"paternal_surname":{"example":"PEREZ","type":"string"},"sex":{"enum":["H","M","X"],"type":"string"},"state":{"description":"Two-letter state of birth code as used in CURPs (e.g. DF, JC, NL), or NE for people born abroad.","example":"DF","type":"string"}},"required":["names","paternal_surname","birthdate","sex","state"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"examples":{"illustrative":{"summary":"Abbreviated illustrative response; identifiers and names are placeholders.","value":{"curp":"TU_CURP_REAL","found":true,"message":"Identity retrieved from RENAPO","person":{"associated_curps":[],"certification":"CURP Certificada: verificada con el Registro Civil","certified":true,"curp":"TU_CURP_REAL","homonimo":false,"mothers_maiden_name":"APELLIDO MATERNO","names":"NOMBRES","paternal_surname":"APELLIDO PATERNO","renapo_valid":true}}}},"schema":{"properties":{"curp":{"type":"string"},"found":{"description":"true = RENAPO returned the record in `person`; false = RENAPO did not return a single record (charged; `person.homonimo` is true when RENAPO reports a problem with the key); null = RENAPO unreachable (not charged).","type":["boolean","null"]},"message":{"type":"string"},"pdf_base64":{"contentEncoding":"base64","contentMediaType":"application/pdf","description":"Official RENAPO PDF; present only when include_pdf is true and found is true.","type":"string"},"person":{"anyOf":[{"$ref":"#/components/schemas/CurpIdentity"},{"type":"null"}]}},"type":"object"}}},"description":"Search completed. `found` is true / false / null."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to `invalid_fields` and `fields` listing every missing or malformed field."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Find a CURP by personal data"}},"/ine/verify":{"post":{"description":"Asks INE's Lista Nominal service whether a credencial para votar is current. Send `cic` and exactly one of `id_ciudadano` (models E to J) or `ocr` (model D). Values shorter than the full length are left-padded with zeroes. An answer without a record (`found: false`) costs 10 credits; `found: null` means INE could not be reached and is not charged. 4–15 s.","externalDocs":{"description":"Endpoint guide","url":"https://inecheck.com/docs/endpoints/ine-verify"},"operationId":"ineVerify","requestBody":{"content":{"application/json":{"example":{"cic":"123456789","id_ciudadano":"987654321"},"schema":{"properties":{"cic":{"description":"Credential identification code: the nine digits after IDMEX on the first line on the back.","example":"123456789","pattern":"^[0-9]{1,9}$","type":"string"},"id_ciudadano":{"description":"Citizen identifier, models E to J: the last nine digits of the first line on the back. Send this or `ocr`.","example":"987654321","pattern":"^[0-9]{1,9}$","type":"string"},"ocr":{"description":"OCR, model D. Send this or `id_ciudadano`.","example":"1234567890123","pattern":"^[0-9]{1,13}$","type":"string"}},"required":["cic"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"cic":{"type":"string"},"credential":{"anyOf":[{"$ref":"#/components/schemas/IneCredential"},{"type":"null"}]},"found":{"description":"true = INE returned the record in `credential`; false = INE answered without a record (charged); null = INE unreachable (not charged).","type":["boolean","null"]},"message":{"type":"string"},"status":{"description":"INE's verdict. `unknown` means INE returned a record without stating whether it is current.","enum":["vigente","no_vigente","no_encontrada","unknown",null],"type":["string","null"]}},"type":"object"}}},"description":"Lookup completed. `found` is true / false / null."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to `invalid_fields` and `fields` listing every missing or malformed field."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Verify a voter ID with INE"}},"/rfc/commerce-registry":{"post":{"description":"Returns the company's folios (FME) in the Registro Público de Comercio (SIGER), each with its general data, shareholders, and registered acts. Act documents (PDFs) are not included.\n\nThe registry is searched by company name: the optional `name`, or else the name SAT has registered for the RFC (from the same certificate lookup as `/profile`). A record matches when its name equals the searched one once punctuation, accents, and legal-entity suffixes are ignored; records whose own RFC differs from the requested one are dropped. Not every state's registry is supported yet; more are coming soon. A folio in an unsupported state comes back with `supported: false` and only `fme`, `name`, and `registry_office` set. When every match is in an unsupported state, `message` says so and the request is not charged.\n\nCompany (persona moral) RFCs only. 20–60 s, a few seconds less with `name`; companies with a long registry history can take a few minutes, past the 90 s synchronous limit, so use `webhook_url` for them. Webhook supported: with `webhook_url` the request is accepted with 202 and charged then, and refunded before the result is delivered if the lookup found nothing chargeable (e.g. only unsupported states, or the registry unreachable).\n\n**Beta:** pricing may change soon.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/commerce-registry"},"operationId":"rfcCommerceRegistry","requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"description":"Optional. Company name to search instead of the SAT-registered one. Legal-entity suffixes are ignored.","example":"ACME CONSULTORES","type":"string"},"rfc":{"description":"Company (persona moral) RFC, 12 characters","example":"ACM180711AB1","type":"string"},"webhook_url":{"description":"URL to receive the result asynchronously. The API returns 202 immediately and POSTs the JSON result here when complete. Must be http or https. Redirects are not followed. Max 2048 chars.","example":"https://example.com/webhooks/rfc","format":"uri","maxLength":2048,"type":"string"}},"required":["rfc"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"found":{"type":["boolean","null"]},"generic":{"description":"true for SAT's generic RFCs (XAXX010101000, XEXX010101000, EXTF900101NI1, EXT990101NI1), which identify no taxpayer and are answered without querying SAT.","type":"boolean"},"message":{"type":"string"},"name":{"description":"The company name that was searched.","type":["string","null"]},"records":{"items":{"$ref":"#/components/schemas/CommerceRegistryRecord"},"type":"array"},"rfc":{"type":"string"}},"type":"object"}}},"description":"Lookup completed. `found` is true / false / null (SAT or the registry unreachable, retry)."},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAccepted"}}},"description":"Accepted: async processing started. Result will be POSTed to the webhook URL."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to one of: `missing_rfc`, `invalid_rfc`, `company_rfc_required` (a persona física RFC)."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Look up a company in the Registro Público de Comercio (beta)"}},"/rfc/find-zip":{"post":{"description":"Searches SAT's massive consultation endpoint to find the postal code registered for an RFC + name combination. Skips the certificate lookup, so the caller must provide the cleaned name (see Names section in the API description). 7–9 s. Webhook supported.\n\nUse this when an invoicing flow needs the zip code but the customer name is already on file.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/find-zip"},"operationId":"rfcFindZip","requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"description":"Registered taxpayer name as it appears in SAT. **Companies:** omit legal-entity suffixes (S.A. de C.V., SAPI de C.V., SOFOM, AC, SC, etc.). **Persons:** legal name with no honorifics. See top-level `Names` section.","example":"ACME CONSULTORES","type":"string"},"rfc":{"description":"The RFC number to validate (12 or 13 characters)","example":"XAXX010101000","type":"string"},"webhook_url":{"description":"URL to receive the result asynchronously. The API returns 202 immediately and POSTs the JSON result here when complete. Must be http or https. Redirects are not followed. Max 2048 chars.","example":"https://example.com/webhooks/rfc","format":"uri","maxLength":2048,"type":"string"}},"required":["rfc","name"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"generic":{"description":"true for SAT's generic RFCs (XAXX010101000, XEXX010101000, EXTF900101NI1, EXT990101NI1), which identify no taxpayer and are answered without querying SAT.","type":"boolean"},"message":{"type":"string"},"rfc":{"type":"string"},"valid":{"description":"true = zip found; false = combination not in SAT registry; null = SAT unreachable for some batches.","type":["boolean","null"]},"zip":{"type":["string","null"]}},"type":"object"}}},"description":"Search completed (sync mode only). `valid` is true / false / null."},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAccepted"}}},"description":"Accepted: async processing started. Result will be POSTed to the webhook URL."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to one of: `missing_rfc`, `invalid_rfc`, `missing_name`, `invalid_webhook_url`."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Find the SAT-registered zip for a known RFC + name"}},"/rfc/profile":{"post":{"description":"Returns the SAT-registered personal data for an RFC:\n\n- **Persona física (individual):** legal name, CURP, and contact email on file.\n- **Persona moral (company):** company name, legal representative RFC + CURP, and contact email on file.\n\nThe data is parsed from the digital certificates (CSD + FIEL) SAT publishes for the RFC. You also get serial, status, and validity dates for each certificate, plus the base64 .cer blob. Sync only, 1–3 s. Use for KYC, account onboarding, or pre-filling customer records.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/profile"},"operationId":"rfcProfile","requestBody":{"content":{"application/json":{"schema":{"properties":{"rfc":{"description":"The RFC number to validate (12 or 13 characters)","example":"XAXX010101000","type":"string"}},"required":["rfc"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"certs":{"items":{"$ref":"#/components/schemas/Certificate"},"type":"array"},"curp":{"description":"CURP of the taxpayer. Only present for persona física.","type":"string"},"email":{"description":"Contact email SAT has on file for the taxpayer.","type":"string"},"found":{"description":"true = SAT returned a registered taxpayer; false = SAT has no record; null = SAT unreachable.","type":["boolean","null"]},"generic":{"description":"true for SAT's generic RFCs (XAXX010101000, XEXX010101000, EXTF900101NI1, EXT990101NI1), which identify no taxpayer and are answered without querying SAT.","type":"boolean"},"legal_representative_curp":{"description":"CURP of the legal representative. Only present for persona moral.","type":"string"},"legal_representative_rfc":{"description":"RFC of the legal representative. Only present for persona moral.","type":"string"},"message":{"type":"string"},"name":{"type":["string","null"]},"rfc":{"type":"string"},"source":{"description":"sat_registry confirms registration only; it provides no certificate profile or identity details. Omitted for generic RFCs.","enum":["sat_certificates","sat_registry"],"type":"string"}},"type":"object"}}},"description":"Lookup completed. `found` is true / false / null. Missing or unavailable certificates fall back to SAT registry verification: `source` is `sat_registry`, `name` is null and `certs` is empty. An answered fallback costs 1 credit; a full certificate profile costs 3 credits. An unavailable answer costs no credits."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to: `missing_rfc` or `invalid_rfc`."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Look up the registered taxpayer's personal data"}},"/rfc/sat-lists":{"post":{"description":"Returns 69-B / 69 / 69-B bis listings for an RFC. Local DB lookup, no SAT roundtrip. ~ms. Use for compliance dashboards.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/sat-lists"},"operationId":"rfcSatLists","requestBody":{"content":{"application/json":{"schema":{"properties":{"rfc":{"description":"The RFC number to validate (12 or 13 characters)","example":"XAXX010101000","type":"string"}},"required":["rfc"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"rfc":{"type":"string"},"sat_lists":{"items":{"$ref":"#/components/schemas/SatListing"},"type":"array"}},"type":"object"}}},"description":"Lookup completed. `sat_lists` is empty when the RFC is in no list."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to: `missing_rfc` or `invalid_rfc`."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"List SAT-published contributor lists an RFC appears in"}},"/rfc/validate":{"post":{"description":"Runs the full validation pipeline: certificate lookup for the registered name, zip-code search, certificate enrichment, and SAT-list lookup. The response includes registration status, taxpayer name, postal code, digital certificates, and SAT-list presence. RENAPO identity lookup is disabled by default. Set `include_curp: true` to enable it for 5 additional credits (15 total, $0.225 USD pay-as-you-go).\n\n**Identity enrichment:**\n- **Company / persona moral:** includes `legal_representative` with the representative's verified name, surnames, birthdate, CURP status, and other identity details.\n- **Individual / persona física:** includes `person` only when a CURP is available in the source data; not every individual response includes it.\n- Identity details are verified through RENAPO. If that government lookup is unavailable, RFC validation still completes without the corresponding identity object.\n\nWebhook delivery is supported.\n\n**Latency:**\n- Without `name`: 7–11 s (cert lookup + zip search run sequentially).\n- **With `name`** (recommended when you know it): 6–10 s. Cert lookup and zip search run in parallel, and you also recover a zip for registered RFCs that have zero CSDs.\n- When enabled, identity lookup runs alongside zip discovery and is capped at 45 s.\n\nWhen the provided `name` doesn't match SAT records, the response is `valid: false` with a message explaining the registered name. Use the more targeted endpoints (`/profile`, `/find-zip`, `/verify`) when you already have part of the answer.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/validate"},"operationId":"validateRfc","requestBody":{"content":{"application/json":{"schema":{"properties":{"include_curp":{"default":false,"description":"Enable RENAPO identity lookup for the taxpayer or legal representative when a CURP is available. Adds 5 credits to the request (15 total, $0.225 USD pay-as-you-go).","type":"boolean"},"name":{"description":"Optional. When provided, cert lookup and zip search run in parallel (6–10 s instead of 7–11 s) and a zip is recovered even when the RFC has zero CSDs. Registered taxpayer name as it appears in SAT. **Companies:** omit legal-entity suffixes (S.A. de C.V., SAPI de C.V., SOFOM, AC, SC, etc.). **Persons:** legal name with no honorifics. See top-level `Names` section.","example":"ACME CONSULTORES","type":"string"},"rfc":{"description":"The RFC number to validate (12 or 13 characters)","example":"XAXX010101000","type":"string"},"webhook_url":{"description":"URL to receive the result asynchronously. The API returns 202 immediately and POSTs the JSON result here when complete. Must be http or https. Redirects are not followed. Max 2048 chars.","example":"https://example.com/webhooks/rfc","format":"uri","maxLength":2048,"type":"string"}},"required":["rfc"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"certs":{"items":{"$ref":"#/components/schemas/Certificate"},"type":"array"},"curp":{"description":"CURP of the taxpayer. Only present for persona física.","type":"string"},"email":{"description":"Contact email SAT has on file for the taxpayer.","type":"string"},"generic":{"description":"true for SAT's generic RFCs (XAXX010101000, XEXX010101000, EXTF900101NI1, EXT990101NI1), which identify no taxpayer and are answered without querying SAT.","type":"boolean"},"legal_representative":{"$ref":"#/components/schemas/LegalRepresentative","description":"Verified identity for a persona moral's legal representative, including name, surnames, birthdate, and CURP status. Present only with `include_curp: true`, an available CURP, and a successful RENAPO lookup."},"legal_representative_curp":{"description":"CURP of the legal representative. Only present for persona moral.","type":"string"},"legal_representative_rfc":{"description":"RFC of the legal representative. Only present for persona moral.","type":"string"},"message":{"type":"string"},"name":{"type":["string","null"]},"person":{"$ref":"#/components/schemas/CurpIdentity","description":"Verified identity for a persona física taxpayer. Present only with `include_curp: true`, an available CURP, and a successful RENAPO lookup."},"rfc":{"type":"string"},"sat_lists":{"items":{"$ref":"#/components/schemas/SatListing"},"type":"array"},"valid":{"description":"true = registered, false = not registered, null = SAT unreachable (retry later)","type":["boolean","null"]},"zip":{"type":["string","null"]}},"type":"object"}}},"description":"Successful validation. `valid` is true / false / null (null = SAT unreachable)."},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAccepted"}}},"description":"Accepted: async processing started. Result will be POSTed to the webhook URL."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized: invalid or missing API key"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required: insufficient balance or no active subscription"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to one of: `missing_rfc`, `invalid_rfc`, `invalid_webhook_url`."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests: rate limit exceeded"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Full RFC validation (cert lookup + zip search + lists)"}},"/rfc/verify":{"post":{"description":"Two modes:\n\n- **RFC only** (`{rfc}`): quick padrón check via SAT's ValidaRFC endpoint. 1–2 s. Confirms whether the RFC is registered and active with SAT.\n- **Full combo** (`{rfc, name, zip}`): single-round-trip combo check via the massive-consultation endpoint. 1–2 s. Confirms that the RFC + name + zip combination matches SAT's records.\n\nProvide `name` and `zip` together (combo mode), or neither (RFC-only mode). Providing only one is rejected with 422.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/verify"},"operationId":"rfcVerify","requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"description":"Optional. Requires `zip`. Registered taxpayer name as it appears in SAT. **Companies:** omit legal-entity suffixes (S.A. de C.V., SAPI de C.V., SOFOM, AC, SC, etc.). **Persons:** legal name with no honorifics. See top-level `Names` section.","example":"ACME CONSULTORES","type":"string"},"rfc":{"description":"The RFC number to validate (12 or 13 characters)","example":"XAXX010101000","type":"string"},"zip":{"description":"Optional. Requires `name`. 5-digit Mexican postal code","example":"06600","pattern":"^\\d{5}$","type":"string"}},"required":["rfc"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"generic":{"description":"true for SAT's generic RFCs (XAXX010101000, XEXX010101000, EXTF900101NI1, EXT990101NI1), which identify no taxpayer and are answered without querying SAT.","type":"boolean"},"message":{"type":"string"},"rfc":{"type":"string"},"valid":{"description":"true = SAT confirms; false = SAT rejects; null = SAT unreachable.","type":["boolean","null"]}},"type":"object"}}},"description":"Verification completed."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to one of: `missing_rfc`, `invalid_rfc`, `missing_name` (zip provided without name), `missing_zip` (name provided without zip), `invalid_zip`."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Gateway Timeout: the lookup did not finish within 90 seconds. Body is `{\"error\": \"request_timeout\"}`. Not charged."}},"security":[{"apiKey":[]}],"summary":"Verify an RFC, optionally against a name + zip"}},"/rfc/verify-batch":{"post":{"description":"Submits up to 5000 records to SAT in a single round-trip and returns per-record verdicts. 10–15 s for the whole batch, so the per-record cost is tiny when amortized. **Webhook required**: there is no sync mode for this endpoint.","externalDocs":{"description":"Endpoint guide","url":"https://rfccheck.com/docs/endpoints/verify-batch"},"operationId":"rfcVerifyBatch","requestBody":{"content":{"application/json":{"schema":{"properties":{"records":{"items":{"properties":{"name":{"description":"Registered taxpayer name as it appears in SAT. **Companies:** omit legal-entity suffixes (S.A. de C.V., SAPI de C.V., SOFOM, AC, SC, etc.). **Persons:** legal name with no honorifics. See top-level `Names` section.","example":"ACME CONSULTORES","type":"string"},"rfc":{"description":"The RFC number to validate (12 or 13 characters)","example":"XAXX010101000","type":"string"},"zip":{"description":"5-digit Mexican postal code","example":"06600","pattern":"^\\d{5}$","type":"string"}},"required":["rfc","name","zip"],"type":"object"},"maxItems":5000,"type":"array"},"webhook_url":{"description":"URL to receive the result asynchronously. The API returns 202 immediately and POSTs the JSON result here when complete. Must be http or https. Redirects are not followed. Max 2048 chars.","example":"https://example.com/webhooks/rfc","format":"uri","maxLength":2048,"type":"string"}},"required":["records","webhook_url"],"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookAccepted"}}},"description":"Accepted: async processing started. Result will be POSTed to the webhook URL."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payment Required"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Body has `error` set to one of: `missing_records`, `missing_webhook_url`, `invalid_webhook_url`, `empty_batch`, `batch_too_large`, `invalid_record` (with `index` and `reason`)."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"security":[{"apiKey":[]}],"summary":"Bulk-verify up to 5000 RFC + name + zip records"}}},"servers":[{"description":"Production server","url":"https://inecheck.com/v1"}]}