HomeGetting startedRegistering with an HTTP keyGetting a credential without DiscordServer claim flowReport rules and the block windowVersion check and 426Authentication and server keysThe blocking modelError handlingRate limitsVersions and compatibilityPOST /v1/servers/claimPOST /v1/servers/reportPOST /v1/servers/revokePOST /plugin/v1/claimPOST /plugin/v1/reportGET /plugin/v1/versionGET /maps/{seed}GET /jobs/{seed}GET /seedsGET /stats/overviewGET /stats/protectionAPI changelog
Read API
GET
/api/jobs/{seed}
Reads the map-generation job status for a seed. Poll it after /api/maps/{seed} answered 202. Blocking rules are the same as maps.
Path · query
| Field | In | Type | Required | Description |
|---|---|---|---|---|
| seed | path | integer | required | 1..2147483647. |
Responses
| Status | Body | When |
|---|---|---|
| 200 | {"seed":1848055747,"status":"queued","ahead":2} | status is queued · running · ready · error. ahead appears only while queued and error only on failure. Once ready, /api/maps/{seed} answers 200. |
| 400 | {"error":"invalid seed"} | Malformed seed. |
| 403 | {"error":"blocked","blockedUntil":"2026-09-15T08:05:00Z"} | Blocked by the server owner. Reload after blockedUntil. |
Response fields
| Field | Type | null | Description |
|---|---|---|---|
| seed | integer | no | The requested seed. |
| status | string | no | One of queued, running, ready, error. A seed never requested before starts generation and answers queued. |
| ahead | integer | only when set | queued only. Seeds waiting ahead of this one. |
| error | string | only when set | error only. Why it failed. |
Example
curl https://slmaps.com/api/jobs/1848055747 -H "User-Agent: MyServer/1.0"
Response example
{
"seed": 1848055747,
"status": "queued",
"ahead": 2
}What the viewer does
The viewer treats 403 from maps and jobs the same way. A 403 without blockedUntil is a permanent block and is not retried.
SLMAPS is the seed-map viewer for SCP: Secret Laboratory. These pages describe the public API of slmaps.com.slmaps.com ·