generated: '2026-10-03'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.bitcall.io/docs/authentication
sources:
- https://docs.bitcall.io/docs/authentication
- https://docs.bitcall.io/docs/gateway/conventions
- https://docs.bitcall.io/docs/quickstart
- https://docs.bitcall.io/docs/gateway/managing-api-keys
idempotency:
  coverage: none
  evidence: The documentation does not describe any idempotency key or mechanism.
pagination:
  style: page-based
  params:
  - page (default 1, one‑based)
  - pageSize (default 50, min 1, max 200)
  response_fields:
  - meta.page
  - meta.pageSize
  - meta.total
  - meta.totalPages
  - meta.hasNext
error_envelope: error object with fields code, message, requestId, and optional fields (e.g., fields on VALIDATION_ERROR).
authentication: 'Two headers on every request: x-key-id (key id) and x-api-secret (128‑hex‑character secret).'
request_tracing: Response header x-request-id contains a UUID; also echoed inside error bodies.
rate_limit_signaling: 429 responses include a Retry-After header with seconds to wait.
docs: https://docs.bitcall.io/docs/authentication