Skip to content

Assemble an upload​

POST
/data/api/v1/contribution-management/contribution/assemble

Checks the entries and answers with the unsigned upload transaction as hex. Nothing is stored. Sign the transaction with the signing key pair and send it to POST /data/api/v1/contribution-management/contribution.

The body is a JSON array of up to 5000 entries.

The identifier decides which fraud types an entry can carry:

Identifier Form Fraud types
Phone number E.164 with +, or a range +first-+last Wangiri, IRSF, SMSA2P, Flashcall, Scam
Device (IMEI) 15 digits with a correct check digit StolenDevice
IPv4 address dotted, or a range first-last IPFraud
Email address or URL as written Scam

A range must not run backwards.

Countries: origination and destination are ISO 3166-1 alpha-2 codes. A member that is left out counts as an empty text. An empty origination is accepted only for Scam and for numbers that start with +882 or +883. An empty destination is accepted only for Scam. Every other entry needs both codes, and null is never accepted: the call answers 400 with code 54.

Authorizations​

bearerAuth

The accessToken of a sign-in or refresh answer. Valid for 5 minutes.

Type
HTTP (bearer)

Request Body​

application/json
JSON
[
  
{
  
  
"id": "+447700900201",
  
  
"fraudType": "Wangiri",
  
  
"origination": "GB",
  
  
"destination": "GB"
  
},
  
{
  
  
"id": "+447700900210-+447700900219",
  
  
"fraudType": "IRSF",
  
  
"origination": "GB",
  
  
"destination": "FR"
  
},
  
{
  
  
"id": "356938035643809",
  
  
"fraudType": "StolenDevice",
  
  
"origination": "GB",
  
  
"destination": "GB"
  
}
]

Responses​

The unsigned transaction to sign.

application/json
JSON
{
  
"status": {
  
  
"code": 0,
  
  
"name": "Ok"
  
},
  
"data": "04a1b2c3d4e5f60718293a4b5c6d7e8f"
}

Samples​

Powered by VitePress OpenAPI