Get a transaction validation record by ID

curl --request GET \
  --url https://tracer.sandbox.lerian.net/v1/validations/{validation_id} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://tracer.sandbox.lerian.net/v1/validations/{validation_id}"

	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://tracer.sandbox.lerian.net/v1/validations/{validation_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://tracer.sandbox.lerian.net/v1/validations/{validation_id}"

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

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

print(response.text)

{
  "account": {
    "accountId": "00000000-0000-0000-0000-000000000000",
    "status": "ACTIVE",
    "type": "deposit",
    "metadata": {}
  },
  "amount": "100.00",
  "asset": "USD",
  "createdAt": "2021-01-01T00:00:00Z",
  "decision": "ALLOW",
  "evaluatedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "limitUsageDetails": [
    {
      "attemptedAmount": "100.00",
      "currentUsage": "500.00",
      "exceeded": true,
      "limitAmount": "1000.00",
      "limitId": "00000000-0000-0000-0000-000000000000",
      "period": "DAILY",
      "scope": "account:00000000-0000-0000-0000-000000000000",
      "skipReason": "outside_time_window",
      "skipped": true
    }
  ],
  "matchedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "processingTimeMs": 12.5,
  "reason": "Transaction denied by rule 'Block high-value checking transactions'",
  "requestId": "00000000-0000-0000-0000-000000000000",
  "scheme": "PIX",
  "totalRulesLoaded": 42,
  "transactionTimestamp": "2021-01-01T00:00:00Z",
  "transactionType": "PIX",
  "truncated": false,
  "validationId": "00000000-0000-0000-0000-000000000000",
  "merchant": {
    "category": "5411",
    "country": "US",
    "merchantId": "00000000-0000-0000-0000-000000000000",
    "name": "Acme Store",
    "metadata": {}
  },
  "metadata": {},
  "portfolio": {
    "portfolioId": "00000000-0000-0000-0000-000000000000",
    "metadata": {},
    "name": "growth"
  },
  "segment": {
    "segmentId": "00000000-0000-0000-0000-000000000000",
    "metadata": {},
    "name": "retail"
  },
  "subType": "purchase"
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

GET

validations

{validation_id}

Get a transaction validation record by ID

curl --request GET \
  --url https://tracer.sandbox.lerian.net/v1/validations/{validation_id} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://tracer.sandbox.lerian.net/v1/validations/{validation_id}"

	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://tracer.sandbox.lerian.net/v1/validations/{validation_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://tracer.sandbox.lerian.net/v1/validations/{validation_id}"

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

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

print(response.text)

{
  "account": {
    "accountId": "00000000-0000-0000-0000-000000000000",
    "status": "ACTIVE",
    "type": "deposit",
    "metadata": {}
  },
  "amount": "100.00",
  "asset": "USD",
  "createdAt": "2021-01-01T00:00:00Z",
  "decision": "ALLOW",
  "evaluatedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "limitUsageDetails": [
    {
      "attemptedAmount": "100.00",
      "currentUsage": "500.00",
      "exceeded": true,
      "limitAmount": "1000.00",
      "limitId": "00000000-0000-0000-0000-000000000000",
      "period": "DAILY",
      "scope": "account:00000000-0000-0000-0000-000000000000",
      "skipReason": "outside_time_window",
      "skipped": true
    }
  ],
  "matchedRuleIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "processingTimeMs": 12.5,
  "reason": "Transaction denied by rule 'Block high-value checking transactions'",
  "requestId": "00000000-0000-0000-0000-000000000000",
  "scheme": "PIX",
  "totalRulesLoaded": 42,
  "transactionTimestamp": "2021-01-01T00:00:00Z",
  "transactionType": "PIX",
  "truncated": false,
  "validationId": "00000000-0000-0000-0000-000000000000",
  "merchant": {
    "category": "5411",
    "country": "US",
    "merchantId": "00000000-0000-0000-0000-000000000000",
    "name": "Acme Store",
    "metadata": {}
  },
  "metadata": {},
  "portfolio": {
    "portfolioId": "00000000-0000-0000-0000-000000000000",
    "metadata": {},
    "name": "growth"
  },
  "segment": {
    "segmentId": "00000000-0000-0000-0000-000000000000",
    "metadata": {},
    "name": "retail"
  },
  "subType": "purchase"
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Path Parameters

validation_id

string

required

Transaction Validation ID (UUID)

Response

account

object

required

Show child attributes

amount

string

required

Example:

"100.00"

asset

string

required

Example:

"USD"

createdAt

string<date-time>

required

Example:

"2021-01-01T00:00:00Z"

decision

string

required

Example:

"ALLOW"

evaluatedRuleIds

string<uuid>[] | null

required

limitUsageDetails

object[] | null

required

Show child attributes

matchedRuleIds

string<uuid>[] | null

required

processingTimeMs

number<double>

required

Example:

12.5

reason

string

required

Example:

"Transaction denied by rule 'Block high-value checking transactions'"

requestId

string<uuid>

required

Example:

"00000000-0000-0000-0000-000000000000"

scheme

string

required

Maximum string length: 50

Example:

"PIX"

totalRulesLoaded

integer<int64>

required

Example:

42

transactionTimestamp

string<date-time>

required

Example:

"2021-01-01T00:00:00Z"

transactionType

string

required

Maximum string length: 50

Example:

"PIX"

truncated

boolean

required

Example:

false

validationId

string<uuid>

required

Example:

"00000000-0000-0000-0000-000000000000"

merchant

object

Show child attributes

metadata

object

Show child attributes

portfolio

object

Show child attributes

segment

object

Show child attributes

subType

string

Maximum string length: 50

Example:

"purchase"

Getting started

Validations API

Rules API

Limits API

Audit Events API

Dashboards API

Error handling

Events

Get a transaction validation record by ID

Authorizations

Path Parameters

Response