Upload a native SEON Fraud API response - Karsa Data Ingestion API

{
  "outcome": "EXISTING",
  "resourceId": "seon_screening_observation_resource_example_01",
  "observedAt": "2026-09-15T04:00:01.000Z"
}

{
  "outcome": "CREATED",
  "resourceId": "seon_screening_observation_resource_example_01",
  "observedAt": "2026-09-15T04:00:01.000Z"
}

{
  "type": "https://karsa.app/problems/invalid-request",
  "title": "Ingestion Rejected",
  "status": 400,
  "detail": "The request did not match the ingestion schema",
  "code": "INVALID_REQUEST",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/authentication-required",
  "title": "Ingestion Rejected",
  "status": 401,
  "detail": "A source-bound bearer credential is required",
  "code": "AUTHENTICATION_REQUIRED",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/resource-not-found",
  "title": "Ingestion Rejected",
  "status": 404,
  "detail": "A referenced source resource was not found",
  "code": "RESOURCE_NOT_FOUND",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/source-identity-conflict",
  "title": "Ingestion Rejected",
  "status": 409,
  "detail": "The source identity is already bound",
  "code": "SOURCE_IDENTITY_CONFLICT",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/future-effective-at",
  "title": "Ingestion Rejected",
  "status": 422,
  "detail": "Future-effective scheduling is not supported",
  "code": "FUTURE_EFFECTIVE_AT",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/rate-limited",
  "title": "Ingestion Rejected",
  "status": 429,
  "detail": "The ingestion source exceeded its configured rate",
  "code": "RATE_LIMITED",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/ingestion-internal-error",
  "title": "Ingestion Unavailable",
  "status": 500,
  "detail": "The ingestion request could not be completed",
  "code": "INGESTION_INTERNAL_ERROR",
  "requestId": "req_example_01"
}

POST

/

api

/

ingestion

/

screening-observations

/

seon

{
  "outcome": "EXISTING",
  "resourceId": "seon_screening_observation_resource_example_01",
  "observedAt": "2026-09-15T04:00:01.000Z"
}

{
  "outcome": "CREATED",
  "resourceId": "seon_screening_observation_resource_example_01",
  "observedAt": "2026-09-15T04:00:01.000Z"
}

{
  "type": "https://karsa.app/problems/invalid-request",
  "title": "Ingestion Rejected",
  "status": 400,
  "detail": "The request did not match the ingestion schema",
  "code": "INVALID_REQUEST",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/authentication-required",
  "title": "Ingestion Rejected",
  "status": 401,
  "detail": "A source-bound bearer credential is required",
  "code": "AUTHENTICATION_REQUIRED",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/resource-not-found",
  "title": "Ingestion Rejected",
  "status": 404,
  "detail": "A referenced source resource was not found",
  "code": "RESOURCE_NOT_FOUND",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/source-identity-conflict",
  "title": "Ingestion Rejected",
  "status": 409,
  "detail": "The source identity is already bound",
  "code": "SOURCE_IDENTITY_CONFLICT",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/future-effective-at",
  "title": "Ingestion Rejected",
  "status": 422,
  "detail": "Future-effective scheduling is not supported",
  "code": "FUTURE_EFFECTIVE_AT",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/rate-limited",
  "title": "Ingestion Rejected",
  "status": 429,
  "detail": "The ingestion source exceeded its configured rate",
  "code": "RATE_LIMITED",
  "requestId": "req_example_01"
}

{
  "type": "https://karsa.app/problems/ingestion-internal-error",
  "title": "Ingestion Unavailable",
  "status": 500,
  "detail": "The ingestion request could not be completed",
  "code": "INGESTION_INTERNAL_ERROR",
  "requestId": "req_example_01"
}

Authorizations

Authorization

string

header

required

Source-bound WorkOS API key or configured machine OIDC token. OIDC webhook management requires karsa:webhooks:manage.

Headers

Idempotency-Key

string

required

Stable source submission identifier, unique for this source and route

Required string length: 1 - 200

Example:

"01J9ZQ2YD15Y2YZ5H0W3J7D3E2"

Body

application/json

externalId

string

required

Required string length: 1 - 200

effectiveAt

string<date-time>

required

response

object

required

Option 1
Option 2

Hide child attributes

response.success

enum<boolean>

required

Available options:

true

response.data

object

required

Hide child attributes

response.data.id

string

required

Required string length: 1 - 200

response.data.state

string

required

Required string length: 1 - 200

response.data.fraud_score

number

response.data.blackbox_score

number

response.data.version

string

Required string length: 1 - 200

response.data.seon_id

response.data.applied_rules

object[]

Maximum array length: 500

Hide child attributes

response.data.applied_rules.id

response.data.applied_rules.name

string

response.data.applied_rules.score

number

response.data.rule_category_details

object[]

Maximum array length: 100

Hide child attributes

response.data.rule_category_details.{key}

any

response.error

any

customerId

string | null

Required string length: 1 - 200

accountId

string | null

Required string length: 1 - 200

transactionId

string | null

Required string length: 1 - 200

Maximum array length: 100

Hide child attributes

Available options:

CUSTOMER,

ACCOUNT,

TRANSACTION

Required string length: 1 - 200

providerObservedAt

string<date-time> | null

artifactHash

string | null

Pattern: ^[a-f0-9]{64}$

documents

object[]

Maximum array length: 25

Hide child attributes

documents.documentVersionId

string

required

Required string length: 1 - 200

documents.role

string

required

Required string length: 1 - 200

documents.roleDetail

string | null

Required string length: 1 - 200

Response

The identical source SEON screening observation already exists

outcome

enum<string>

required

Available options:

CREATED,

EXISTING

resourceId

string

required

Minimum string length: 1

observedAt

string<date-time>

required