List invoices
LiveServed by the v1 API in development with the same checks as production; production opens on the same contract. The capabilities from before v1 keep running in production at the path your account team gives you.
Most recent first.
Needs the invoices:read scope.
oauth2 invoices:readAuthorizationBearer <token>OAuth 2.0 client credentials. Exchange your client_id and client_secret at /oauth/token of the environment for a bearer token valid for one hour. The playground of every operation asks for your own client and keeps it in your browser tab only.
Scope: invoices:read
external_id?stringFilter by your id.
worker_id?stringFilter by worker.
^wrk_[0-7][0-9a-hjkmnp-tv-z]{25}$merchant_id?stringFilter by merchant.
^mer_[0-7][0-9a-hjkmnp-tv-z]{25}$customer_id?stringFilter by customer.
^cus_[0-7][0-9a-hjkmnp-tv-z]{25}$status?stringstamped, cancellation_requested or cancelled.
issued_from?stringCreated on or after this date (YYYY-MM-DD).
issued_to?stringCreated on or before this date (YYYY-MM-DD).
cursor?stringFrom next_cursor of the previous page.
limit?integer1 to 500.
100OK
application/json- response
data*array<>next_cursor*|nullcurl -X GET 'https://api.dev.b2b.heru.app/v1/invoices?worker_id=wrk_01m4ra8w0he5esnnsew0v9ffkv&merchant_id=mer_01m4ra8wsyfh3s0tr4nrq3y96j&issued_from=2026-10-01&issued_to=2026-10-31'{ "data": [ { "id": "inv_01m4xp0366e8arrz9ay017zave", "external_id": "INV-2026-000215", "status": "stamped", "type": "I", "uuid": "D4E86AC6-F771-31CC-1639-018F598DE960", "verification_url": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=D4E86AC6-F771-31CC-1639-018F598DE960&re=HSA2001159T6&rr=PDE180514R21&tt=1250.00&fe=FuYBPA==", "stamp": { "sat_certificate_number": "00001000000509465028", "issuer_certificate_number": "00001000000700000001", "pac_rfc": "SPR190613I52", "issuer_seal": "xbHqJY7NGMh0sLc04E/BTfD0PsUzGZxqZScTRIQ1DhRFanI6Drqe0C8/640elUX9jeaQLN5GmyiVIc/50BlMmVb1L3YthVjXm/JRofSdzmJZ6v7ScJRaMVzfrnjD0xPB6qOVD1s1Fel7voooXc93i8ARN1260nDGioLCDRPFJa9A4l+QXpZbSiaRGvJOQm6aqq7V3pGv7Nfnjx2HYgpZrQQNv1nf8S8E9ZCZfOVnaHrh81ssqt5/g6vsFT3/I19i1CG0q3fmmrDa6hJ3IuMKc02ghLiHDeuLNx994HuM+NuePthhOlhHsKD/9dmRAd11AWPELDq3nN0xU/65FuYBPA==", "sat_seal": "eajtJ8GqQtSquXU2HlJqlaImQmawLSAe+ke8A7+Jhf1gd5RthSjOpT7uvIs71DmS5tCV7OhLncqsR7HRtmymUGk5MouhLRLe+EcBQeNI0B9Vn4XkgbOCy9j1yWgrcGBx62+ks42ClNKhGQE0+L0NMrjalZglfpkR3nrQbbcjDg6v7AdW5Q/sopW6e824sCAhbV90ZKyuMoDh7sJAZXT/h/fmzqU3WqYcdX5hvGDNtUQPbzkfx2r5NmDQOReqWxiC1TbUoJft/KhWvWUpC60g3jfeDv594aT1GL+0sg4VKFIDVFe5maPR0xCBknh2tOVpXimZR8S5BkX9eu6ju9CX2A==", "original_chain": "||1.1|D4E86AC6-F771-31CC-1639-018F598DE960|2026-10-14T11:05:15|SPR190613I52|xbHqJY7NGMh0sLc04E/BTfD0PsUzGZxqZScTRIQ1DhRFanI6Drqe0C8/640elUX9jeaQLN5GmyiVIc/50BlMmVb1L3YthVjXm/JRofSdzmJZ6v7ScJRaMVzfrnjD0xPB6qOVD1s1Fel7voooXc93i8ARN1260nDGioLCDRPFJa9A4l+QXpZbSiaRGvJOQm6aqq7V3pGv7Nfnjx2HYgpZrQQNv1nf8S8E9ZCZfOVnaHrh81ssqt5/g6vsFT3/I19i1CG0q3fmmrDa6hJ3IuMKc02ghLiHDeuLNx994HuM+NuePthhOlhHsKD/9dmRAd11AWPELDq3nN0xU/65FuYBPA==|00001000000509465028||" }, "issuer": { "rfc": "HSA2001159T6", "name": "HERU SANDBOX", "tax_regime": "601", "postal_code": "06600" }, "receiver": { "rfc": "PDE180514R21", "name": "PLATAFORMA DEMO", "tax_regime": "601", "postal_code": "11000" }, "third_party": { "rfc": "SACL900105T28", "name": "LUIS FERNANDO SANCHEZ CRUZ", "tax_regime": "625", "postal_code": "64000" }, "place_of_issue": "06600", "items": [ { "description": "Servicio de entrega a domicilio", "quantity": 1, "unit_code": "E48", "unit_price": "1077.59", "product_code": "78101800", "tax_object": "02", "vat_rate": "0.16", "subtotal": "1077.59", "vat": "172.41", "withholdings": null } ], "related_invoices": [], "payment_method": "PUE", "payment_form": "03", "cfdi_use": "G03", "currency": "MXN", "subtotal": "1077.59", "vat": "172.41", "withholdings": null, "total": "1250.00", "cancellation": null, "metadata": {}, "created_at": "2026-10-14T17:05:12.902Z", "stamped_at": "2026-10-14T17:05:15.802Z", "updated_at": "2026-10-14T17:05:15.802Z" }, { "id": "inv_01m4x9de9pf8hrm43q2364d8sg", "external_id": "INV-2026-000301", "status": "stamped", "type": "I", "uuid": "7D41C0A2-6B0E-4F2C-9A51-3E8D2B6F9C14", "verification_url": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=7D41C0A2-6B0E-4F2C-9A51-3E8D2B6F9C14&re=PDE180514R21&rr=CDE170303B61&tt=58000.00&fe=lZisZw==", "stamp": { "sat_certificate_number": "00001000000509465028", "issuer_certificate_number": "00001000000712345678", "pac_rfc": "SPR190613I52", "issuer_seal": "qSurm+B2r25lk+iP1BHvzjCBpCLaHdj6gbjUX+IPobNZz3HVbaq4eHksLQ8tLbMcR3kWApCrdTIuVc3PY4dQc+/DmV0KL8ZYADll8u0NpjBcVBU4PcCkkhpd+9wziFFFAtzghZWC2SMT/ZNVsmcS9+2kNxuVClmvcNckgJhQtPCvLRB3Fsuv5/zR7Z2lXWR19PmQ7xAi8L/SnNpvnHIkX5WNqEIOEjvlLrn3eBHOSW7WT0n/8XYwHQ3GAwHWwMeciesj+C4XaVVAu0ftbWTCxPx4zBAXogRfJ8O74AyDMJ0gODY5F9bFKl2ylfiA+hZjIGp37fZ/H0Xi7DAmlZisZw==", "sat_seal": "KyHdIMec7Sq8DsASr9ZZckBQsuZZ4jSZ3SOk1EyEhhaEp5Yutr9vDjok77g9DdCFn49NIqkvc0X9KT34kvi9DlTjByswAqJA5XSzEBV++FPX0kyCB794c5DKLkp9cG8PRe/CY0QEisQzi7IsR8wfxlbqQQbWSzdGq7vPUN2TY567mt363U3CQ51R+rgDQ2opskhNE4kGg+SLuCJAaKH7+/VN1fK2RFv89R3GCZ3I2s/kFc51glz0Xgc+VFNn3oNgF9px8f4Dmc+icdjYmrh99cvnLRcSa7vxZgbVEuRJqrUFia4rP+o5grLXBD2zZvUBJP+tSJ+HXuGMv0/UtbpIjA==", "original_chain": "||1.1|7D41C0A2-6B0E-4F2C-9A51-3E8D2B6F9C14|2026-10-14T07:25:21|SPR190613I52|qSurm+B2r25lk+iP1BHvzjCBpCLaHdj6gbjUX+IPobNZz3HVbaq4eHksLQ8tLbMcR3kWApCrdTIuVc3PY4dQc+/DmV0KL8ZYADll8u0NpjBcVBU4PcCkkhpd+9wziFFFAtzghZWC2SMT/ZNVsmcS9+2kNxuVClmvcNckgJhQtPCvLRB3Fsuv5/zR7Z2lXWR19PmQ7xAi8L/SnNpvnHIkX5WNqEIOEjvlLrn3eBHOSW7WT0n/8XYwHQ3GAwHWwMeciesj+C4XaVVAu0ftbWTCxPx4zBAXogRfJ8O74AyDMJ0gODY5F9bFKl2ylfiA+hZjIGp37fZ/H0Xi7DAmlZisZw==|00001000000509465028||" }, "issuer": { "rfc": "PDE180514R21", "name": "PLATAFORMA DEMO", "tax_regime": "601", "postal_code": "11000" }, "receiver": { "rfc": "CDE170303B61", "name": "COMERCIALIZADORA DEMO", "tax_regime": "601", "postal_code": "64000", "email": null }, "third_party": null, "place_of_issue": "11000", "items": [ { "description": "Desarrollo de sistema a la medida", "quantity": 1, "unit_code": "E48", "unit_price": "50000.00", "product_code": "81111500", "tax_object": "02", "vat_rate": "0.16", "subtotal": "50000.00", "vat": "8000.00", "withholdings": null } ], "related_invoices": [ { "relationship": "04", "uuid": "1F0C9B7E-2A4D-4C61-8E3B-5D7A9F2C4E80", "invoice_id": "inv_01m4tfeaarf5kae9wamfw419yc" } ], "payment_method": "PUE", "payment_form": "03", "cfdi_use": "G03", "currency": "MXN", "subtotal": "50000.00", "vat": "8000.00", "withholdings": null, "total": "58000.00", "cancellation": null, "metadata": {}, "created_at": "2026-10-14T13:25:18.774Z", "stamped_at": "2026-10-14T13:25:21.902Z", "updated_at": "2026-10-14T13:25:21.902Z" }, { "id": "inv_01m4v259sef2rsr0sfakwy7sgb", "external_id": "INV-2026-000288", "status": "cancelled", "type": "I", "uuid": "30CD8541-AED3-F11E-1595-4BD6C3A00579", "verification_url": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=30CD8541-AED3-F11E-1595-4BD6C3A00579&re=PDE180514R21&rr=HEGL900101K44&tt=870.00&fe=MwLLqg==", "stamp": { "sat_certificate_number": "00001000000509465028", "issuer_certificate_number": "00001000000712345678", "pac_rfc": "SPR190613I52", "issuer_seal": "A15e2iAOraMn0X/g7Q8HnEDBYQltr+3kR/diA2pFWCUgYg6RhEYtXrzXJ5+lO6X/WHKxl+lu7GUEgzbmJ2OZ1i4aGVLSR/uiH/UlcmHvRmvgsd0Oz4uSc+0ef+xLMVqFgPZNTdoeKUAC3LQn3xOtbessQe1sa1bLsQ9epyGsVudex74sMnbjGTA1jT3ddtbJupClGCTnxZF9idz/0ggYcjfVaObpbQTJHPpWpxL317yyHzhda76yIGLVYv85OE5vU6xjPdYe+1NhHZrtK3NyefKA7aksmJ//usIYOvDlC4SebQTd0SL3ROnR1HMtf2nPvBkBwqU2rUOn3dU4MwLLqg==", "sat_seal": "gt2C0WBb8A+20aIDSxxOmhf4+dInRoxsF6i31VmSNBvF32OgRf+WDLGK1f1d5lsuSwohSD8LG+AzqoQs4c1topiDgFAP12QY7ONPNJm8RJCO2Zrlk9zjfl/2o6TwsNFUeUi0tHxPk1SExP74DS09UoJXauXQ8n9MNxscXWuMTAKhDSvFhr22h40AgjIpEY84fdUl2arIdElNFxd5paq/ER+WIY3Tr+4RQxEGbTRkjEMBaoasmWWPULLsLe/p/vX9tcQjL1B8q/rizPtCOYstd/C1f47IzV9xijOo717NMFyLxVkULaMLvsPaoI8mH8c67mXI5/7o/U4X2aTkfXCoYw==", "original_chain": "||1.1|30CD8541-AED3-F11E-1595-4BD6C3A00579|2026-10-13T10:40:06|SPR190613I52|A15e2iAOraMn0X/g7Q8HnEDBYQltr+3kR/diA2pFWCUgYg6RhEYtXrzXJ5+lO6X/WHKxl+lu7GUEgzbmJ2OZ1i4aGVLSR/uiH/UlcmHvRmvgsd0Oz4uSc+0ef+xLMVqFgPZNTdoeKUAC3LQn3xOtbessQe1sa1bLsQ9epyGsVudex74sMnbjGTA1jT3ddtbJupClGCTnxZF9idz/0ggYcjfVaObpbQTJHPpWpxL317yyHzhda76yIGLVYv85OE5vU6xjPdYe+1NhHZrtK3NyefKA7aksmJ//usIYOvDlC4SebQTd0SL3ROnR1HMtf2nPvBkBwqU2rUOn3dU4MwLLqg==|00001000000509465028||" }, "issuer": { "rfc": "PDE180514R21", "name": "PLATAFORMA DEMO", "tax_regime": "601", "postal_code": "11000" }, "receiver": { "rfc": "HEGL900101K44", "name": "JOSE LUIS HERNANDEZ GARCIA", "tax_regime": "612", "postal_code": "06600", "email": "joseluis.hernandez@cliente.example" }, "third_party": null, "place_of_issue": "11000", "items": [ { "description": "Licencia de software mensual", "quantity": 1, "unit_code": "E48", "unit_price": "750.00", "product_code": "43231500", "tax_object": "02", "vat_rate": "0.16", "subtotal": "750.00", "vat": "120.00", "withholdings": null } ], "related_invoices": [], "payment_method": "PUE", "payment_form": "03", "cfdi_use": "G03", "currency": "MXN", "subtotal": "750.00", "vat": "120.00", "withholdings": null, "total": "870.00", "cancellation": { "reason": "02", "replacement_uuid": null, "requested_at": "2026-10-14T09:12:40.511Z", "cancelled_at": "2026-10-14T09:12:43.027Z" }, "metadata": {}, "created_at": "2026-10-13T16:40:03.118Z", "stamped_at": "2026-10-13T16:40:06.518Z", "updated_at": "2026-10-14T22:21:30.118Z" }, { "id": "inv_01m4tfeaarf5kae9wamfw419yc", "external_id": "INV-2026-000279", "status": "cancellation_requested", "type": "I", "uuid": "1F0C9B7E-2A4D-4C61-8E3B-5D7A9F2C4E80", "verification_url": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=1F0C9B7E-2A4D-4C61-8E3B-5D7A9F2C4E80&re=PDE180514R21&rr=CDE170303B61&tt=58000.00&fe=wEqS/Q==", "stamp": { "sat_certificate_number": "00001000000509465028", "issuer_certificate_number": "00001000000712345678", "pac_rfc": "SPR190613I52", "issuer_seal": "v/hmW60VefVtd6X5MYnA6I7Utbgca0wTlCi6t3z8iHSECda8b7zl04U1Rp3Utf2pjtVvNbjFXJV2BVdZ2qkHqbb4jNsXyeAc+jbeobC2ySEzr+fFvol1KEsg7C5LomVSGG0rszWIOIO2bWS50riz6B5uQga9nrJIqzSfR5HtQo1dsNgm+6H8atvrMpyI90N+ydbHmw29ONs6hZiHTkXLU86rJTKvYpmBCGO2lWvTUo2x49vqF7AZG5BnKbyw6yS1OEAtDlcJhIPU4FW4t7M1PeCk2RHKyddZTZEzngn48TT6AWE3zMjyrVxoA1V83qtCgh+EksDVt1e4w1NrwEqS/Q==", "sat_seal": "43WRIBNkAk1Z2Vp7udiZejDCbV/CZxuv2MG1Xq3s7CNLCu3H45o9DPlx/U31GDLCcHEXlC+OrqVoEZwDUFuWWim8Qx9ENQpHdKxf8hn9fChHyo1rY364aH+CiVdidiDeHphYGvVj0HkCLTinxvO2ZZT7vpAuR6r8TZbNVU7dml+KzbeGZA4IjG0Zmabx7Ij8iW+RXYIgonBt15rTZ8JG51+mf9fs7G7P4y9P4USN4WXsPsLVqpK1nI8PmC9jly4skkKp3osVtO75vumPdrGU8gZHBy9eAlgwKa1tbLFJu7FuUXS0S2upJWvMFyzMfeEaHNEgENpeMM4Usi9lA5bwkg==", "original_chain": "||1.1|1F0C9B7E-2A4D-4C61-8E3B-5D7A9F2C4E80|2026-10-13T05:12:58|SPR190613I52|v/hmW60VefVtd6X5MYnA6I7Utbgca0wTlCi6t3z8iHSECda8b7zl04U1Rp3Utf2pjtVvNbjFXJV2BVdZ2qkHqbb4jNsXyeAc+jbeobC2ySEzr+fFvol1KEsg7C5LomVSGG0rszWIOIO2bWS50riz6B5uQga9nrJIqzSfR5HtQo1dsNgm+6H8atvrMpyI90N+ydbHmw29ONs6hZiHTkXLU86rJTKvYpmBCGO2lWvTUo2x49vqF7AZG5BnKbyw6yS1OEAtDlcJhIPU4FW4t7M1PeCk2RHKyddZTZEzngn48TT6AWE3zMjyrVxoA1V83qtCgh+EksDVt1e4w1NrwEqS/Q==|00001000000509465028||" }, "issuer": { "rfc": "PDE180514R21", "name": "PLATAFORMA DEMO", "tax_regime": "601", "postal_code": "11000" }, "receiver": { "rfc": "CDE170303B61", "name": "COMERCIALIZADORA DEMO", "tax_regime": "601", "postal_code": "64000", "email": null }, "third_party": null, "place_of_issue": "11000", "items": [ { "description": "Desarrollo de sistema a la medida", "quantity": 1, "unit_code": "E48", "unit_price": "50000.00", "product_code": "81111500", "tax_object": "02", "vat_rate": "0.16", "subtotal": "50000.00", "vat": "8000.00", "withholdings": null } ], "related_invoices": [], "payment_method": "PUE", "payment_form": "03", "cfdi_use": "G03", "currency": "MXN", "subtotal": "50000.00", "vat": "8000.00", "withholdings": null, "total": "58000.00", "cancellation": { "reason": "01", "replacement_uuid": "7D41C0A2-6B0E-4F2C-9A51-3E8D2B6F9C14", "requested_at": "2026-10-14T13:27:04.640Z", "cancelled_at": null }, "metadata": {}, "created_at": "2026-10-13T11:12:55.640Z", "stamped_at": "2026-10-13T11:12:58.740Z", "updated_at": "2026-10-14T13:27:04.640Z" }, { "id": "inv_01m4ra8w8mfa8svf5396b2p5e1", "external_id": "INV-2026-000245", "status": "stamped", "type": "I", "uuid": "5829F7E9-4996-450C-BE13-9EE83FD56065", "verification_url": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=5829F7E9-4996-450C-BE13-9EE83FD56065&re=PDE180514R21&rr=HEGL900101K44&tt=1160.00&fe=ydyupw==", "stamp": { "sat_certificate_number": "00001000000509465028", "issuer_certificate_number": "00001000000712345678", "pac_rfc": "SPR190613I52", "issuer_seal": "GHbnil3a0FVwE7ynElV7a/eMdiNsWGBg72T2sHjC6CSRg4CIP947uTmefzvTKPcAoTI9NKFKCAVRf/i6w0HP+Op7Twhh/i2cHOGUUMfWDh/ILDldff/tt7OVzRiunV/Mb8FIWL7yjvU4qWeLzhKSi3WhAAKI9wJW9DBBsid3Q9566BqAldbGgN9YIoPNTdFKPLj9CXK5uSWqnt5jcllVUx3CscBVdoxpCHXfGUN9blsdOXKQ8SV3lv4weMup2+moMzsHXiNTXR6iAkk+WycILJfBGOXk3EIu8+a2fp/IOW+KL6wmPcEEqumiNkK8LeXXtljmVnFMi236w0Fuydyupw==", "sat_seal": "i0o/7TJngD+XRxvsWYHvdAEuw4ozKSJToKkCo6M054CavGKcbwBzzoDvmKQXHsgOCtyRdv9aOGG/UrqBnAffWF36C2TatEaD1b4Y5A6X7KIROheWwr/5zbddOflrlufSQIySnPEzCmE+sgQ7So7RqXJmtpEGW+eXwjRH1YoF2h0TQ5jqGkpTSTjiyoRvMWvC/FPC9O9HJtsXiRHLxWWzQGvsWAXdYNwFYVvI4oXzj38quDonetE+bUi+Qu7KA/xJQdEwsvhdUn7JLoqzXqcKnp2306uy7GFD7Wl/1tMIBPiJqX8x06qXWMEa0WFWM3gWzI0PVtXRoBjYDF8pdwoHpA==", "original_chain": "||1.1|5829F7E9-4996-450C-BE13-9EE83FD56065|2026-10-12T09:04:08|SPR190613I52|GHbnil3a0FVwE7ynElV7a/eMdiNsWGBg72T2sHjC6CSRg4CIP947uTmefzvTKPcAoTI9NKFKCAVRf/i6w0HP+Op7Twhh/i2cHOGUUMfWDh/ILDldff/tt7OVzRiunV/Mb8FIWL7yjvU4qWeLzhKSi3WhAAKI9wJW9DBBsid3Q9566BqAldbGgN9YIoPNTdFKPLj9CXK5uSWqnt5jcllVUx3CscBVdoxpCHXfGUN9blsdOXKQ8SV3lv4weMup2+moMzsHXiNTXR6iAkk+WycILJfBGOXk3EIu8+a2fp/IOW+KL6wmPcEEqumiNkK8LeXXtljmVnFMi236w0Fuydyupw==|00001000000509465028||" }, "issuer": { "rfc": "PDE180514R21", "name": "PLATAFORMA DEMO", "tax_regime": "601", "postal_code": "11000" }, "receiver": { "rfc": "HEGL900101K44", "name": "JOSE LUIS HERNANDEZ GARCIA", "tax_regime": "612", "postal_code": "06600", "email": "joseluis.hernandez@cliente.example" }, "third_party": null, "place_of_issue": "11000", "items": [ { "description": "Servicio de consultoría", "quantity": 1, "unit_code": "E48", "unit_price": "1000.00", "product_code": "84111506", "tax_object": "02", "vat_rate": "0.16", "subtotal": "1000.00", "vat": "160.00", "withholdings": null } ], "related_invoices": [], "payment_method": "PUE", "payment_form": "03", "cfdi_use": "G03", "currency": "MXN", "subtotal": "1000.00", "vat": "160.00", "withholdings": null, "total": "1160.00", "cancellation": null, "metadata": {}, "created_at": "2026-10-12T15:04:05.208Z", "stamped_at": "2026-10-12T15:04:08.422Z", "updated_at": "2026-10-12T15:04:08.422Z" } ], "next_cursor": "eyJiZWZvcmUiOiJpbnZfMDFtNHJhOHc4bWZhOHN2ZjUzOTZiMnA1ZTEifQ"}Cancel an invoiceDEL
Requests the cancellation with the SAT. Invoices above 1,000 MXN to a taxpayer need the receiver's acceptance: the status stays `cancellation_requested` until they accept, and `invoice.cancelled` tells you when it is done. Smaller invoices and those to the general public are cancelled right away. The invoice is not deleted: it stays with status `cancelled` and its `cancellation` details. Needs the `invoices:cancel` scope.
Get an invoiceGET
Returns the stamped invoice with its parties, items, totals and, if requested, its cancellation. Needs the `invoices:read` scope.