Intro

With this API, you can retrieve the certificates of a PF's (Persona Física) RFC (Registro Federal de Contribuyentes).

Important points

To make the request it is only necessary to provide the RFC for a PF.

field	type	required	length	Description
rfc	Alphanumeric	Yes	13	Provide a valid RFC. It can be an RFC of a PF with a length of 13 characters.

If you want to validate the RFC (Registro Federal de Contribuyentes) of the PF (Persona Física) or PM (Persona Moral), you can use this service to ensure that the RFC provided is correct.

If you are not sure how to obtain this field and you have your client's personal data, we suggest you visit our RFC generate RFC service to generate the RFC.

Successful response

Inside the response object you will only get the next response.

{
  "id": "65281b3e00e2e3f2aecec92a",
  "createdAt": "2023-10-12T10:13:50.218355-06:00",
  "finishedAt": "2023-10-12T10:13:56.830514-06:00",
  "duration": 6612,
  "status": "SUCCESS",
  "request": {
    "rfc": "KIBA900810BPA"
  },
  "response": {
    "certificates": [
      {
        "certificate": {
          "extKeyUsage": [
            "emailProtection",
            "clientAuth"
          ],
          "isCA": false,
          "issuer": {
            "commonName": "AUTORIDAD CERTIFICADORA",
            "country": [
              "MX"
            ],
            "locality": [
              "CUAUHTEMOC"
            ],
            "names": [
              {
                "type": "commonName",
                "value": "AUTORIDAD CERTIFICADORA"
              },
              {
                "type": "organization",
                "value": "SERVICIO DE ADMINISTRACION TRIBUTARIA"
              },
              {
                "type": "organizationalUnit",
                "value": "SAT-IES Authority"
              },
              {
                "type": "emailAddress",
                "value": "contacto.tecnico@sat.gob.mx"
              },
              {
                "type": "streetAddress",
                "value": "AV. HIDALGO 77, COL. GUERRERO"
              },
              {
                "type": "postalCode",
                "value": "06300"
              },
              {
                "type": "country",
                "value": "MX"
              },
              {
                "type": "province",
                "value": "CIUDAD DE MEXICO"
              },
              {
                "type": "locality",
                "value": "CUAUHTEMOC"
              },
              {
                "type": "x500UniqueIdentifier",
                "value": "SAT970701NN3"
              },
              {
                "type": "1.2.840.113549.1.9.2",
                "value": "responsable: ADMINISTRACION CENTRAL DE SERVICIOS TRIBUTARIOS AL CONTRIBUYENTE"
              }
            ],
            "organization": [
              "SERVICIO DE ADMINISTRACION TRIBUTARIA"
            ],
            "organizationalUnit": [
              "SAT-IES Authority"
            ],
            "postalCode": [
              "06300"
            ],
            "province": [
              "CIUDAD DE MEXICO"
            ],
            "streetAddress": [
              "AV. HIDALGO 77, COL. GUERRERO"
            ]
          },
          "keyUsage": [
            "digitalSignature",
            "contentCommitment",
            "dataEncipherment",
            "keyAgreement"
          ],
          "maxPathLen": -1,
          "notAfter": "2026-03-02T05:04:48Z",
          "notBefore": "2022-03-02T05:04:08Z",
          "publicKey": {
            "details": "Exponent: 65537",
            "size": 2048,
            "type": "RSA"
          },
          "publicKeyAlgorithm": "RSA",
          "serialNumber": "27510619052233445583187066766829451383776818050101",
          "serialNumberHex": "3030303031303030303030353131373036313435",
          "sha1Fingerprint": "31FB44EBF727F56BA123AC43C7F167F22A5FC0B1",
          "sha256Fingerprint": "0FABD78247EB09F9056D945410F812AEF2E0B75AB62C5FBDA65432116D3D21DC",
          "signatureAlgorithm": "SHA256-RSA",
          "subject": {
            "commonName": "JUAN DE LA MORA RAMIREZ",
            "country": [
              "MX"
            ],
            "names": [
              {
                "type": "commonName",
                "value": "JUAN DE LA MORA RAMIREZ"
              },
              {
                "type": "2.5.4.41",
                "value": "JUAN DE LA MORA RAMIREZ"
              },
              {
                "type": "organization",
                "value": "JUAN DE LA MORA RAMIREZ"
              },
              {
                "type": "country",
                "value": "MX"
              },
              {
                "type": "emailAddress",
                "value": "jdlrmhhe@gmail.com"
              },
              {
                "type": "x500UniqueIdentifier",
                "value": "ADJ18904212P1"
              },
              {
                "type": "serialNumber",
                "value": "ADJ18904212P1HJCRRR02"
              }
            ],
            "organization": [
              "JUAN DE LA MORA RAMIREZ"
            ],
            "serialNumber": "ADJ18904212P1PPP12"
          },
          "version": 3
        },
        "endDate": "2026-03-02T05:04:48Z",
        "serialNumber": "00001000000511706145",
        "startDate": "2022-03-02T05:04:08Z",
        "status": "Activo",
        "type": "FIEL"
      },
      {
        "certificate": {
          "extKeyUsage": [
            "emailProtection",
            "clientAuth"
          ],
          "isCA": false,
          "issuer": {
            "commonName": "A.C. del Servicio de Administración Tributaria",
            "country": [
              "MX"
            ],
            "locality": [
              "Cuauhtémoc"
            ],
            "names": [
              {
                "type": "commonName",
                "value": "A.C. del Servicio de Administración Tributaria"
              },
              {
                "type": "organization",
                "value": "Servicio de Administración Tributaria"
              },
              {
                "type": "organizationalUnit",
                "value": "Administración de Seguridad de la Información"
              },
              {
                "type": "emailAddress",
                "value": "acods@sat.gob.mx"
              },
              {
                "type": "streetAddress",
                "value": "Av. Hidalgo 77, Col. Guerrero"
              },
              {
                "type": "postalCode",
                "value": "06300"
              },
              {
                "type": "country",
                "value": "MX"
              },
              {
                "type": "province",
                "value": "Distrito Federal"
              },
              {
                "type": "locality",
                "value": "Cuauhtémoc"
              },
              {
                "type": "x500UniqueIdentifier",
                "value": "SAT970701NN3"
              },
              {
                "type": "1.2.840.113549.1.9.2",
                "value": "Responsable: Administración Central de Servicios Tributarios al Contribuyente"
              }
            ],
            "organization": [
              "Servicio de Administración Tributaria"
            ],
            "organizationalUnit": [
              "Administración de Seguridad de la Información"
            ],
            "postalCode": [
              "06300"
            ],
            "province": [
              "Distrito Federal"
            ],
            "streetAddress": [
              "Av. Hidalgo 77, Col. Guerrero"
            ]
          },
          "keyUsage": [
            "digitalSignature",
            "contentCommitment",
            "dataEncipherment",
            "keyAgreement"
          ],
          "maxPathLen": -1,
          "notAfter": "2022-03-06T15:20:11Z",
          "notBefore": "2018-03-06T15:19:31Z",
          "publicKey": {
            "details": "Exponent: 65537",
            "size": 2048,
            "type": "RSA"
          },
          "publicKeyAlgorithm": "RSA",
          "serialNumber": "275106190557734483187066766810934835012724603189",
          "serialNumberHex": "3030303031303030303030343039383138343935",
          "sha1Fingerprint": "311248AF1FBFE17952853B044422A073FE1A9F18",
          "sha256Fingerprint": "DF94C324BD08A362A863D95AC51091BAF0BA7DA78C7D1D58983FB044DE101329",
          "signatureAlgorithm": "SHA256-RSA",
          "subject": {
            "commonName": "JUAN DE LA MORA RAMIREZ",
            "country": [
              "MX"
            ],
            "names": [
              {
                "type": "commonName",
                "value": "JUAN DE LA MORA RAMIREZ"
              },
              {
                "type": "2.5.4.41",
                "value": "JUAN DE LA MORA RAMIREZ"
              },
              {
                "type": "organization",
                "value": "JUAN DE LA MORA RAMIREZ"
              },
              {
                "type": "country",
                "value": "MX"
              },
              {
                "type": "emailAddress",
                "value": "jdlrmhhe@gmail.com"
              },
              {
                "type": "x500UniqueIdentifier",
                "value": "ADJ18904212P1"
              },
              {
                "type": "serialNumber",
                "value": "ADJ18904212P1PPP12"
              }
            ],
            "organization": [
              "JUAN DE LA MORA RAMIREZ"
            ],
            "serialNumber": "ADJ18904212P1PPP12"
          },
          "version": 3
        },
        "endDate": "2022-03-02T05:04:07Z",
        "serialNumber": "00001000000409818495",
        "startDate": "2018-03-06T15:19:31Z",
        "status": "Revocado",
        "type": "FIEL"
      }
    ],
    "estatus": "FOUND"
  }
}

Not found

📘
Status NOT FOUND
If the response indicates a NOT_FOUND status, it means that the data could not be recovered, even though the response has an HTTP code 200. This occurs because we accessed the SAT system to validate the RFC provided .
For more details we suggest you see the Possible Not Found Responses section.

You will receive this response with an HTTP code 200 when we were able to successfully query the RFC provided to the SAT. However, no data was found registered under that RFC with the SAT.

{
    "id": "65281b5300e2e3f2aecec92b",
    "createdAt": "2023-10-12T10:14:11.626772-06:00",
    "finishedAt": "2023-10-12T10:14:16.158018-06:00",
    "duration": 4531,
    "status": "SUCCESS",
    "request": {
        "rfc": "KIBA801010CLO"
    },
    "response": {
        "estatus": "NOT_FOUND",
        "mensaje": "No encontramos datos registrados ante el SAT"
    }
}

Test the service (test cases)

We have included a query parameter in Sandbox to enable you to query the test cases that we created for running tests. To get a response, fill the testCaseId parameter with any of the following cases:

Num	Id	Name	Description
1	696e463ba46252bd46f4e5d8	No encontrado	Indicates that no information was found for the data provided
2	696e4634a165f988b20f728f	Respuesta exitosa	Indicates one successful response

📘
Test your own test case
In case you want to test your own test case created in link, you can send in the testCaseId parameter the identifier of the test case you want to use.
For more information visit our knowledge center to know more about test cases

Listing the possible NOT FOUND responses

Required fields

You will get a 400 bad request error when the RFC is not provided in the request body.

[
    {
        "code": "EMPTY_ERROR",
        "message": "can't be empty",
        "field": "rfc"
    }
]

Invalid format

You will get a 400 bad request error when the RFC does not conform the specific format.

[
    {
        "code": "FORMAT_ERROR",
        "message": "should be in rfc format",
        "field": "rfc"
    }
]

Test case not found

If a test case parameter is not sent or a value other than those mentioned above is sent, the service will return the following error 400 bad request

[
    {
        "code": "EMPTY_ERROR",
        "message": "test case not found",
        "field": "testCase"
    },
    {
        "code": "EMPTY_ERROR",
        "message": "test case not found with given id",
        "field": "testCaseId"
    }
]

Length error

RFC length provided is not correct, the service will return the following error 400 bad request

[
    {
        "code": "LENGTH_ERROR",
        "message": "should be == 13",
        "field": "rfc"
    }
]

Unauthorized

It means that the provided API is incorrect and that you are not authorized to access it. You will not receive a body, only a 401 HTTP code.