Customers

Welcome to the Koteshen API documentation for the Customers feature. Koteshen is an invoicing application designed to streamline billing, payments, and customer management for businesses. This documentation focuses on the Customers endpoints, allowing you to manage customer records, including creating, reading, updating, and deleting them.

Authentication

All API requests require authentication via OAuth 2.0. Use the following details to obtain an access token:

• Authorization URL: https://koteshen.com/oauth/authorize
• Token URL: https://koteshen.com/oauth/token
• Client ID: km2aLyaDn709O3xegPcWDCYOKBAtQXj_kqe_MKTTry8
• Client Secret: MsN0XJN7iOkt4qSxH_8jnGvgq_TaamzlUcJ_FRweTzQ
• Scopes: read write
• Redirect URI: https://koteshen.com/ (or your registered callback URL)

Include the access token in the Authorization header as Bearer <token>.

Example Token Request (Client Credentials Flow)

curl -X POST https://koteshen.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=km2aLyaDn709O3xegPcWDCYOKBAtQXj_kqe_MKTTry8&client_secret=MsN0XJN7iOkt4qSxH_8jnGvgq_TaamzlUcJ_FRweTzQ&scope=read%20write"

Error Handling

• 401 Unauthorized: Invalid or expired token. Refresh or re-authenticate.
• Rate Limiting: 100 requests per minute per token. Header X-RateLimit-Remaining provides remaining quota.

Base URL for all endpoints: https://koteshen.com/api/v1