Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Centering Lab Health API
version: 1.3.0
description: 'Card centering measurement and published grading thresholds. Free public access with no API key; optional bearer authentication selects partner quotas and reserved lanes. Public REST endpoints allow cross-origin browser fetch without credentials (Access-Control-Allow-Origin: *); IP quotas still apply. Images are processed only in memory. This is a ceiling from centering alone, not a prediction of the final grade.'
servers:
- url: https://centeringlab.com
security:
- {}
- partnerBearer: []
tags:
- name: Health
paths:
/api/v1/health:
get:
operationId: get_api_health
summary: Check service health
description: Operational health check. No image or grading analysis.
responses:
'200':
description: Service is running.
headers:
RateLimit-Limit:
schema:
type: integer
description: 'Partner only: limiting quota window limit.'
RateLimit-Remaining:
schema:
type: integer
description: 'Partner only: remaining calls in that window.'
RateLimit-Reset:
schema:
type: integer
description: 'Partner only: delta seconds until that window resets.'
X-Request-Id:
schema:
type: string
maxLength: 128
description: 'Partner only: supplied visible ASCII request ID, echoed without storage.'
content:
application/json:
schema:
type: object
required:
- status
- name
- version
- disclaimer
properties:
status:
const: ok
type: string
name:
type: string
version:
type: string
disclaimer:
type: string
tags:
- Health
components:
securitySchemes:
partnerBearer:
type: http
scheme: bearer
bearerFormat: Centering Lab partner key
description: Optional. Without a partner key, existing public IP quotas apply. Partner keys (prefix clp_) that are unknown, revoked or malformed return 401 INVALID_API_KEY; other Authorization values are ignored.