Skip to main content
GET
/
datasources
/
mx
/
sat
/
certificados
/
{id}
Retrieve a SAT certificate
curl --request GET \
  --url https://api.syntage.com/datasources/mx/sat/certificados/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "0197a365-6c09-7019-b072-6c756008cd2d",
  "link": "/entities/91ab5678-1234-5678-9abc-def012345678",
  "serialNumber": "00001000000516152485",
  "type": "efirma",
  "issuer": {
    "id-at-commonName": "AUTORIDAD CERTIFICADORA",
    "id-at-postalCode": "06300",
    "id-at-countryName": "MX",
    "id-at-localityName": "CUAUHTEMOC",
    "id-at-streetAddress": "AV. HIDALGO 77, COL. GUERRERO",
    "id-at-organizationName": "SERVICIO DE ADMINISTRACION TRIBUTARIA",
    "id-at-uniqueIdentifier": "SAT970701NN3",
    "pkcs-9-at-emailAddress": "contacto.tecnico@sat.gob.mx",
    "id-at-stateOrProvinceName": "CIUDAD DE MEXICO",
    "pkcs-9-at-unstructuredName": "responsable: ADMINISTRACION CENTRAL DE SERVICIOS TRIBUTARIOS AL CONTRIBUYENTE",
    "id-at-organizationalUnitName": "SAT-IES Authority"
  },
  "subject": {
    "id-at-name": "JUAN MANUEL PEREZ GONZALEZ",
    "id-at-commonName": "JUAN MANUEL PEREZ GONZALEZ",
    "id-at-countryName": "MX",
    "id-at-serialNumber": "PEIC211118IS0",
    "id-at-organizationName": "JUAN MANUEL PEREZ GONZALEZ",
    "id-at-uniqueIdentifier": "PEGJ850101AA1",
    "pkcs-9-at-emailAddress": "juan.perez@example.com"
  },
  "validFrom": "2022-11-11 19:02:09",
  "validTo": "2026-11-11 19:02:49",
  "file": {
    "type": "sat.certificate.efirma",
    "resource": "/datasources/mx/sat/certificados/0197a365-6c09-7019-b072-6c756008cd2d",
    "mimeType": "application/x-x509-ca-cert",
    "extension": "cer",
    "filename": "91ab5678-1234-5678-9abc-def012345678-00001000000516152485.cer"
  },
  "status": "valid",
  "revokedAt": "2023-01-01T12:00:00Z",
  "createdAt": "2020-01-01T12:15:00.000Z",
  "updatedAt": "2020-01-01T12:15:00.000Z",
  "@context": "<unknown>",
  "@id": "/datasources/mx/sat/certificados/0197a365-6c09-7019-b072-6c756008cd2d",
  "@type": "SatCertificate"
}

Authorizations

​
X-API-Key
string
header
required

Your API key is available in the Production and Sandbox dashboards.

Path Parameters

​
id
string<uuid>
required

Response

SAT Certificate

​
id
string<uuid>
required

SAT certificate ID

Example:

"0197a365-6c09-7019-b072-6c756008cd2d"

​
link
string<iri-reference>
required

Entity IRI reference

Example:

"/entities/91ab5678-1234-5678-9abc-def012345678"

​
serialNumber
string
required

Certificate serial number

Example:

"00001000000516152485"

​
type
enum<string>
required

Certificate type

Available options:
efirma,
csd
Example:

"efirma"

​
issuer
object
required

Certificate issuer information

​
subject
object
required

Certificate subject information

​
validFrom
string<date-time>
required

Certificate validity start date

Example:

"2022-11-11 19:02:09"

​
validTo
string<date-time>
required

Certificate validity end date

Example:

"2026-11-11 19:02:49"

​
file
object
required

Certificate file. Use the file download endpoint to retrieve the actual file content.

Example:
{
  "type": "sat.certificate.efirma",
  "resource": "/datasources/mx/sat/certificados/0197a365-6c09-7019-b072-6c756008cd2d",
  "mimeType": "application/x-x509-ca-cert",
  "extension": "cer",
  "filename": "91ab5678-1234-5678-9abc-def012345678-00001000000516152485.cer"
}
​
status
enum<string> | null
required

Certificate status

Available options:
valid,
revoked,
expired
Example:

"valid"

​
revokedAt
string<date-time> | null
required

Date and time when the certificate was revoked, if applicable

Example:

"2023-01-01T12:00:00Z"

​
createdAt
string
required

Date and time the resource was created

Example:

"2020-01-01T12:15:00.000Z"

​
updatedAt
string
required

Date and time the resource was last updated

Example:

"2020-01-01T12:15:00.000Z"

​
@context
any
​
@id
string<iri-reference>

SAT Certificate IRI reference

Example:

"/datasources/mx/sat/certificados/0197a365-6c09-7019-b072-6c756008cd2d"

​
@type
string
default:SatCertificate