Create bulk download request

POST

https://api.gigstack.io/v2/invoices/download/request

Submit a bulk download request to the SAT. The SAT processes these asynchronously — use GET /invoices/download/schedule/history to poll for status updates.

Prerequisites: FIEL uploaded (fiel_uploaded: true) + business registered (registered: true) + Descarga Masiva activated.

Date range: SAT limits each request to a maximum of 1 month. For longer periods, submit one request per month.

Once the request reaches completed status, the invoice metadata is available in the history response (invoiceCount, processedCount, latestIssueDate, earliestIssueDate).

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Request submitted (or duplicate detected)

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/invoices/download/request?team' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "start_date": "2024-01-01",
    "end_date": "2024-01-31",
    "rfc_type": "received"
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "request_id": "string",
        "duplicate": true,
        "status": "pending"
    }
}

Modified at 2026-04-02 23:55:47

Get download request history

Check download request status