List Undeliverable TED IN Credits

curl --request GET \
  --url https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "id": "018f3a1c-1b2c-7def-8a9b-0c1d2e3f4a5b",
      "jdIncomingMessageId": "018f3a1c-1b2c-7def-8a9b-0c1d2e3f4a5c",
      "messageSequence": "SEQ-42",
      "controlNumber": "202602010001",
      "amount": "15000.00",
      "rejectionCategory": "RECIPIENT_NOT_FOUND",
      "rejectionReason": "no recipient account was found in any organization bound to this tenant",
      "resolutionStatus": "PENDING",
      "reconciliationAttempts": 3,
      "lastVendorCode": "ALC02",
      "createdAt": "2026-02-01T15:30:00Z",
      "updatedAt": "2026-02-01T15:35:00Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "returned": 2,
    "totalCount": 123,
    "hasNextPage": false
  }
}

List Undeliverable TED IN Credits

Use this endpoint to list the inbound TED credits that could not be delivered, so an operator can tell a recipient that does not exist from a ledger refusal, and see how far the re-querying of each one has got, without database access. The rejection reason is a fixed sentence derived from the category; no customer identity or upstream error text is exposed.

This is a read-only administrative endpoint. It does not require the X-Organization-Id header. In multi-tenant deployments the list is scoped to the caller’s resolved tenant database.

GET

/

v1

/

transfers

/

ted-in

/

undeliverables

List Undeliverable TED IN Credits

curl --request GET \
  --url https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables \
  --header 'Authorization: Bearer <token>'

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://ted.sandbox.lerian.net/v1/transfers/ted-in/undeliverables"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "items": [
    {
      "id": "018f3a1c-1b2c-7def-8a9b-0c1d2e3f4a5b",
      "jdIncomingMessageId": "018f3a1c-1b2c-7def-8a9b-0c1d2e3f4a5c",
      "messageSequence": "SEQ-42",
      "controlNumber": "202602010001",
      "amount": "15000.00",
      "rejectionCategory": "RECIPIENT_NOT_FOUND",
      "rejectionReason": "no recipient account was found in any organization bound to this tenant",
      "resolutionStatus": "PENDING",
      "reconciliationAttempts": 3,
      "lastVendorCode": "ALC02",
      "createdAt": "2026-02-01T15:30:00Z",
      "updatedAt": "2026-02-01T15:35:00Z"
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "returned": 2,
    "totalCount": 123,
    "hasNextPage": false
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT Bearer token authentication. The tenantId is derived from the bearer token or authenticated request context and is not supplied through X-Organization-Id.

Parâmetros de consulta

status

enum<string>

Filter by resolution status.

Opções disponíveis:

PENDING,

IN_PROGRESS,

RETAINED,

RETURNED,

ABSORBED,

FAILED

category

enum<string>

Filter by rejection category.

Opções disponíveis:

RECIPIENT_NOT_FOUND,

RECIPIENT_ACCOUNT_INVALID,

MALFORMED_MESSAGE,

FEE_RESOLUTION_FAILED,

MIDAZ_REJECTION,

CREDITED_AMOUNT_ZERO,

ORGANIZATION_MISSING,

ISPB_NOT_OWNED_BY_TENANT

limit

integer

padrão:50

Maximum number of records to return.

Intervalo obrigatório: 1 <= x <= 200

offset

integer

padrão:0

Number of records to skip for pagination. Advance it by the returned value of the previous page.

Intervalo obrigatório: x >= 0

Resposta

Indicates that the request was successful and the matching undeliverable credits are returned.

items

object[]

Show child attributes

pagination

object

Show child attributes