Skip to main content
POST
/
exports
curl --request POST \
  --url https://api.syntage.com/exports \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "format": "xlsx",
  "fileTypes": [
    "invoice.cfdi.xml"
  ],
  "uri": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997/invoices?usage=I01&type=I&issuedAt[after]=2020-01-01"
}
'
{
  "@context": "/contexts/Export",
  "@id": "/exports/91106968-1abd-4d64-85c1-4e73d96fb997",
  "@type": "Export",
  "id": "91106968-1abd-4d64-85c1-4e73d96fb997",
  "file": {
    "type": "Export",
    "resource": "/exports/91106968-1abd-4d64-85c1-4e73d96fb997",
    "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "extension": "xlsx",
    "filename": "9137b53f-1abd-4d64-85c1-4e73d96fb997.xlsx"
  },
  "format": "xlsx",
  "fileTypes": [
    "invoice.cfdi.xml"
  ],
  "status": "pending",
  "uri": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997/invoices?usage=I01&type=I&issuedAt[after]=2020-01-01",
  "createdAt": "2020-01-01T12:15:00.000Z",
  "updatedAt": "2020-01-01T12:15:00.000Z"
}

Authorizations

​
X-API-Key
string
header
required

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

Body

application/json
​
format
enum<string>
required

Format for your resource

Available options:
csv,
xlsx,
json
​
uri
string
required

Collection URI used as the export source. Use the collection's query parameters to filter the exported data.

Example of supported URI values

  • /entities
  • /entities/{entityId}/tax-returns
  • /entities/{entityId}/invoices
Example:

"/entities/91106968-1abd-4d64-85c1-4e73d96fb997/invoices?issuedAt[after]=2026-01-01"

​
fileTypes
enum<string>[]

Optional file types to include in the generated export; when specified, the export file includes the matching content files

Minimum array length: 1
Available options:
invoice.cfdi.xml,
invoice.cfdi.pdf,
tax_return.transcript,
tax_return.ack_receipt,
tax_return.payment_receipt
Example:
["invoice.cfdi.xml"]

Response

Export resource response

​
@context
string
default:/contexts/Export
​
@id
string<iri-reference>

Export IRI reference

Example:

"/exports/91106968-1abd-4d64-85c1-4e73d96fb997"

​
@type
string
default:Export

JSON-LD resource type

​
id
string<uuid>

Unique export ID

Example:

"91106968-1abd-4d64-85c1-4e73d96fb997"

​
file
object

Generated file once the export is finished

Example:
{
  "type": "Export",
  "resource": "/exports/91106968-1abd-4d64-85c1-4e73d96fb997",
  "mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
  "extension": "xlsx",
  "filename": "9137b53f-1abd-4d64-85c1-4e73d96fb997.xlsx"
}
​
format
string

Output format for the generated export file

Example:

"xlsx"

​
fileTypes
enum<string>[]

File types to include in the export

Minimum array length: 1
Available options:
invoice.cfdi.xml,
invoice.cfdi.pdf,
tax_return.transcript,
tax_return.ack_receipt,
tax_return.payment_receipt
Example:
["invoice.cfdi.xml"]
​
status
enum<string>

Current export processing status

Available options:
pending,
running,
finished,
failed
Example:

"pending"

​
uri
string

API collection URI used as the export source

Example:

"/entities/91106968-1abd-4d64-85c1-4e73d96fb997/invoices?usage=I01&type=I&issuedAt[after]=2020-01-01"

​
createdAt
string

Date and time the resource was created

Example:

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

​
updatedAt
string

Date and time the resource was last updated

Example:

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