> For the complete documentation index, see [llms.txt](https://docs.stellic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stellic.com/stellic-partner-api/exports/export-student-tag-definitions.md).

# Export student tag definitions

Use this endpoint to export your institution's student tags, for example to check how tags are keyed before attaching them. Each row is one tag, not one student. The export takes no filters and always comes back in the response. It lists only the tags the account behind your token can see: restricted tags appear only if that account has been given access.

## GET /exports/student\_tags

>

```json
{"openapi":"3.0.0","info":{"title":"Stellic for Developers","version":"1.0"},"tags":[{"name":"Exports","description":"Institution-wide datasets as CSV or JSON. Small datasets come back inline; large ones run in the background and return a `file_name` you poll with `GET /get_export_url/` for a download link."}],"servers":[{"url":"https://{institution}.stellic.com/partnerapi/v1","variables":{"institution":{"default":"{institution}","description":"Your institution's Stellic subdomain: the part before `.stellic.com` in the URL you use to sign in. It becomes the host in every request, as in `https://{institution}.stellic.com/partnerapi/v1/...`. Replace the `{institution}` placeholder with your subdomain before sending."}}}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Personal Access Token issued by your Stellic integration partner. Send it as `Authorization: Bearer <token>` on every request. One token per institution; do not share across environments."}}},"paths":{"/exports/student_tags":{"get":{"tags":["Exports"],"parameters":[{"name":"output_format","in":"query","required":false,"description":"Format of the exported file. Defaults to `csv`; `json` returns the same rows as a JSON array of objects keyed by the column headers, every value as a string. If you omit it and send the header `Accept: application/json` (exactly that value), the export is produced as `json`; an explicit `output_format` always wins.","schema":{"type":"string","enum":["csv","json"],"default":"csv"}},{"name":"delivery_channel","in":"query","required":false,"description":"`http_file` returns the file in the response, `http_response` returns the same content without the attachment header, and `s3` runs the export in the background (poll `GET /get_export_url/` with the returned `data.file_name`). When omitted this dataset always comes back in the response, whatever its size.","schema":{"type":"string","enum":["http_file","http_response","s3"]}}],"responses":{"200":{"description":"One row per student tag definition visible to the account behind your token, returned inline as a CSV or JSON file attachment. With `delivery_channel=s3` the response is instead the JSON envelope with a `file_name` to poll on `GET /get_export_url/`.","content":{"application/json":{"schema":{"oneOf":[{"type":"array","items":{"type":"object"}},{"type":"object"}]}},"text/csv":{"schema":{"type":"string","format":"csv"}}}},"400":{"description":"Bad Request - unsupported `output_format` or `delivery_channel`, or the account behind the token has no role on the platform. The body is `{\"errors\": [...]}` with plain-string entries.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Unauthorized - the bearer token is missing, invalid, or not valid for this institution.","content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Your IP address isn't on the allowlist for this endpoint. Contact Stellic to add it; the response includes the `client_ip` Stellic saw.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"client_ip":{"type":"string"}}}}}}}}}}}
```

#### Columns

* `ID`: Stellic's ID for the tag.
* `Short Name`: the tag's SIS ID, the `{tag_sis_id}` on the student tag endpoints. A tag without one shows `None`.
* `Name`: the display name.
* `Types`: the tag's current types, pipe-separated (for example `audit|general`).
* `Archived`: `True` or `False`. Deleted tags aren't listed.
* `Students`: how many times the tag is attached to students, not counting test accounts. A student who has the tag both directly and through transfer credit is counted twice.
* `Student Sets`: how many student sets use the tag.

Rows are sorted by `Students`, then `Student Sets`, highest first. In JSON, every value is a string.

#### Notes

* **The token's account needs a Stellic role.** Without one, the call returns a 400 `StudentTagsFetcher requires the exporting role`.

#### Related APIs

* [`POST /tag/{tag_sis_id}`](/stellic-partner-api/student/create-a-student-tag-definition.md) to create a tag.
* [`POST /student/{student_username}/tags/{tag_sis_id}`](/stellic-partner-api/student/attach-a-tag-to-a-student.md) to attach a tag to a student.
* [`GET /exports/{property}`](/stellic-partner-api/exports/bulk-export-dispatcher.md) for formats, delivery, and errors.