Upload a native Chainalysis alert response - Karsa Data Ingestion API

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

{
  "outcome": "CREATED",
  "resourceId": "chainalysis_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

/

chainalysis

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

{
  "outcome": "CREATED",
  "resourceId": "chainalysis_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

providerProduct

string

required

Required string length: 1 - 200

providerApiVersion

string

required

Required string length: 1 - 200

providerRecordId

string

required

Required string length: 1 - 200

response

object

required

Hide child attributes

response.status

string

required

Required string length: 1 - 200

response.alerts

object[]

Maximum array length: 1000

Hide child attributes

response.alerts.alertIdentifier

string

Required string length: 1 - 200

response.alerts.level

string

Required string length: 1 - 200

response.alerts.status

string

Required string length: 1 - 200

response.alerts.category

string

Required string length: 1 - 200

response.alerts.service

string

Required string length: 1 - 200

response.alerts.exposureType

string

Required string length: 1 - 200

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

providerExecutionId

string | null

Required string length: 1 - 200

Response

The identical source Chainalysis screening observation already exists

outcome

enum<string>

required

Available options:

CREATED,

EXISTING

resourceId

string

required

Minimum string length: 1

observedAt

string<date-time>

required