API Reference

The Ansdev Cloud API is REST-based, JSON-encoded, and versioned at the URL level.

Base URL

https://api.ansdev.cloud/v1

Conventions

• Request body: application/json (UTF-8)
• Response body: application/json
• Timestamps: ISO-8601 in UTC (e.g. 2026-05-23T10:00:00Z)
• Money: Credits as decimal numbers (1 Credit = ₹1)
• Identifiers: opaque strings — never parse format-meaning out of them

Authentication

Pass an API key in the x-ansdev-key header on every request. See Authentication for key format, scopes, and security best practices.

Success response

Every successful response is wrapped in the same envelope:

{
  "success": true,
  "data": { "...": "endpoint-specific payload" },
  "message": "optional human note"
}

Error response

Errors carry a stable machine-readable code plus a human message:

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The provided API key is invalid or has been revoked.",
    "status": 401
  }
}

The full code dictionary lives at Error Codes.

Services

Pagination

The current v1 endpoints return complete result sets. Pagination (cursor + limit) will be added before any endpoint can exceed ~500 items per account. Until then, no opt-in is required.

Versioning

v1 is the only supported version and is stable — additive changes only. Breaking changes will ship as /v2 with at least 6 months of parallel availability.