# SJ API

**Canonical:** https://apis.io/apis/sj-se/sj-se-api/  
**Provider:** SJ — https://apis.io/providers/sj-se/  
**Base URL:** https://login.microsoftonline.com  
**Documentation:** https://developer.sj.se/apis/reseller-api/get-started

SJ API is one of 2 APIs that [SJ](https://apis.io/providers/sj-se/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

SJ API as documented publicly: 17 operations. Contract generated from the documentation by API Evangelist (2026-10-15); not the provider's own document.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/$TENANT_ID/oauth2/v2.0/token` | POST /$TENANT_ID/oauth2/v2.0/token |
| GET | `/Booking` | Quick Start Guide for SJ Reseller API |
| POST | `/Booking` | Quick Start Guide for SJ Reseller API |
| POST | `/Offers` | Quick Start Guide for SJ Reseller API |
| GET | `/availabilities` | GET /availabilities can be called in an offer or booking context to retrieve seat availability. |
| GET | `/availabilities/{availabilitieid}` | GET /availabilities/place-map returns seat‑map information for a booking and reservation. |
| GET | `/booking` | GET /booking retrieves a booking, including any provisional fulfillmentId. |
| POST | `/booking` | POST /booking creates a provisional booking with required externalRef and passenger information. |
| GET | `/bookings/{bookingid}` | GET /bookings/{bookingId} returns the booking details, including fulfillmentId. |
| POST | `/bookings/{bookingid}/fulfillment` | POST /bookings/{bookingId}/fulfillment creates a fulfillment for a booking (asynchronous, returns 202). |
| POST | `/contacts/{contactid}` | Search for an SJ customer by e-mail address. |
| POST | `/exchange-offers` | POST /exchange-offers creates an exchange offer for a booking. |
| PATCH | `/exchange-operations` | Optional, does not change any states |
| POST | `/exchange-operations` | POST /exchange-operations creates a provisional exchange operation and new provisional booking parts. |
| GET | `/fulfillments/{fulfillmentid}` | GET /fulfillments/{fulfillmentId} retrieves fulfillment details such as control number and Aztec code. |
| POST | `/offers` | Quick Start Guide for SJ Reseller API |
| PATCH | `/passenger` | PATCH /passenger updates passenger details in a provisional booking. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/sj-se/refs/heads/main/openapi/_ae-authored/sj-se-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sj-se/refs/heads/main/json-schema/sj-se-post-booking-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sj-se/refs/heads/main/json-schema/sj-se-post-offers-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sj-se/refs/heads/main/json-schema/sj-se-post-offers-request2-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sj-se/refs/heads/main/json-schema/sj-se-post-booking-request2-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sj-se/refs/heads/main/json-schema/sj-se-patch-passenger-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sj-se/refs/heads/main/json-schema/sj-se-post-contacts-contactid-response-schema.json

## Other SJ APIs (1)

- [SJ API](https://apis.io/apis/sj-se/sj-api/)

---

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