API
The fastest and safest way to integrate Travelers, contracts, reservations y official communications. Clear documentation, sandbox, webhooks and stable versioning.
Integra in days, sleep peacefully
Intuitive endpoints
Clear resources: guests, documents, reservations, contracts and communications. JSON clean and consistent.
real security
API Keys with Scopes, HTTPS Required, IPS Control, Rate Limiting, Audit and Rotable Keys.
SDKs & Sandbox
Isolated testing environment, end-to-end examples and webhooks for events: high, sent lot, acknowledgment, error.
Create traveler (example fetch)
await fetch('https://api.seshospedajes.es/v1/guests', {
method:'POST',
headers:{
'Authorization':'Bearer ',
'Content-Type':'application/json',
'Idempotency-Key':'a1b2c3-unique-123'
},
body:JSON.stringify({
first_name:'Ana', last_name:'Gómez',
document:{type:'DNI', number:'12345678A'},
nationality:'ES', birth_date:'1992-03-12'
})
}) Answer 201 with guest_id and traceability. retinkable (idempotent).
Communicate lot to MIR
POST /v1/mir/batches
Authorization: Bearer
{
"type":"PV", // PV, RH, AV, RV
"xml":"", // ZIP + base64
"callback_url":"https://tuservidor.com/webhooks/mir"
} You will receive events: batch.accepted, batch.processed, batch.failed with explanatory codes.
How to integrate your project with the API
Your stack, our API. New app or progressive migration: it works just as well.
Get API Key
From your panel: Key by environment (sandbox/production), scopes and rotation.
Connect endpoints
Guests, Documents, Reservations, Contracts and Mir Batches with consistent JSON.
Manage events
Configure webhooks for registrations, acknowledgments, statuses, and fixable errors.
goes to production
Stable versioning, clear limits and technical support for Go-Live.
Compatibility
- Rest json. SDKs for JS/Node, PHP and Python.
- Idempotence in post/put, retry-after and pagination completed.
- Internationalization: ES/EN in standardized panel and payloads.
Security
- HTTPS Required (TLS 1.2+), API Keys with Scopes and Expiration.
- Rate Limits per client, IP blocking, and full audit.
- data in the EU; Logs and PII managed according to GDPR.
PMS / Channel Manager
Sync guests and reservations, generate parts and automatically communicate to the MIR.
Check-in website
It integrates our multi-language pre-check-in and receives the data clean and validated.
RENT A CAR
Upload contracts, associate drivers and shoot the MIR lot from your ERP.
Frequently asked questions
Where is the documentation?
in our Developer Center You have guides, references and examples.
Is there a test environment?
Yes. Isolated sandbox with fictitious data, own keys and test webhooks.
How is it versioned?
Stable major version (v1). Incompatible changes are announced with time and routes /v2.
Build on an API that takes care of you
Integrate fast, operate secure and automate your official communications.
