Skip to main content

​
Banking API

The Conta Digital Public API provides programmatic access to banking operations including account management, balance inquiries, transaction history, and PIX transfers.

​
Base URL

All API requests should be made to: 
https://conta-public-api.kiwify.com
For development and testing, use the development environment: https://conta-public-api-dev.kiwify.com

​
API Versioning

The API uses URL path versioning. Current version is v1. All versioned endpoints are prefixed with /v1/.

​
Error Format

All errors follow a consistent JSON format: 
{
  "error": {
    "code": "error_code",
    "message": "Human-readable error description",
    "details": {}
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Common HTTP Status Codes

HTTP StatusDescription
200Success
401Authentication failed - invalid signature, expired timestamp, or invalid access ID
403Access denied - IP not in allowlist or insufficient permissions
404Resource not found
500Internal server error

​
Next Steps

Authentication

Learn how to authenticate using EdDSA Proof-of-Possession

API Endpoints

Explore the available API endpoints