# USTC Campus Enrollment Status Query API (在校状态查询接口)

**Canonical:** https://apis.io/apis/ustc/campus-status/  
**Provider:** University of Science and Technology of China — https://apis.io/providers/ustc/  
**Base URL:** https://id.ustc.edu.cn/doc/api  
**Documentation:** https://id.ustc.edu.cn/doc/status-api/

USTC Campus Enrollment Status Query API (在校状态查询接口) is one of 6 APIs that [University of Science and Technology of China](https://apis.io/providers/ustc/) publishes 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 Identity, Student Records, Enrollment, and Gated. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and 1 JSON Schema.

A small, precise, institution-authored REST API that resolves a person's campus enrollment status code by global person identifier or identity number, singly or in batches of up to 100. USTC publishes it in prose with a field table, response examples, curl invocations and an enumerated error table that distinguishes a missing token (401) from a valid token off the IP allowlist (403). It requires both an administrator-issued bearer token and a registered source IP, and USTC says outright that it is not for browser users. The health check is public and returns 200. An OpenAPI 3.1 description is DERIVED here from USTC's own documentation; USTC publishes no machine-readable contract itself.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | Health check |
| GET | `/status/by-gid/{gid}` | Query enrollment status by gid |
| GET | `/status/by-zjhm/{zjhm}` | Query enrollment status by zjhm |
| POST | `/status/by-gids` | Batch query enrollment status by gid |
| POST | `/status/by-zjhms` | Batch query enrollment status by zjhm |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ustc/refs/heads/main/openapi/ustc-campus-status-api-openapi.yml
- **Documentation** — https://id.ustc.edu.cn/doc/status-api/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/ustc/refs/heads/main/json-schema/ustc-campus-status-schemas.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/ustc/refs/heads/main/examples/ustc-campus-status-examples.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/ustc/refs/heads/main/errors/ustc-campus-status-errors.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/ustc/refs/heads/main/authentication/ustc-authentication.yml

## Other University of Science and Technology of China APIs (5)

- [USTC Unified Identity Authentication (id.ustc.edu.cn, formerly Passport SSO)](https://apis.io/apis/ustc/passport/)
- [USTC Shibboleth Identity Provider (跨校资源认证中心)](https://apis.io/apis/ustc/idp/)
- [USTC Course Catalog API (catalog.ustc.edu.cn)](https://apis.io/apis/ustc/catalog/)
- [USTC Open Source Software Mirror](https://apis.io/apis/ustc/mirrors/)
- [USTC Campus GitLab](https://apis.io/apis/ustc/gitlab/)

## Tags

Identity, Student Records, Enrollment, Gated

---

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