Getting Started

Quick Start

1. Get an API Key

Sign up at gibs.dev and create an API key in your dashboard.

2. Install an SDK (optional)

pip install gibs          # Python
npm install @gibs-dev/sdk # JavaScript/TypeScript

3. Make Your First Request

from gibs import GibsClient
 
client = GibsClient(api_key="YOUR_API_KEY")
result = client.classify("AI system that screens CVs for job applications")
print(result.risk_level)  # "high"

4. Get Your Response

{
  "risk_level": "high",
  "confidence": 0.9,
  "reasoning": "This system is classified as high-risk under Annex III, Area 4(a)...",
  "sources": [
    {"article_id": "Article 6", "title": "Classification rules for high-risk AI systems", "relevance_score": 0.95},
    {"article_id": "Annex III", "title": "High-risk AI systems — Area 4: Employment", "relevance_score": 0.91}
  ],
  "request_id": "a1b2c3d4-...",
  "corpus_version": "v1.1.0",
  "processing_time_ms": 5200
}

SDKs are optional — any HTTP client works.

Base URL

https://api.gibs.dev

OpenAPI 3.1 spec: api.gibs.dev/openapi.json

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer gbs_live_abc123...

API keys start with gbs_live_ (production) or gbs_test_ (sandbox).

Rate Limits

Rate limit headers are included in every response:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1707523200

When rate limited, the API returns 429 Too Many Requests.

Error Handling

All errors follow a consistent format:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Daily request limit exceeded. Upgrade your plan at gibs.dev.",
    "status": 429
  }
}

Supported Regulations

The API auto-detects which regulation a question targets. You can also specify explicitly via the regulation parameter.

Corpus Freshness

We monitor the EU Official Journal for amendments, delegated acts, and implementing acts. Our target is to incorporate material changes within 48 hours of publication.

Every API response includes a corpus_version field so you can track which version of the legal text was used.

Note: Gibs is an information tool, not a law firm. Always verify critical compliance decisions with qualified legal counsel.