Skip to main content
POST
Create investigation
This API is in preview and subject to change.

Idempotent Endpoint

This endpoint supports idempotency to prevent duplicate investigations.

How to Use

  • Include an Idempotency-Key header with a unique value (UUID recommended)
  • The API returns the existing investigation when you reuse the same key
  • Retry requests safely without creating duplicates

Investigation Types

Claim Non-Receipt (camt.027)

  • For outbound SEPA CT payments in COMPLETED status
  • Requires additionalInfo in the request body

Payment Status Request (pacs.028)

  • For outbound SEPA INST payments in SENT_TO_CLEAR status
  • additionalInfo must not be provided

Headers

Idempotency-Key
string
required

Unique identifier to ensure idempotent investigation creation

Path Parameters

transactionId
integer<int64>
required

Payment transaction ID

Body

application/json
type
enum<string>
required

Investigation type to create

Available options:
CLAIM_NON_RECEIPT,
PAYMENT_STATUS_REQUEST
claimNonReceiptDetails
object

Claim non-receipt details, required when type is CLAIM_NON_RECEIPT

Response

Investigation created

createdAt
string<date-time>
required

Timestamp when the investigation was created

createdBy
string
required

User or system that created the investigation

direction
enum<string>
required

Investigation direction (INBOUND or OUTBOUND)

Available options:
OUTBOUND,
INBOUND
id
integer<int64>
required

Investigation ID

messageId
string
required

Investigation message ID

schema
enum<string>
required

Message schema identifier

Available options:
SEPA,
INST
status
enum<string>
required

Current investigation status

Available options:
PENDING,
RESOLVED,
REJECTED
type
enum<string>
required

Investigation type

Available options:
CLAIM_NON_RECEIPT,
PAYMENT_STATUS_REQUEST
claimNonReceiptDetails
object

Claim non-receipt investigation details, present for CLAIM_NON_RECEIPT type

delivery
object

Investigation message delivery status information from CSM

referencedTransactionId
integer<int64>

Referenced transaction ID

resolution
object

Resolution details, present when the investigation has been resolved

statusHistory
object[]

Investigation status change history, included when retrieving a single investigation

transactionDetails
object

Original transaction details referenced by the investigation

updatedAt
string<date-time>

Timestamp when the investigation was last updated

Last modified on July 10, 2026