# Routing events

The <a href="https://docs.solidgate.com/orchestration/routing/manage-routing/#track-routing" target="_blank">report</a> provides a comprehensive view of routing decisions and execution flow for orders processed through routing configurations.
It captures the complete sequence of routing events for each transaction, including selected steps, skipped steps with reasons, 3DS decisions, and connector account details.
<blockquote>
<p>This report uses the <code>created_at</code> as the default parameter for unloading data. The date range between <code>date_from</code> and <code>date_to</code> must not exceed <strong>36 days</strong>.</p>
<p>In a successful response, the <code>report_url</code> field will contain a link to the file.</p>
</blockquote>

Endpoint: POST /routing/events
Version: 1.0.0
Security: MerchantID

## Header parameters:

  - `merchant` (string, required)

  - `signature` (string, required)

## Request fields (application/json):

  - `filter` (string)
    Filtering criteria for the report data.
    Enum: "updated_at", "created_at"

  - `date_from` (string, required)
    Start datetime for the report stated in UTC+0.
    Example: 2025-08-15 11:00:00

  - `date_to` (string, required)
    End datetime for the report stated in UTC+0.
    Example: 2025-09-20 13:00:00

## Response 200 fields (application/json):

  - `report_url` (string, required)
    URL for the report stored on Amazon S3, which needs to be downloaded.
    Example: https://reports.solidgate.com/api/v1/routing/events/report/routing_220504_143924_test/download

  - `error` (object, required)
    Error object.

  - `error.code` (string, required)
    Unauthorized access due to invalid credentials.
    Example: 1.01

  - `error.messages` (array, required)
    Array of error messages applied to the decline payment.