Skip to main content
An extraction is the process Syntage uses to retrieve or refresh information from a datasource for an entity. Extractions are how Syntage gets SAT records, invoices, tax returns, RPC filings, RUG guarantees, Buró de Crédito reports, BIL reports, and other datasource-backed information. Syntage is not connected to every datasource in real time. Data appears or updates when an extraction runs. Extractions that retrieve many records, such as invoices or tax returns, save records as they go, so some records can appear in the API and in Data while the extraction is still running. Wait until the extraction is finished before treating its data as complete. If an extraction fails, records it saved before failing may remain available, but its data is incomplete.

How extractions start

Extractions can start in several ways: For dashboard setup, read Extraction schedulers. For developer examples, read Extraction request examples.

Extraction status

An extraction moves through statuses while Syntage queues, runs, and finishes the work. In the dashboard, check the status to understand whether Syntage is still retrieving data, waiting for a prerequisite, finished, or unable to complete the extraction. Waiting means Syntage cannot run the extraction yet because something still blocks it, such as missing entity information, authorization, an unavailable credential, or an internal dependency. If an extraction fails or remains pending longer than expected, check whether the datasource is available, whether the entity’s credential or authorization is valid, and whether the extraction reached a datasource limit. For the exact API status values, billing behavior for stopped or cancelled extractions, and extraction error codes, see the Extractions resource guide.

Extractions, reports, and data

Extractions retrieve source information. Syntage then uses that information to populate:
  • Reports, where your team reviews processed indicators, summaries, charts, and analysis
  • Data, where your team reviews source records, raw structured data, and original files
  • Exports, where your team downloads information that Syntage already retrieved
Reports are calculated from the records Syntage has saved. While an extraction runs, reports reflect the records saved so far. Some report values, such as the Syntage Score, are recalculated after the extraction finishes and can take a short time to update. Exports do not create new extractions. They package existing Syntage data into downloadable files.

Usage and billing

Extractions can count toward plan usage. A processed entity is an RFC that has at least one extraction during the current month, and extraction counts may also be limited by your plan. You can review usage in Plan and Billing and extraction history in Extractions.

Technical reference

Developers can create and monitor extractions through the API. Use the Extractions resource guide for resource behavior and Create an extraction for endpoint details.