v2

CFDIs

>>>

GET /cfdis?page=&per=
List of CFDIs

Params

Param name Description
page
optional

Page index

Validations:

  • Must be a Integer
per
optional

Items per page

Validations:

  • Must be a Integer

Examples

{
  'data': [
    {
      'id': 'cfdi-uuid',
      'type_of': {
        'name': 'Retención de prueba',
        'value': 'retention'
      },
      'billing_service_id': 'billing-service-id',
      'status': {
        'name': 'Timbrando',
        'value': 'stamping'
      },
      'resource': {
        'id': 'resource-uuid',
        'resource_type': 'MonthlyRealInterest',
        'year': 2025,
        'end_date': null,
        'status': 'completed'
      },
      'total': '245.35',
      'date': '2026-03-31 - 13:20:56',
      'date_stamping': '2026-03-31 - 19:20:58',
      'emitter': {
        'id': 'emitter-uuid',
        'name': 'Test Emitter',
        'tax_id_number': 'TST123456789',
        'zip_code': '12345'
      },
      'emitter_tax_id_number': 'TST123456789',
      'receiver': {
        'id': 'receiver-uuid',
        'full_name': 'Test Receiver',
        'business_name': 'Test Receiver Business',
        'email': 'receiver@test.com',
        'tax_id_number': 'RCV123456789',
        'contacts': []
      },
      'receiver_tax_id_number': 'RCV123456789',
      'cfdi_type': null,
      'start_period': '2025-12-01',
      'final_period': '2025-12-31',
      'expedition_place': null,
      'currency': 'mxn',
      'serie': null,
      'folio': '214133',
      'payment_form': null,
      'payment_method': null,
      'tax_stamp': {
        'UUID': 'uuid-prueba',
        'Version': '1.1',
        'SelloCFD': 'sello-cfd',
        'SelloSAT': 'sello-sat',
        'FechaTimbrado': '2026-03-31T19:20:58',
        'RfcProvCertif': 'TST123456789',
        'NoCertificadoSAT': '00001000000719545303'
      },
      'original_chain': 'cadena-original-prueba',
      'stamp': 'sello-prueba',
      'pdf_url': 'http://example-url-to-file/test.pdf',
      'xml_url': 'http://example-url-to-file/test.xml'
    }
  ],
  'meta': {
    'count': 1
  }
}

Errors

Code Description
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error
>>>

GET /cfdis/:id
Specific CFDI

Params

Param name Description
id
required

Requested CFDI ID

Validations:

  • Must be a String

Examples

{
  'data': {
    'id': 'cfdi-uuid',
    'type_of': {
      'name': 'Retención de prueba',
      'value': 'retention'
    },
    'billing_service_id': 'billing-service-id',
    'status': {
      'name': 'Timbrando',
      'value': 'stamping'
    },
    'resource': {
      'id': 'resource-uuid',
      'resource_type': 'MonthlyRealInterest',
      'year': 2025,
      'end_date': null,
      'status': 'completed'
    },
    'total': '245.35',
    'date': '2026-03-31 - 13:20:56',
    'date_stamping': '2026-03-31 - 19:20:58',
    'emitter': {
      'id': 'emitter-uuid',
      'name': 'Test Emitter',
      'tax_id_number': 'TST123456789',
      'zip_code': '12345'
    },
    'emitter_tax_id_number': 'TST123456789',
    'receiver': {
      'id': 'receiver-uuid',
      'full_name': 'Test Receiver',
      'business_name': 'Test Receiver Business',
      'email': 'receiver@test.com',
      'tax_id_number': 'RCV123456789',
      'contacts': []
    },
    'receiver_tax_id_number': 'RCV123456789',
    'cfdi_type': null,
    'start_period': '2025-12-01',
    'final_period': '2025-12-31',
    'expedition_place': null,
    'currency': 'mxn',
    'serie': null,
    'folio': '214133',
    'payment_form': null,
    'payment_method': null,
    'tax_stamp': {
      'UUID': 'uuid-prueba',
      'Version': '1.1',
      'SelloCFD': 'sello-cfd',
      'SelloSAT': 'sello-sat',
      'FechaTimbrado': '2026-03-31T19:20:58',
      'RfcProvCertif': 'TST123456789',
      'NoCertificadoSAT': '00001000000719545303'
    },
    'original_chain': 'cadena-original-prueba',
    'stamp': 'sello-prueba',
    'pdf_url': 'http://example-url-to-file/test.pdf',
    'xml_url': 'http://example-url-to-file/test.xml'
  }
}

Errors

Code Description
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
500 Internal Server Error