Language selection

Search

FINTRAC API report submission : Methods to report to FINTRAC

Added on October 23, 2023

From: Financial Transactions and Reports Analysis Centre of Canada (FINTRAC)

Find which types of financial transactions you can submit through the FINTRAC API report submission, how to access it, and related technical documentation to implement it.

On this page

What is FINTRAC API report submission

FINTRAC API report submission allows for the secure system-to-system transfer of report information to FINTRAC.

As of October 21, 2023, you can use API report submission to send FINTRAC the following reports:

Note: To find out when you will be able to use API report submission for other types of reports, please consult:

Registering to use FINTRAC API report submission

An application is required to submit reports using FINTRAC's API. At a minimum, one application and secret is required.

Your technical administration needs to access the FINTRAC API portal to receive enrollment instructions and information on how to create an application and secret keys, to authenticate the API submission pathway for you to begin submitting reports.

Access the FINTRAC API portal

Submitting reports through API

In this section

Submitting, changing and deleting reports

There are 2 groups of API endpoints:

Both API endpoints have 3 different actions for report submission:

Transaction submission limits

The transaction submission limits are different for the single API endpoint and the bulk submission:

If the number of transactions exceeds these limits, you must create a new report to include the additional transactions.

Linking transactions across multiple reports

When you create another report because you exceeded the transaction limit, you can link transactions across multiple reports by including the reporting entity report reference number with a suffix (for example, -01, -02, etc.). This will also ensure FINTRAC is aware of linked reports.

If you need to link transactions in multiple reports, you can continue counting transactions incrementally with each report.

Starting action and completing action limits

You can include up to 50 starting actions and 50 completing actions in a single transaction as long as they occurred on the same date and time.

If a transaction has more than 50 starting actions or more than 50 completing actions, you can include these additional starting or completing actions by creating a new transaction in the same report.

Note: Because you must provide a date and time for each transaction, it is understood that all the starting and completing actions within the transaction also occur at this date and time. If this is not the case, then you will need to add a new transaction to the report with the new date and time. This applies even if the number of starting actions or completing actions is under 50.

Technical documentation

Find the technical documents you'll need to complete the implementation of your API to submit the following reports through FINTRAC API report submission:

Note: Documentation for other report types will be added once implemented by FINTRAC as part of its multi-year initiative to implement important changes to its reporting forms.

Select type of report

All report types
Technical documentation for FINTRAC API report submission: All report types
Documentation type File Date published

Schemas

(Note: These files include content for each report type. Content for report types for which you do not use API report submission may be deleted as necessary.)

Bulk submission schema
(JSON, 2 kb)

October 23, 2023 Updated on January 19, 2024

Validation message schema
(JSON, 7 kb)

October 23, 2023 Updated on February 22, 2024

Delete schema
(JSON, 5 kb)

October 23, 2023

Samples

Validation message sample
(JSON, 8 kb)

October 23, 2023

Large Cash Transaction Reports
Technical documentation for FINTRAC API report submission: Large Cash Transaction Reports
Documentation type Web page or file Date published

Validation rules

Large Cash Transaction Reports API Validations rules

October 23, 2023

Schemas

Large Cash Transaction Report schema
(JSON, 24 kb)

October 23, 2023

Samples

Large Cash Transaction Report sample
(JSON, 6 kb)

October 23, 2023 Updated on January 19, 2024

Large Cash Transaction Report bulk submission sample
(JSON, 9 kb)

October 23, 2023 Updated on January 19, 2024

Large Virtual Currency Transaction Reports
Technical documentation for FINTRAC API report submission: Large Virtual Currency Transaction Reports
Documentation type Web page or file Date published

Validations rules

Large Virtual Currency Transaction Reports API Validations rules

October 23, 2023

Schemas

Large Virtual Currency Transaction Report schema
(JSON, 43 Kb)

October 23, 2023

Technical assistance

If you require assistance, or have questions regarding API report submission, please contact tech@fintrac-canafe.gc.ca.

Related guidance

Date Modified: