Documentation Index
Fetch the complete documentation index at: https://developers.safarapi.com/llms.txt
Use this file to discover all available pages before exploring further.
Headline commitments
| Metric | Target | Measurement |
|---|---|---|
| Production API monthly uptime | ≥ 99.5 % | External probes, 3+ regions, 2-of-3 quorum |
| p95 read latency | < 500 ms | Rolling 24h, server-side |
| p95 write latency | < 1 000 ms | Rolling 24h, server-side |
| Webhook delivery success | ≥ 99 % within retry policy | 7-day rolling |
| Critical incident MTTA | ≤ 1 hour | Per incident |
| RTO / RPO | 4 h / 15 min (5 min for WAL tier) | Per DR event |
sk_test_* keys) is excluded from SLA — it’s there for integration testing, not production traffic.
Credits formula
If monthly production uptime falls below 99.5 %, the Partner is entitled to a credit on the next monthly invoice:| Monthly uptime | Credit |
|---|---|
| 99.5 % — 99.0 % | 5 % |
| 98.99 % — 95.00 % | 10 % |
| < 95.00 % | 25 % |
| Sustained breach | Credit |
|---|---|
| p95 read > 500 ms | 2 % |
| p95 write > 1 000 ms | 5 % |
How uptime is measured
External probes
Independent probes hit
https://api.safarapi.com/v1/health every minute from at least 3 geographic regions (Casablanca, Frankfurt, Paris).2-of-3 quorum
A minute counts as Unavailable only if at least 2 probes report failure within that minute — eliminates single-region transient noise.
Server-side latency
p95 latency is measured from the SafarAPI audit log (ingress → response dispatch), not from your probe location — gives you a fair view independent of your network distance to our edge.
Status page
Real-time dashboard and historical SLA reports on status.safarapi.com.
Incident severity and response
| Severity | Definition | MTTA |
|---|---|---|
| Critical | Production API down, data loss, security breach | 1 hour |
| High | One endpoint or feature unavailable, core flow OK | 4 hours |
| Normal | Degraded performance, non-blocking issue | 1 business day |
- Acknowledged on the status page within MTTA.
- “Identified” update with root cause hypothesis.
- Progress update every 30 minutes until “Resolved”.
- Post-mortem within 5 business days of resolution (Critical and High only).
Support channels
| Channel | Hours | Use case |
|---|---|---|
support@safarapi.com | 9h — 18h CET, Mon–Fri | Integration, general questions |
billing@safarapi.com | 9h — 18h CET, Mon–Fri | Settlement, invoicing, SLA credits |
security@safarapi.com | 24/7 ack | Security incidents, vulnerability disclosure |
| Status page | 24/7 | status.safarapi.com |
| PagerDuty rotation | 24/7 (Critical only) | Triggered by external probes |
Claiming a credit
Send a written request tobilling@safarapi.com within 30 days of month-end, with:
- the Service Month concerned;
- the measured uptime/latency figures (yours or ours);
- the calculation of the requested credit.
Exclusions
SLA credits do not apply when downtime is caused by:- Scheduled Maintenance (announced 7+ days in advance);
- Force Majeure;
- Partner-side issues (their network, their misuse, expired credentials);
- Sandbox environment;
- Beta features explicitly marked as such.
Download
SLA template (Markdown)
Source-of-truth document — versioned in Git, signable as-is.
SLA template (PDF)
Refreshed quarterly — request the latest version from
billing@safarapi.com.FAQ
Why 99.5 % and not 99.99 %?
Why 99.5 % and not 99.99 %?
We commit to numbers we will hit consistently while running a single-region active-passive architecture. Active-active multi-region is on the roadmap for Q1 2027 — when it ships, we’ll review the SLA targets upward.
Are credits capped?
Are credits capped?
Yes — at 25 % of the monthly settlement total. Beyond catastrophic outages, the cap is contractual liability scope handled in the Main Agreement, not the SLA.
What counts as a write endpoint?
What counts as a write endpoint?
POST /quotes, POST /bookings, POST /bookings/{number}/cancel, POST /webhooks, POST /webhooks/{id}/test, DELETE /webhooks/{id}. Everything else is read.Do you support 24/7 phone support?
Do you support 24/7 phone support?
Not in v1. Critical security incidents reach our on-call via PagerDuty 24/7. Normal/high-severity tickets are handled in business hours. We can negotiate a 24/7 commercial support tier separately if your contract requires it.
What if your status page is itself down?
What if your status page is itself down?
The status page (UptimeRobot-hosted) is on independent infrastructure from the API. If both are down, that’s a force-majeure-grade event — we’d reach you via email and Slack Connect directly.
Related documents
- Data Processing Agreement — privacy and data handling.
- Security Attestations — TOMs detail.
- Service status — current uptime and incidents.