Fiscal

CSF Data Extraction & Validation (Multi-input)

Credits: 1 per call.

Extracts structured data from a Constancia de Situación Fiscal (CSF) — the official PDF document issued by SAT that proves a taxpayer’s fiscal situation. You can submit the CSF as a base64-encoded file (PDF/PNG/JPG) and get back the full content as JSON, or alternatively pass RFC + CIF (the tax-certificate code) to retrieve the same data directly from SAT’s public QR validator.

Returns the legal name, address, fiscal regime, economic activities, registration date, and tax obligations. Use this endpoint to automate vendor onboarding and to keep your records of partners’ fiscal data continuously up to date.

cURL

curl -X POST https://api.origoid.com/mex/fiscal/v1/csf-extractions \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"rfc": "PELJ900101AAA", "cif": "12345678901"}'

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "Company information retrieved successfully",
  "data": {
    "rfc": "ACM240101A23",
    "idCif": "24010199999",
    "taxpayerType": "PERSONA_MORAL",
    "status": "ACTIVO",
    "registrationDate": "2024-01-01",
    "lastStatusChangeDate": "2024-01-01",
    "personalInfo": {
      "givenNames": null,
      "firstSurname": null,
      "secondSurname": null,
      "legalName": "ACME DEMO",
      "legalType": "SOCIEDAD ANONIMA DE CAPITAL VARIABLE",
      "commercialName": null,
      "curp": null,
      "dateOfBirth": null,
      "constitutionDate": "2024-01-01"
    },
    "addressNormalized": {
      "street": "AVENIDA EJEMPLO",
      "exteriorNumber": "61",
      "interiorNumber": "INTERIOR 901",
      "neighborhood": "COLONIA EJEMPLO",
      "zipCode": "11560",
      "municipality": "MIGUEL HIDALGO",
      "state": "CIUDAD DE MEXICO",
      "country": "MEXICO",
      "betweenStreets": "CALLE PRIMERA Y CALLE SEGUNDA",
      "email": "juan.perez@example.com"
    },
    "taxRegimes": [
      {
        "description": "Régimen General de Ley Personas Morales",
        "startDate": "2024-01-01"
      }
    ],
    "economicActivities": [
      {
        "description": "Servicios de consultoria en computación",
        "percentage": 100,
        "startDate": "2024-01-01"
      }
    ],
    "taxObligations": [
      {
        "description": "Declaración de proveedores de IVA",
        "dueDate": "A más tardar el último día del mes inmediato posterior al periodo que corresponda",
        "startDate": "2024-01-01"
      },
      {
        "description": "Pago provisional mensual de ISR personas morales régimen general",
        "dueDate": "A más tardar el día 17 del mes inmediato posterior al periodo que corresponda",
        "startDate": "2022-01-01"
      }
    ]
  },
  "transactionId": "e9df0229-e1ed-4c09-bd57-0ec81ead9744",
  "processedAt": "2026-03-19T21:05:00-06:00",
  "billable": true
}

Autorizaciones

x-api-key

string

header

requerido

Cuerpo

application/json

Option 1
Option 2

document

string

requerido

Base64 file (PDF/PNG/JPG). Required if RFC/CIF are not provided.

rfc

string

Taxpayer RFC (12 or 13 characters).

cif

string

Official Tax Certificate Code (11 digits).

Respuesta

All responses are returned with HTTP 200. The JSON payload defines the success or failure of the transaction.

status

enum<string>

requerido

High-level outcome. OK means the request was successfully processed (regardless of business result). ERROR means the request was rejected or could not be processed.

Opciones disponibles:

OK,

ERROR

type

string

requerido

Stable result type code. Includes generic codes (SUCCESS, INVALID_REQUEST, UNAUTHORIZED, SERVICE_UNAVAILABLE, INTERNAL_ERROR, RATE_LIMIT_EXCEEDED) plus endpoint-specific result codes — see this endpoint's response examples.

message

string

requerido

Human-readable summary of the result. Always in English (per Language Conventions in the API overview).

transactionId

string<uuid>

requerido

Unique identifier of this request, generated by the API Gateway. Propagated end-to-end for traceability.

processedAt

string<date-time>

requerido

ISO 8601 datetime with Mexico City offset (-06:00). Always set by the API Gateway when the response leaves the system.

billable

boolean

requerido

Whether this request will be charged against the client's plan. Typically true for successful business results and false for validation errors or system errors that prevented processing.

data

object

Response payload. null on error responses. Shape depends on the endpoint — see each operation's response schema.

errors

object[]

Per-field error details. Present only on INVALID_REQUEST responses.

Show child attributes

Validate CFDI (Electronic Invoice)**Credits:** 1 per call. Validates a CFDI (Comprobante Fiscal Digital por Internet) — Mexico's mandatory electronic invoice — by checking its current status with SAT. Returns whether the CFDI is currently valid (`VALID`) or cancelled (`CANCELED`), the cancellation status (e.g. requires receiver acceptance), and the fiscal effect (`INCOME`, `EXPENSE`, `TRANSPORT`, `PAYROLL`, `PAYMENT`). Use this endpoint when reconciling supplier invoices, processing expense reports, or ensuring that the invoices you receive are real and not later cancelled by the issuer without your knowledge.

cURL

curl -X POST https://api.origoid.com/mex/fiscal/v1/csf-extractions \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"rfc": "PELJ900101AAA", "cif": "12345678901"}'

{
  "status": "OK",
  "type": "SUCCESS",
  "message": "Company information retrieved successfully",
  "data": {
    "rfc": "ACM240101A23",
    "idCif": "24010199999",
    "taxpayerType": "PERSONA_MORAL",
    "status": "ACTIVO",
    "registrationDate": "2024-01-01",
    "lastStatusChangeDate": "2024-01-01",
    "personalInfo": {
      "givenNames": null,
      "firstSurname": null,
      "secondSurname": null,
      "legalName": "ACME DEMO",
      "legalType": "SOCIEDAD ANONIMA DE CAPITAL VARIABLE",
      "commercialName": null,
      "curp": null,
      "dateOfBirth": null,
      "constitutionDate": "2024-01-01"
    },
    "addressNormalized": {
      "street": "AVENIDA EJEMPLO",
      "exteriorNumber": "61",
      "interiorNumber": "INTERIOR 901",
      "neighborhood": "COLONIA EJEMPLO",
      "zipCode": "11560",
      "municipality": "MIGUEL HIDALGO",
      "state": "CIUDAD DE MEXICO",
      "country": "MEXICO",
      "betweenStreets": "CALLE PRIMERA Y CALLE SEGUNDA",
      "email": "juan.perez@example.com"
    },
    "taxRegimes": [
      {
        "description": "Régimen General de Ley Personas Morales",
        "startDate": "2024-01-01"
      }
    ],
    "economicActivities": [
      {
        "description": "Servicios de consultoria en computación",
        "percentage": 100,
        "startDate": "2024-01-01"
      }
    ],
    "taxObligations": [
      {
        "description": "Declaración de proveedores de IVA",
        "dueDate": "A más tardar el último día del mes inmediato posterior al periodo que corresponda",
        "startDate": "2024-01-01"
      },
      {
        "description": "Pago provisional mensual de ISR personas morales régimen general",
        "dueDate": "A más tardar el día 17 del mes inmediato posterior al periodo que corresponda",
        "startDate": "2022-01-01"
      }
    ]
  },
  "transactionId": "e9df0229-e1ed-4c09-bd57-0ec81ead9744",
  "processedAt": "2026-03-19T21:05:00-06:00",
  "billable": true
}