Skip to main content

Introduction

What is Obseq?โ€‹

Obseq is a financial infrastructure platform that enables you to:

  • Onboard users as individuals or businesses with built-in KYC/KYB verification
  • Hold balances in multiple currencies including fiat and crypto assets
  • Move money via P2P transfers, fiat deposits/withdrawals, and crypto on/off-ramps
  • Manage recipients for recurring transfers
  • Receive real-time events via Server-Sent Events (SSE)

Base URLโ€‹

All API requests use the following base URL:

https://api.obseqops.cloud/v1

API Versioningโ€‹

All endpoints are prefixed with /v1. When breaking changes are introduced, a new version prefix will be released and the old version will be deprecated with advance notice.

Request Formatโ€‹

  • All request bodies must be application/json
  • All responses are application/json
  • Timestamps are in ISO 8601 format: 2024-01-15T10:30:00.000Z
  • Monetary amounts are represented as strings to preserve decimal precision

Response Formatโ€‹

Successful responses return a JSON object with the relevant data fields directly (no wrapper envelope). Errors follow a consistent format:

{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}

Rate Limitingโ€‹

Rate limits apply per authenticated party. If you exceed the limit, you will receive a 429 Too Many Requests response. Contact support to request higher limits.

Idempotencyโ€‹

For mutating operations that risk duplication (transfers, withdrawals, account creation), pass an x-idempotency-key header with a unique UUID per request. Replaying the same key within the idempotency window returns the original response without re-executing the operation.

x-idempotency-key: 550e8400-e29b-41d4-a716-446655440000

Next Stepsโ€‹