> ## Documentation Index
> Fetch the complete documentation index at: https://dev.schoolcues.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an entity

> One entity, by its sourced ID, under its kind’s key, such as `user`.



## OpenAPI

````yaml /reference/oneroster.json get /ims/oneroster/v1p1/{collection}/{sourcedId}
openapi: 3.1.0
info:
  title: SchoolCues OneRoster 1.1
  version: '1'
  description: >-
    Give roster tools the school’s classes, teachers, students and enrollments.
    Generated from @schoolcues/contracts by `pnpm docs:api`; don't edit it by
    hand.
servers:
  - url: https://portal.schoolcues.com
    description: Production
security: []
tags:
  - name: Access Tokens
  - name: Collections
paths:
  /ims/oneroster/v1p1/{collection}/{sourcedId}:
    get:
      tags:
        - Collections
      summary: Retrieve an entity
      description: One entity, by its sourced ID, under its kind’s key, such as `user`.
      operationId: retrieve_oneroster_entity
      parameters:
        - name: collection
          in: path
          required: true
          description: >-
            The collection. `schools`, `terms`, `students` and `teachers` are
            OneRoster’s views of `orgs`, `academicSessions` and `users`.
          schema:
            type: string
            enum:
              - orgs
              - schools
              - academicSessions
              - terms
              - courses
              - classes
              - users
              - students
              - teachers
              - enrollments
        - name: sourcedId
          in: path
          required: true
          description: The entity’s sourced ID.
          schema:
            type: string
        - name: fields
          in: query
          required: false
          description: Only these fields, separated by commas.
          schema:
            type: string
            maxLength: 1000
      responses:
        '200':
          description: The entity.
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: object
                  description: >-
                    A OneRoster 1.1 entity, as the OneRoster specification
                    defines it.
                  additionalProperties: true
              example:
                user:
                  sourcedId: 7d9e8f1a-2b3c-4d5e-8f6a-7b8c9d0e1f2a
                  status: active
                  dateLastModified: '2026-11-16T01:02:03.456Z'
                  username: alex.rivera@school.example
                  userIds: []
                  enabledUser: 'true'
                  givenName: Alex
                  familyName: Rivera
                  middleName: ''
                  role: student
                  identifier: '10423'
                  email: alex.rivera@school.example
                  sms: ''
                  phone: ''
                  agents: []
                  orgs:
                    - href: >-
                        /ims/oneroster/v1p1/orgs/f3b1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
                      sourcedId: f3b1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
                      type: org
                  grades:
                    - '07'
        '401':
          description: >-
            The key or token is missing, revoked or expired. Ask the school for
            a new one.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: The resource or record doesn’t exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - accessToken: []
components:
  schemas:
    Error:
      type: object
      description: Why the request was refused.
      properties:
        statusCode:
          type: integer
          description: The HTTP status.
        statusMessage:
          type: string
          description: What went wrong, in words to show.
      required:
        - statusCode
        - statusMessage
  securitySchemes:
    accessToken:
      type: http
      scheme: bearer
      description: >-
        An access token from [Create an access
        token](/reference/oneroster/access-tokens/create-an-access-token).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.