# ShieldLabs Server API

**Canonical:** https://apis.io/apis/shieldlabs/shieldlabs-server-api/  
**Provider:** ShieldLabs — https://apis.io/providers/shieldlabs/  
**Base URL:** https://api.shieldlabs.ai  
**Documentation:** https://docs.shieldlabs.ai/api/overview

ShieldLabs Server API is published by [ShieldLabs](https://apis.io/providers/shieldlabs/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Fraud Detection, Abuse Prevention, Visitor Identification, Device Fingerprinting, and Bot Detection. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 1 JSON Schema.

Server-side REST API described by a public OpenAPI 3.1 specification (three operations plus one OpenAPI-3.1 webhook). Two hosts, implemented by two different internal services and diverging in casing, envelope, auth headers, billing and rate limiting: the History API on https://account.shieldlabs.ai/api (Private API Key, `Authorization: Bearer sec_…`, snake_case, `{data,total}` envelope with limit/offset, free — does not consume request balance) and the Management API on https://api.shieldlabs.ai (Secret Key plus an `X-Shield-Domain` header, PascalCase bare arrays, bills one request per returned row with a minimum of one). The primary delivery path is outbound: a signed identification.scored webhook carrying the Risk Score, the weighted signals, 18 detection flags and traffic-source attribution, delivered at most once with no retries and recovered through a free History read on request_id.

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/shieldlabs/refs/heads/main/openapi/shieldlabs-server-api-openapi.yml
- **OpenAPI** — https://docs.shieldlabs.ai/references/openapi.yaml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/shieldlabs/refs/heads/main/json-schema/shieldlabs-identification-scored.schema.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/shieldlabs/refs/heads/main/examples/shieldlabs-identification-scored-example.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/shieldlabs/refs/heads/main/overlays/shieldlabs-server-api-overlay.yaml
- **Documentation** — https://docs.shieldlabs.ai/api/overview
- **Documentation** — https://docs.shieldlabs.ai/api/server-api
- **Documentation** — https://docs.shieldlabs.ai/api/webhooks
- **APIReference** — https://docs.shieldlabs.ai/api/server-api
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/shieldlabs/refs/heads/main/data-model/shieldlabs-data-model.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/shieldlabs/refs/heads/main/mcp/shieldlabs-tool-crosswalk.yml
- **LLMsTxt** — https://shieldlabs.ai/llms.txt
- **LLMsTxt** — https://docs.shieldlabs.ai/llms.txt
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/shieldlabs/refs/heads/main/apis.yml

## Tags

Fraud Detection, Abuse Prevention, Visitor Identification, Device Fingerprinting, Bot Detection, vpn-proxy-detection, Risk Scoring, Identity, Security, Webhook

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/shieldlabs/shieldlabs-server-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/shieldlabs/.