Failed transmissions
Failed transmissions lists the requests from connected customs systems that ITS refused: a declaration with a missing field, a stamp at the wrong office, a call made with a credential ITS does not accept. It is where you look when your customs system's team says "ITS rejected it", and where the Secretariat sees who is having trouble.
Each refusal is one line. Selecting it opens a panel that says what was wrong, which fields to correct and the reference to quote.
Nothing on this screen changes a declaration. You read it, and pass what it says to the team that runs your customs system.
Before you start
- Your account must be able to read declarations. The Secretariat, the administrators of a State Party or a REC, and customs officers can all open this screen. See What each role can do.
- If you are chasing one refusal, have its correlation ID ready. It is the value your system received in the
X-Correlation-IDheader of the refused response, and the reference shown in the portal's own error messages.
How to open it
- Select Overview, then the Failed transmissions tab.
- Or open All areas and select Failed transmissions under Operations.
- Or select a notification about refused requests, in the bell or in the notification centre. The screen then opens already filtered to that problem. See Open it from a notification.

What you see depends on who you are
| You are | The list shows |
|---|---|
| The Secretariat | Refusals of every organisation. The organisation filter beside the search opens on All organisations; choose one to see only its refusals. An Organisation column, and an Organisation line in the panel, say whose request each one was |
| A State Party or a REC | Your own organisation's refusals only. There is no organisation filter and no Organisation column |

Read the list
Rows are newest first, ten to a page.
| Column | What it shows |
|---|---|
| Received | The date and time ITS received the request, in UTC, with how long ago underneath, such as 11 days ago. The coloured edge at the start of the row is its urgency: red for Urgent, amber for Needs attention |
| Organisation | The Secretariat only: the organisation whose request it was, by name, with its country's flag or, for a REC, its badge. — when ITS could not tell who was calling |
| Request | The method and the address that was called, for example POST /api/v1/etd. A long address is cut short; the panel shows it whole |
| Urgency | The Urgent or Needs attention tag |
| Refusal | The error code, such as VAL-ETD-001, and a short title for it. The title is Refused when ITS has no title for the code |
| Status | The HTTP status of the answer, for example HTTP 400 |
Every column is always shown. When the table is wider than the space it has, for example on a phone or while the panel is open beside it, scroll it sideways inside its box.
Urgent or Needs attention
Every refusal carries one of two tags.
| Tag | When | What it means for you |
|---|---|---|
| Urgent (red) | ITS itself failed (status 500 or above); or your system's credential or permission was refused (status 401 or 403); or the refused request was anything other than a read of a declaration, such as lodging one, a stamp, a correction or an attachment | Cargo can be held up. Act on it first |
| Needs attention (amber) | Everything else. In practice, a request to read a declaration that found nothing or was badly formed | Worth fixing, but no consignment waits on it |
Move through the list
Under the table:
- Items per page changes how many rows a page holds.
- The count reads like 1–10 of 1,234 failed transmissions. ITS stops counting at ten thousand, and the count then reads of 10,000+.
- The Previous and Next arrows move one page at a time, Next towards older refusals. There are no page numbers.
Narrow the list
The filters sit in one bar above the table. Each one applies as soon as you set it, and they combine.
| Filter | What it does | Rules |
|---|---|---|
| The organisation filter (the Secretariat only) | Shows one organisation's refusals. It opens on All organisations | It reads Loading organisations… while the list of organisations arrives, and Organisation list unavailable if it cannot be read; the filter cannot then be used |
| Serial number | Shows the refusals of requests about one declaration | Type the whole serial number, then press Enter or move out of the field. It must match exactly. Lower-case letters are turned into capitals |
| Error code | Shows the refusals with one error code, such as VAL-ETD-001 | The same: the whole code, then Enter |
| Outcome | Every refusal, Lookups or ITS errors | Lookups are refused requests to read something. ITS errors are the requests ITS itself failed to handle (status 500 or above) |
| Received: From and To | The days counted. They open on the current month | The days are UTC days, so a refusal in the last hours of the month in your time zone can belong to the next month |
To set the period:
- Select From.
- Select the first day in the calendar.
- Select To.
- Select the last day.
The list reloads after each choice. A field holding a date reads like From: 01 Oct 2026 and shows an ×; select it to empty the field, which then reads Any date. With only one date set, the list runs from that day onwards, or up to that day. Empty both and the list returns to the current month.
If To is earlier than From, both fields are marked and the bar says The end date cannot be before the start date. Correct one of them.
Clear filters, at the end of the bar, appears while any filter or a correlation ID is set. It removes them all in one step.
The filters are kept in the page's address, so a copied link opens the same view for a colleague in your organisation.
Open one refusal
-
Select the row. With the keyboard, move to the row and press
EnterorSpace.A panel headed Failed transmission opens beside the table. Its title is the refusal's title, with its Urgent or Needs attention tag.

-
Read Refusal first: it says what to correct.
-
To pass the refusal to your technical team, select the copy button beside the Correlation ID. The icon turns to a tick when the ID is copied.
-
To close the panel, select Close panel at its top, or use the browser's Back button.
| Section | What it shows |
|---|---|
| Refusal | The error code and its title, and what to do about it where ITS knows. When particular fields were wrong, the panel lists each field by name, with the reason and, after Sent:, the value your system sent. For ERR-015 the advice above the list reads The affected fields are marked below. |
| Request | Method and Path, the address that was called. Route is the general form of that address, shown when it differs. Serial number, Stamp type, Version and Attachment appear when the request named one. Status is the HTTP status and the reason, for example HTTP 400 · INVALID_FIELDS |
| Who | Organisation (the Secretariat only, with the flag or REC badge), and Sent by: An integrated system, or A person, in the console |
| When | Received, in UTC to the second, with how long ago; and Swept on, the day ITS will remove this refusal from the list |
| Correlation ID | The value ITS returned in the X-Correlation-ID header of the refused response. Search your own system's logs for it, and quote it when you ask for help: it names this one request |
The Serial number is a link to the declaration, except when the refusal was HTTP 404: a declaration that was not found cannot be opened.
The meaning of every error code is in the error catalogue, and what to do about the common ones is in Errors and troubleshooting.
Look one refusal up by its correlation ID
- Select the search box, which reads Correlation ID — press Enter to look it up.
- Paste the correlation ID.
- Press
Enter.
The table shows every refusal recorded under that ID, on one page, whatever period and other filters are set. There is no page count under a lookup.
The list holds only requests made by connected systems. A lookup is the one exception: the reference shown in one of the portal's own error messages also finds that refusal, and the panel then reads Sent by: A person, in the console.
To return to the list, select Clear filters, or empty the search box and press Enter.
Open it from a notification
ITS groups the refusals of one kind into one notification: the same request, refused with the same error code, on the same UTC day. See Refused requests.
-
Select the notification, in the bell or in the notification centre.
Failed transmissions opens with Error code and Received already set to that problem and day. A grey Route tag in the bar names the request, for example Route
/api/v1/etd/{serial_no}. For the Secretariat, the organisation filter is set too. -
To see the same error on every request, select the × beside the Route tag. It is labelled Remove the route filter.
The Route tag only appears this way, or from a link that carries it. It cannot be set by hand.
Clear the notifications from here
While you have unread notifications about refused requests, a blue strip above the list reads, for example, 2 unread notifications about failed transmissions.
- Look at the refusals in the list.
- Select Mark as read on the strip.
The strip disappears, and those notifications are marked read for you, in the bell and in the notification centre. Nothing changes for your colleagues.
When new refusals arrive
The screen checks for new refusals about every half minute while it is open. When there are some under the filters you have set, a bar appears above the filters: 3 new failures — show them.
- Select the bar.
The list reloads from the newest refusal. The bar does not appear during a correlation ID lookup.
When the list is empty or cannot be read
| What you see | What it means | What to do |
|---|---|---|
| Nothing was refused | No request was refused in the period. Nothing else is filtered | Nothing. An older period can also be empty because refusals are kept for ninety days only |
| Nothing found for that search, after a correlation ID lookup | No refusal carries that ID | Check the ID against the X-Correlation-ID header of the response and, as the Secretariat, that the organisation chosen is the one that made the request |
| Nothing found for that search, with filters set | The filters match nothing | Widen the period, or select Clear filters |
| Grey placeholder rows under the column headings | The list is loading | Wait a few seconds |
| An error message in place of the table | The list could not be read | Try again from the message. If it persists, report it with the reference shown, which Copy reference copies; see Troubleshooting |
What ITS keeps, and for how long
A notice under the table says Failed transmissions are swept after ninety days. Each refusal is removed ninety days after it was received; the panel's Swept on gives the day.
- An empty list means nothing was refused in that period, not that nothing was ever refused.
- ITS never stores the content of a refused request. It keeps the names of the fields that were wrong and the values that were sent for those fields, which is what your technical team needs to fix it.
- Credentials and source addresses are stored only in scrambled form and are never shown.